Trade Status & History
Retrieve details of executed trades and monitor historical activity.
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
URL Path Parameter
| 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.
Example Request
Get trade by ID or reference
Example Response
Response Body
List Trades (Paginated)
Query Parameters
| 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 |
Example Request
List trades with filters
Example Response
Response Body (Paginated)
Use Cases
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
