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 a P&L summary for the account including total asset, total P&L, and yield metrics.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
start_date | string | Optional | Analysis start date in `YYYY-MM-DD` format |
end_date | string | Optional | Analysis end date in `YYYY-MM-DD` format |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
updated_at | string | Optional | Last update timestamp |
sum_profit | string | Optional | Total profit/loss |
sum_profit_rate | string | Optional | Total profit/loss rate |
profits | object | Optional | Profit breakdown by category |
└ stock | string | Optional | Basic stock information |
└ fund | string | Optional | Fund flag/amount. |
└ mmf | string | Optional | Maintenance-margin factor. |
└ other | string | Optional | Other value/count. |
└ summary_info | object[] | Optional | Summary information. |
└ ∟ profit_max | string | Optional | Maximum profit amount. |
└ ∟ loss_max | string | Optional | Maximum loss amount. |
└ ∟ profit_max_name | string | Optional | Name of the max-profit security. |
└ ∟ loss_max_name | string | Optional | Name of the max-loss security. |
└ ∟ asset_type | string | Optional | Element type of this group (holdings / regional / asset class / industry) |
└ ipo_subscription | integer | Optional | IPO subscription count. |
└ ipo_hit | integer | Optional | IPO allotment (hit) count. |
└ cumulative_transaction_amount | string | Optional | Cumulative transaction amount. |
└ crypto | string | Optional | Crypto flag. |
└ trade_order_num | string | Optional | Number of trade orders. |
└ trade_stock_num | string | Optional | Number of traded stocks. |
is_traded | boolean | Optional | Whether any trades exist |
currency | string | Optional | Currency |
total_simple_earning_yield | string | Optional | Total simple earning yield. |
total_time_earning_yield | string | Optional | Total time-weighted earning yield. |
invest_amount | string | Optional | Total invested amount |
initial_asset_value | string | Optional | Initial asset value |
ending_asset_value | string | Optional | Ending asset value |
current_total_asset | string | Optional | Current total asset value |
start_time | string | Optional | Period start timestamp |
end_time | string | Optional | Period end timestamp |
trade_update_time | string | Optional | Trade data update time. |
updated_date | string | Optional | Last update date |
start_date | string | Optional | Period start date |
end_date | string | Optional | Period end date |
trade_update_date | string | Optional | Trade data update date. |
trade_stock_num | string | Optional | Number of traded stocks. |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"summary": {
"currency": "USD",
"sum_profit": "62905.97",
"sum_profit_rate": "0.6128",
"invest_amount": "102659.74",
"current_total_asset": "165565.71",
"initial_asset_value": "0.00",
"ending_asset_value": "165565.71",
"is_traded": true,
"start_date": "2025-10-17",
"start_time": "1760659200",
"end_date": "2026-05-14",
"end_time": "1778731947",
"profits": {
"stock": "66370.84",
"crypto": "0",
"fund": null,
"ipo": null,
"mmf": null,
"other": null,
"cumulative_transaction_amount": "1244920.28"
}
},
"sublist": {
"start": "2025-10-17",
"start_date": "2025-10-17",
"end": "2026-05-14",
"end_date": "2026-05-14",
"updated_at": "1778731947",
"updated_date": "2026-05-14",
"items": [
{
"symbol": "AAPL.US",
"name": "Apple",
"market": "US",
"currency": "USD",
"profit": "100.00",
"profit_rate": "0.05",
"holding_period": "180",
"clearance_times": 0,
"is_holding": true,
"item_type": "Stock",
"isin": "",
"security_code": "AAPL",
"underlying_profit": "100.00",
"derivatives_profit": "0.00",
"order_profit": null
}
]
}
}
}Error code
See the Error Codes page for the full list of error codes.