Skip to main content
GET
Market trade history (onchain)
Returns every onchain trade fill for a specific market token, enriched with market metadata.
Want the entire market in one call? Use Trade History (Market) — Bulk (Growth plan and above). Returns up to 250K trades in a single response, no pagination.

Quick start — get the most recent 100 trades

Default limit=100, max limit=1000. That’s all most apps need.

Get every trade in the market (full history)

To walk the entire history, add ?cursor= (empty value) to the first request, then for each next page, copy pagination.cursor from the response back into the URL. Stop when pagination.has_more is false. Three complete copy-paste scripts that walk an entire market:
Real run (heavy market, walked live with the Python script above):
Each page takes ~1 second regardless of how deep you go — the loop just keeps running until has_more is false.

Request

Response

Path Parameters

token_id
string
required

CTF token ID

Query Parameters

limit
integer
default:100

Max results (max 1000)

offset
integer
default:0

Skip first N results

cursor
string

Cursor pagination. Pass empty string ?cursor= for the first page, then echo back pagination.cursor from each response. Format: <lastTs>:<lastId>. Each page loads at the same speed regardless of depth — recommended over offset for paging beyond ~25K results.

Response

Trade fills