Account
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
Get detailed P&L for a specific security including transaction flow and cost breakdown.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `AAPL.US` |
start | string | Optional | Start date, `YYYY-MM-DD` |
end | string | Optional | End date, `YYYY-MM-DD` |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
profit | string | Optional | Total profit/loss |
underlying_details | object | Optional | Underlying asset P&L breakdown |
└ holding_value | string | Optional | Current holding value |
└ profit | string | Optional | Total profit/loss |
└ cumulative_credited_amount | string | Optional | Cumulative credited amount |
└ credited_details | array | Optional | Credit transaction details |
└ cumulative_debited_amount | string | Optional | Cumulative debited amount |
└ debited_details | array | Optional | Debit transaction details |
└ cumulative_fee_amount | string | Optional | Cumulative fee amount |
└ fee_details | array | Optional | Fee transaction details |
└ short_holding_value | string | Optional | Short position value |
└ long_holding_value | string | Optional | Long position value |
└ holding_value_at_beginning | string | Optional | Holding value at period start |
└ holding_value_at_ending | string | Optional | Holding value at period end |
derivative_pnl_details | object | Optional | Derivatives P&L breakdown |
└ holding_value | string | Optional | Current holding value |
└ profit | string | Optional | Total profit/loss |
└ cumulative_credited_amount | string | Optional | Cumulative credited amount |
└ credited_details | array | Optional | Credit transaction details |
└ cumulative_debited_amount | string | Optional | Cumulative debited amount |
└ debited_details | array | Optional | Debit transaction details |
└ cumulative_fee_amount | string | Optional | Cumulative fee amount |
└ fee_details | array | Optional | Fee transaction details |
└ short_holding_value | string | Optional | Short position value |
└ long_holding_value | string | Optional | Long position value |
└ holding_value_at_beginning | string | Optional | Holding value at period start |
└ holding_value_at_ending | string | Optional | Holding value at period end |
name | string | Optional | Security name. |
updated_at | string | Optional | Last update timestamp |
default_tag | integer | Optional | Default display tag |
currency | string | Optional | Currency |
start | string | Optional | Period start |
end | string | Optional | Period end |
start_date | string | Optional | Start date |
end_date | string | Optional | End date |
updated_date | string | Optional | Last update date |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"name": "Apple",
"currency": "USD",
"profit": "100.00",
"start": "1763769600",
"end": "1778724973",
"start_date": "2025-11-22",
"end_date": "2026-05-14",
"default_tag": 0,
"updated_at": "1778724973",
"updated_date": "2026-05-14",
"underlying_details": {
"profit": "100.00",
"holding_value": "1790.16",
"holding_value_at_beginning": null,
"holding_value_at_ending": "1790.16",
"long_holding_value": "1790.16",
"short_holding_value": "0.00",
"cumulative_credited_amount": "0.00",
"cumulative_debited_amount": "0.00",
"cumulative_fee_amount": "0.00",
"credited_details": [],
"debited_details": [],
"fee_details": []
},
"derivative_pnl_details": {
"profit": "0.00",
"holding_value": "0.00",
"holding_value_at_beginning": null,
"holding_value_at_ending": "0.00",
"long_holding_value": "0.00",
"short_holding_value": "0.00",
"cumulative_credited_amount": "0.00",
"cumulative_debited_amount": "0.00",
"cumulative_fee_amount": "0.00",
"credited_details": [],
"debited_details": [],
"fee_details": []
}
}
}Error code
See the Error Codes page for the full list of error codes.