Skip to main content
Five operations return lists rather than a single situation: series, financials, events, holders, and rank. This is where depth lives: price history, statements exactly as filed, the insider tape, and a screener an agent can drive. Unlike the domain operations, they do not accept ids. Each takes one asset (or, for rank, no asset) and a set of shape parameters. Billing is one credit per successful materialization for series, financials, events, and holders. rank bills one credit per returned row.

​
series

Historical bars, or a summary, for one asset on either plane.
​
id
string
required
One canonical asset ID.
​
view
enum
default:"bars"
bars or summary.
​
range
enum
default:"1y"
1w, 1mo, 3mo, 6mo, ytd, 1y, 5y, or max.
​
interval
enum
default:"plane default"
15m, 1h, 4h, 1d, 1w, or 1mo.
​
limit
integer
default:"120"
1 to 500. Requires view=bars.
​
cursor
string
Pagination cursor. Requires view=bars.

​
financials

Filed statement line items over several periods, for one equity. Values are exact decimal strings as filed, delivered with explicit units, not rounded floats. What the company told the SEC is what your agent reads.
​
id
string
required
One equity asset ID.
​
statements
enum list
default:"income, balance, cash_flow"
Any of income, balance, cash_flow. 1 to 3, distinct.
​
period_kind
enum
default:"annual"
annual, quarter, or ytd.
​
periods
integer
default:"4"
1 to 20.
​
basis_concepts
boolean
default:"false"
Include basis concepts.

​
events

Corporate events for one equity: the filing stream, the insider tape, dividends, and splits.
​
id
string
required
One equity asset ID.
​
types
enum list
default:"filings, insider, dividends, splits"
Any of filings, insider, dividends, splits. 1 to 4, distinct.
​
since
date
Only events on or after this date.
​
form
string
Filing form filter. Requires types to include filings.
​
limit
integer
default:"50"
1 to 200.
​
cursor
string
Pagination cursor.

​
holders

Institutional holders for one equity, from 13F reporting.
​
id
string
required
One equity asset ID.
​
limit
integer
default:"25"
1 to 100.
​
cursor
string
Pagination cursor.

​
rank

Assets ordered by a chosen metric across the crypto core tier. This is the screener as an operation: “who is most stretched right now” is one call.
​
metric
enum
default:"extreme_count"
extreme_count, funding_rate_8h_pct, return_24h_pct, return_7d_pct, oi_change_24h_pct, net_taker_delta_24h_usd, net_taker_delta_pct_of_oi_24h, liq_intensity_pct_of_oi_24h, or liq_imbalance_24h.
​
direction
enum
default:"top"
top or bottom.
​
tier
enum
default:"core"
core.
​
limit
integer
default:"10"
1 to 50.
​
cursor
string
Pagination cursor.
rank bills one credit per returned row. The default limit is 10, so a default call costs up to 10 credits, and the maximum limit of 50 costs up to 50 credits. Set limit to what you need.