API ReferenceTrading

List trades

View as MarkdownOpen in Claude

A user’s most recent trades, newest first, capped by the service’s page size (10 by default). Both sides are in the same list — filter with side, and narrow to a single state with status. Both filters are checked against the documented values; anything else is a 400.

Only the user’s own trades are ever returned.

Authentication

AuthorizationBearer

A 15-minute token from /auth. Required on every endpoint except /auth.

Headers

X-Request-IdstringOptional

Correlation id. Generated if omitted, echoed on every response, and written to the audit log. /send is the exception — there it is required, and it doubles as the idempotency key.

X-USER-IDstringOptionalformat: "^[0-9a-fA-F]{24}$"

Optional. When present it overrides any userId in the body.

Request

This endpoint expects an object.
userIdstringRequiredformat: "^[0-9a-fA-F]{24}$"

24-character hex id, returned by /create.

sideenumOptional
Optional. Return only this side.
Allowed values:
statusenumOptional

Where the trade is in its lifecycle.

open is the only status you can approve or cancel. executing is in flight — poll, never approve again. completed, failed, expired and cancelled are terminal.

Response

OK — newest first. An empty array when the user has never traded.

resultlist of objects
requestIdstring

Echo of the inbound X-Request-Id, or a generated one.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error