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

Full reference: Get Order By ID.

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

Full reference: Get Orders. The list returns crypto-pair orders; NGN trades are not included, so fetch those one at a time with Get Order By ID.

Endpoint

parameter	type	required	description
status	string	No	Filter by order status (pending, filled, rejected, cancelled)
limit	integer	No	Number of orders per page

The response carries total_count, has_more and next_cursor alongside the orders array.

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 via Get Order By ID

Generating usage-based analytics or reporting