Trade
Position List
HTTP Request
GET /v1/trade/position-list
NOTE
Don't include trailing slash
/ at the end of the endpoint. Doing so can result in a “not found” error.Request Parameters
| Parameter | Required | Type | Comments |
|---|---|---|---|
| page | optional | integer | page number of the position |
| limit | optional | integer | limit of count of the getting position |
INFO
The ack of position list request indicates that the request is successfully accepted.
Response Parameters
| Parameter | Type | Comments |
|---|---|---|
| statusCode | number | 200 |
| result | object | Result object containing list and pagination |
| result.list | array | Array of position objects |
| result.list[].id | number | Position ID |
| result.list[].coin | string | Trading pair symbol |
| result.list[].side | string | Position side: long, short |
| result.list[].size | string | Size of the position |
| result.list[].averageEnteryPrice | string | Average entry price of the position |
| result.list[].leverage | string | Leverage of the position |
| result.list[].margin | string | Margin of the position |
| result.list[].unrealizedPnl | string | Unrealized PnL of the position |
| result.list[].liquidationPrice | string | Estimated liquidation price of the position |
| result.list[].marginMode | string | Margin mode: Cross, Isolated |
| result.list[].createdTime | number | Creation timestamp of the position (Unix time in ms) |
| result.list[].tradeType | string | Trade type: market, limit |
| result.list[].tpPrice | string | null | Take profit price of the position |
| result.list[].slPrice | string | null | Stop loss price of the position |
| result.pagination | object | Pagination information |
| result.pagination.page | number | Current page number |
| result.pagination.limit | number | Items per page |
| result.pagination.totalRecords | number | Total number of records |
| result.pagination.totalPages | number | Total number of pages |
| message | string | Response message |