Trade Status & History

The Trade Status & History endpoints allow you to:

Fetch a single trade by ID or reference

List all trades across your account (optionally filtered)

Monitor conversion volumes, timestamps, and trade outcomes

Power your ledger, dashboards, and audit flows

Retrieve a Specific Trade

Endpoint

parameter	type	required	description
id	string	Yes	Trade ID or reference ID

You can use either a Bitnob-generated tradeId or your own reference to fetch the trade.

Get trade by ID or reference

Response Body

Endpoint

parameter	type	required	description
from	string	No	Filter by source asset (usdt or bitcoin)
to	string	No	Filter by target asset (usdt or bitcoin)
status	string	No	Filter by status (completed, failed)
startDate	string	No	ISO8601 format — return trades after this date
endDate	string	No	ISO8601 format — return trades before this date
limit	integer	No	Number of trades per page (default 20, max 100)
cursor	string	No	Cursor for pagination

Get List trades with filters

Response Body (Paginated)

Powering ledger UIs or admin dashboards with completed trade data

Matching internal accounting and reconciliation jobs

Investigating failed trades by reference ID

Generating usage-based analytics or reporting