Docs/Token data/Bulk export (CSV / JSON)

Bulk export (CSV / JSON)

GET/v1/token/{mint}/export🔑 API key required

Pull a large historical range — trades or OHLCV — as one CSV or JSON artifact, instead of hand-paging /trades or /ohlcv.

The export walks the same store the live routes read, paginating internally so a wide range comes back in one call. Bounded by your plan's history window (a from below the floor is lifted to it) and capped at a fixed row ceiling (truncated: true when the cap is hit). CSV cells are formula-injection-neutralized (a leading =,+,-,@ is prefixed with ') so opening the file in Excel/Sheets is safe.

Path parameters

FieldTypeDescription
mintrequiredstringToken mint address (base58).

Query parameters

FieldTypeDescription
kindoptionalohlcv | tradesWhat to export. default trades
formatoptionalcsv | jsoncsv downloads an attachment (text/csv); json returns { items[] }. default json
intervaloptionalstringCandle interval (kind=ohlcv only): 1s…1d (sub-minute is plan-gated). default 1m
fromoptionalnumber (unix sec)Range start. Lifted to your plan's history floor.
tooptionalnumber (unix sec)Range end (default now).
limitoptionalnumberMax rows (capped at the export ceiling).
networkoptionalmainnet | devnetNetwork to read. Devnet returns an empty payload (with a note) until its ingestor lands. default mainnet

Response fields

FieldTypeDescription
kindstringtrades or ohlcv (echoes the request).
countnumberRows returned.
truncatedbooleantrue = the row cap was hit; narrow the from/to to get the rest.
windowClampedbooleanPresent (true) when from was lifted to your plan's history floor.
granularityClampedbooleanPresent (true) when a sub-minute interval was coarsened to 1m for your plan (ohlcv only).
items[]arraytrades: the same trade shape as /trades; ohlcv: the same candle shape as /ohlcv.
CSV columns are stable and ordered; the header row names them. Strings starting with =,+,-,@ are prefixed with a single quote (OWASP formula-injection neutralization) — the same guard the wallet PnL CSV uses.
The export honors your plan's history window exactly like /ohlcv and /trades — it is not a deep-history bypass.