Skip to main content
API referenceChain

Export Chain Events

Last updated

GET
/api/v1/export/chain-events

Fetch up to 25,000 chain events in one call -- the same rows, filters and ordering as /api/v1/chain-events, without the 100-row page ceiling or the cursor bookkeeping that comes with it. ?pallet / ?method narrow by event id; ?before reads down from a block number, which is how a caller walks a large range in deliberate chunks; ?limit caps the call (<=25000, default 5000). REQUIRES PAYMENT: this route answers 402 with an x402 quote when no payment is presented, on Base or Solana -- see /.well-known/x402. It is the one family that does; every other route on this API serves an unpaid caller normally. Served live, no static file.

Query Parameters

pallet?string

Filter to events emitted by this pallet, e.g. SubtensorModule or Balances.

Lengthlength <= 64
method?string

Filter to events with this method name within the pallet, e.g. StakeAdded.

Lengthlength <= 64
before?integer

Inclusive first block height of the range to read. Omit for an unbounded end. Must not be later than the range's upper bound.

Range0 <= value
limit?integer

Maximum number of rows to return in one page (at most 25000). A larger value, or a non-positive one, is rejected with 400 invalid_query -- so a short page means the result set is exhausted, not that the server quietly capped you (#9916). Omitted, the server applies 5000.

Range1 <= value <= 25000
Default5000

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/export/chain-events"
{  "data": {    "count": 1,    "events": [      {        "block_number": 5000000,        "event_index": 1,        "method": "GET",        "pallet": "example"      }    ],    "next_before": 1,    "next_cursor": "100.123.4"  },  "meta": {    "artifact_path": "example",    "cache": "short",    "contract_version": "2026-06-29.1",    "generated_at": "2026-06-01T00:00:00.000Z",    "observed_through": "2026-06-01T00:00:00.000Z",    "pagination": {      "collection": "example",      "cursor": 1,      "limit": 1,      "next_cursor": 1,      "order": "asc",      "returned": 1,      "sort": "example",      "total": 1    },    "published_at": "2026-06-01T00:00:00.000Z",    "source": "live-cron-prober",    "stale_contract": {      "built_under": "example",      "live": "example"    }  },  "ok": true,  "schema_version": 1}