Skip to main content
Spot collections are available on Mainnet and Testnet. Perpetual, Lending, Margin Trading, and Vault collections are Testnet-Only.
Paged endpoints return the same array or object on every page. Read the continuation from response headers:
Pass the token unchanged as cursor, keeping all filters unchanged. A malformed token or a token for another filter set returns 400 BAD_REQUEST. limit may change between pages. Stop when X-Next-Cursor is absent, not when a page is shorter than limit. Browser clients can read these headers through CORS. Oversized page limits are capped. Orderbook depth is a separate parameter and rejects values over 20. Bounded reference lists, including markets, currencies and tickers, are not paged.

Example: walk a Perp fill history (Testnet-Only)

Set API_URL to https://test-dex-api.cloud.aultblockchain.xyz and OWNER to a valid wallet address. This read-only example uses Python’s standard library and retains decimal strings.

Time windows and changing state

Perp feeds use inclusive from and to in Unix milliseconds. Spot feeds use since. Candles return ascending bars: without since (Spot) or from (Perp), start at the newest page and page backward; with the lower bound, start there and page forward. Keep the lower bound unchanged when passing the cursor. A cursor marks a position in the list, not a frozen copy of the data. Orders and vaults can change between requests, so re-read the newest page after you finish paging. Spot trades, user fills, Lending liquidations and Margin feeds also accept legacy before_height plus before_index. Supply both together. Prefer the opaque cursor. Spot trade cursor requests can return 503 while ordering checks are pending or historical event keys need repair.