TRADE BOOK
This API returns the complete trade data from the completed orders tab.
It includes execution-level details such as trade price, trade number, and timestamps.
🔍 Query Parameters
| Parameter | Type | Required | Description | Example / Enum |
|---|
| client_id | string | No | Client ID to fetch trades for a user | "VISHAL1" |
| offset | integer | No | Page number for pagination | 1 |
| limit | integer | No | Number of records per page | 100 |
| order_id | string | No | Filter trades by single order ID (URL encoded) | "NWSDJ00004B4" |
| order_ids | string | No | Comma-separated order IDs for bulk filtering | "NWSDJ00004B4,NWSDJ00003B4" |
| Header | Type | Description | Example |
|---|
| Content-Type | string | Request payload format | application/json |
| Authorization | string | Access token | {{access_token}} |
| x-api-key | string | API key | {{x-api-key}} |
🟢 Success Response - 200 OK
Content-Type: application/json
| Field | Type | Description | Example |
|---|
| status | string | Status of API call | "success" |
| code | string | Response code | "s-101" |
| message | string | Success message | "Trade book fetched successfully" |
| data | array | List of trades | Refer Data Object Fields |
| metadata | object | Summary information | Refer Metadata Fields |
📦 Data Object Fields
| Field | Type | Description | Example / Enum |
|---|
| order_id | string | Order ID | "NWSDJ00004B4" |
| exchange | string | Exchange segment | "NSE_EQ" |
| scrip_token | integer | Scrip token | 12345 |
| trade_no | string | Exchange trade number | "TRD123456" |
| exchange_order_no | string | Exchange order ID | "EX987654" |
| transaction_type | string | Buy/Sell | "BUY", "SELL" |
| product_type | string | Product type | "MIS", "CNC" |
| order_type | string | Order type | "MARKET", "LIMIT" |
| traded_quantity | integer | Quantity executed | 10 |
| trade_price | string | Trade price | "2500.50" |
| symbol | string | Scrip symbol | "RELIANCE" |
| series | string | Series | "EQ" |
| instrument | number | Instrument type | 1 |
| expiry_date | string | Expiry date | "2026-06-25" |
| strike_price | string | Strike price | "2500" |
| option_type | string | Option type | "CE", "PE" |
| trade_timestamp | string | Trade execution time | "2026-05-27 10:15:00" |
| initiated_by | string | Source of order placement | "WEB", "MOBILE", "DEALER" |
| modified_by | string | Source of modification | "WEB" |
| order_identifier | string | Custom identifier | "ORD001" |
| Field | Type | Description | Example |
|---|
| total_records | number | Total trade records | 50 |