API Reference

Query History Position

Query portfolio historical positions, only includes fully closed positions.

⏳ Limit

15 requests per 10 seconds.


🛠️ Parameters

FieldTypeMandatoryDescription
symbolStringNThe trading pair or asset symbol.
beginStringNThe start time for data queries, default is to query data that is up to 90 days ago (in milliseconds).
endStringNThe end time for data queries, specified in milliseconds timestamp format.

📬 Response

FieldTypeDescription
positionIdStringPosition ID
accountIdStringAccount ID
symbolStringThe trading pair or asset symbol.
closedTypeStringPARTIAL_CLOSED , COMPLETE_CLOSED ,LIQUIDATION
closedPnlStringClosed Pnl
closedPnlRatioStringClosed Pnl ratio
closedAvgPriceStringClosed average price
maxPositionQtyStringMax position quantity
closedQtyStringClosed quantity
liqFeeStringLiquidation fee
fundingFeeStringFunding fee
feeStringThe trading fee incurred for the executed trades.
openAvgPriceStringOpen average price
leverageStringLeverage
positionHistorySideStringOne-way mode:NONE
Hedged mode position side:LONG,SHORT
createTimeStringThe timestamp when this portfolio record was created (in milliseconds).
updateTimeStringThe timestamp when this portfolio record was last updated (in milliseconds).
Language