Skip to main content
GET
Get trade history
Pagination uses a compound keyset cursor. For the next (older) page, pass both nextBeforeTs back as beforeTs and nextBeforeId back as beforeId. Both cursors are null when the history is exhausted.

Authorizations

x-api-key
string
header
required

API key authentication. Provide your API key as the header value.

Query Parameters

tokenAddress
string
required

Token address. Accepts any casing; normalized to EIP-55 checksum form.

limit
number
default:50

Number of trades to return per page.

Required range: 1 <= x <= 200
beforeTs
number

Cursor timestamp (unix seconds) from a previous page's nextBeforeTs. Sending only beforeTs without beforeId starts from strictly-older timestamps.

beforeId
string

Cursor trade ID from a previous page's nextBeforeId. Must accompany beforeTs.

Response

Successfully retrieved trades

success
boolean
required
Example:

true

response
object