Skip to main content
GET
Node.js

Authorizations

Authorization
string
header
required

ES256-signed JWT bearer token, single-use, 60-second TTL. See Authentication for how to mint one.

X-Request-Signature
string
header
required

ES256 signature over the request, bound to the bearer JWT. Required on every v3 request. See Authentication → Request signing.

Headers

X-Request-Id
string

Optional, client-supplied correlation ID for this request. Echoed verbatim on the response when supplied; the response omits it when the request did not supply one. Distinct from X-Trace-Id (server-generated, always present). See Metadata & tracing.

Example:

"my-req-abc-123"

Query Parameters

limit
integer
default:25

Max records to return. Range 1–100. Default 25.

Required range: 1 <= x <= 100
Example:

50

startingAfter
string

An opaque cursor string from a previous response's pagination.nextCursor. Fetches the page of records older than the cursor's position (lists are sorted newest-first). Cursors are opaque — pass them back verbatim, do not decode or modify them. Mutually exclusive with endingBefore.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA3VDEzOjAyOjI5LjE0N1oiLCJpZCI6IjZhOGRmZjAzLWFiY2QtNDEyMy1iYWNkLTAxMjM0NTY3ODlhYiJ9"

endingBefore
string

An opaque cursor string from a previous response's pagination.prevCursor. Fetches the page of records newer than the cursor's position. Cursors are opaque — pass them back verbatim, do not decode or modify them. Mutually exclusive with startingAfter.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDA5OjE1OjAwLjAwMFoiLCJpZCI6ImExMmJjMzQ1LWQ2ZTctNDg5MC1iY2RlLWZlZGNiYTk4NzY1NCJ9"

Response

Paginated list of trades.

A paginated collection of trade resources.

data
object[]
required

Trade resources returned in this page.

pagination
object
required

Pagination envelope for unbounded list responses. hasNext / hasPrev are the explicit "is there another page in this direction" booleans; nextCursor / prevCursor are the opaque cursors you pass back verbatim via the startingAfter / endingBefore query parameters. When hasNext is false the nextCursor is null (you are on the last page); likewise hasPrev / prevCursor on the first page.