Authentication
None. The API is public and does not require an API key. CORS allowsGET, POST, and OPTIONS from any origin.
Response format
Successful responses are the JSON object itself, with no{code, message, data} envelope. Errors use the HTTP status code with a JSON body:
Pagination
DEX pages use thepage query parameter. Page size is fixed at 20 and is not configurable. Save snapshotHeight from the first response and send it on later pages so new blocks do not shift the window:
before for block height, cursor as height:index for Actions.
Identifiers
DEXhash and stable explorerId are the same canonical Action ID:
legacyHash may repeat or be null (legacyHashStatus=unsupported); ambiguous legacy hashes return 409 — always prefer explorerId.
Addresses are 20-byte 0x-prefixed hex strings. Times are Unix milliseconds. DEX date filters are UTC+8 calendar days in YYYY-MM-DD.
Inclusion vs execution
status=includedmeans the Action is in a finalized block, not that it succeeded.executionStatusissucceeded,failed,partially_succeeded, orunknown.- Missing archive responses stay
unknownwithexecutionResponse=null. - DEX compact Actions do not include execution fields — read
GET /api/v1/transactions/{explorerId}forexecutionStatusandexecutionResponse.