Historical Position Detail

Query closed historical position details by position ID.

API Information

• Method: GET
• Path: /fapi/v1/position/history/detail
• Authentication: Requires signature authentication (see Common Module · Signature Specification)

Request Parameters

Parameter	Location	Type	Required	Description
position_id	query	integer	Yes	Position ID

Request Example

GET /fapi/v1/position/history/detail?position_id=123

Response Fields

Field	Type	Description
code	integer	Status code
message	string	Response message
data.id	integer	Primary key ID
data.position_id	integer	Related position ID
data.user_id	integer	User ID
data.symbol	string	Trading pair
data.position_side	integer	Position side: 1=long, 2=short
data.margin_mode	integer	Margin mode: 1=isolated, 2=cross
data.leverage	integer	Leverage
data.open_quantity	number	Total opening quantity
data.close_quantity	number	Total closing quantity
data.entry_price	number	Average entry price
data.exit_price	number	Average exit price
data.open_amount	number	Total opening amount
data.close_amount	number	Total closing amount
data.open_fee	number	Total opening fee
data.close_fee	number	Total closing fee
data.total_funding_fee	number	Total funding fee
data.realized_pnl	number	Realized PnL
data.close_type	integer	Close type: 1=user close, 2=take profit, 3=stop loss, 4=liquidation, 5=ADL
data.opened_at	integer	Open time (milliseconds)
data.closed_at	integer	Close time (milliseconds)
data.created_at	integer	Creation time (milliseconds)

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "id": 1,
    "position_id": 123,
    "user_id": 100001,
    "symbol": "BTC_USDT",
    "position_side": 1,
    "margin_mode": 1,
    "leverage": 10,
    "open_quantity": 0.1,
    "close_quantity": 0.1,
    "entry_price": 68500,
    "exit_price": 68700,
    "open_amount": 6850,
    "close_amount": 6870,
    "open_fee": 3.425,
    "close_fee": 3.435,
    "total_funding_fee": -0.5,
    "realized_pnl": 20,
    "close_type": 1,
    "opened_at": 1711929600000,
    "closed_at": 1711929700000,
    "created_at": 1711929700000
  }
}