> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noxint.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List operations

> History, filed statements, corporate events, holders, and cross-asset ranking

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.

<ParamField query="id" type="string" required>
  One canonical asset ID.
</ParamField>

<ParamField query="view" type="enum" default="bars">
  `bars` or `summary`.
</ParamField>

<ParamField query="range" type="enum" default="1y">
  `1w`, `1mo`, `3mo`, `6mo`, `ytd`, `1y`, `5y`, or `max`.
</ParamField>

<ParamField query="interval" type="enum" default="plane default">
  `15m`, `1h`, `4h`, `1d`, `1w`, or `1mo`.
</ParamField>

<ParamField query="limit" type="integer" default="120">
  1 to 500. Requires `view=bars`.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor. Requires `view=bars`.
</ParamField>

```bash theme={null}
curl -H 'Authorization: Bearer nx_your_key' \
  'https://noxint.ai/api/v1/series?id=crypto:bitcoin&range=3mo&interval=1d'
```

## 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.

<ParamField query="id" type="string" required>
  One equity asset ID.
</ParamField>

<ParamField query="statements" type="enum list" default="income, balance, cash_flow">
  Any of `income`, `balance`, `cash_flow`. 1 to 3, distinct.
</ParamField>

<ParamField query="period_kind" type="enum" default="annual">
  `annual`, `quarter`, or `ytd`.
</ParamField>

<ParamField query="periods" type="integer" default="4">
  1 to 20.
</ParamField>

<ParamField query="basis_concepts" type="boolean" default="false">
  Include basis concepts.
</ParamField>

```bash theme={null}
curl -H 'Authorization: Bearer nx_your_key' \
  'https://noxint.ai/api/v1/financials?id=eq:0000320193:aapl&statements=income&periods=4'
```

## events

Corporate events for one equity: the filing stream, the insider tape,
dividends, and splits.

<ParamField query="id" type="string" required>
  One equity asset ID.
</ParamField>

<ParamField query="types" type="enum list" default="filings, insider, dividends, splits">
  Any of `filings`, `insider`, `dividends`, `splits`. 1 to 4, distinct.
</ParamField>

<ParamField query="since" type="date">
  Only events on or after this date.
</ParamField>

<ParamField query="form" type="string">
  Filing form filter. Requires `types` to include `filings`.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  1 to 200.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor.
</ParamField>

```bash theme={null}
curl -H 'Authorization: Bearer nx_your_key' \
  'https://noxint.ai/api/v1/events?id=eq:0000320193:aapl&types=filings&form=10-Q'
```

## holders

Institutional holders for one equity, from 13F reporting.

<ParamField query="id" type="string" required>
  One equity asset ID.
</ParamField>

<ParamField query="limit" type="integer" default="25">
  1 to 100.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor.
</ParamField>

```bash theme={null}
curl -H 'Authorization: Bearer nx_your_key' \
  'https://noxint.ai/api/v1/holders?id=eq:0000320193:aapl&limit=25'
```

## 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.

<ParamField query="metric" type="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`.
</ParamField>

<ParamField query="direction" type="enum" default="top">
  `top` or `bottom`.
</ParamField>

<ParamField query="tier" type="enum" default="core">
  `core`.
</ParamField>

<ParamField query="limit" type="integer" default="10">
  1 to 50.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor.
</ParamField>

```bash theme={null}
curl -H 'Authorization: Bearer nx_your_key' \
  'https://noxint.ai/api/v1/rank?metric=funding_rate_8h_pct&direction=top&limit=5'
```

<Warning>
  `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.
</Warning>