Get trade history

This endpoint allows users to get trade history

GET /api/v1/trades/history

Query Parameters

Field	Type	Need	Description	Example
"account"	string	required	User's wallet address	42trU9A5...
"symbol"	string	optional	Market symbol to filter by	BTC
"start_time"	integer	optional	Start time in milliseconds	1625097600000
"end_time"	integer	optional	End time in milliseconds	1759215599188
"limit"	integer	optional	Maximum number of records to return, defaults to 100	100
"cursor"	integer	optional	Cursor pagination to access records. Default to none	1115hVka

/api/v1/positions/history?account=42trU9A5...&start_time=1625097600000&end_time=1759215599188

Response

• Status 200: Successfully retrieved portfolio position history

  {
  "success": true,
  "data": [
    {
      "history_id": 19329801,
      "order_id": 315293920,
      "client_order_id": "acf...",
      "symbol": "LDO",
      "amount": "0.1",
      "price": "1.1904",
      "entry_price": "1.176247",
      "fee": "0",
      "pnl": "-0.001415",
      "event_type": "fulfill_maker",
      "side": "close_short",
      "created_at": 1759215599188,
      "cause": "normal"
    },
    ...
  ],
  "next_cursor": "11111Z5RK",
  "has_more": true
}

Field	Type	Description
"history_id"	integer	History id of trade
"order_id"	integer	Order id of order that resulted in the trade
"client_order_id"	UUID	CLOID of order that resulted in the trade
"symbol"	string	Trading pair symbol
"amount"	decimal string	Amount (in token denomination) of the trade event
"price"	decimal string	Current price of the specified symbol
"entry_price"	decimal string	Price at which the trade event was executed
"fee"	decimal string	Fee paid by the trade event
"pnl"	decimal string	PnL generated by the trade event
"event_type"	string	"fulfill_taker" if maker "fulfill_maker" if taker
"side"	string	"open_long" "open_short" "close_long" "close_short"
"created_at"	integer	Timestamp in milliseconds when the trade event occurred
"cause"	string	"normal" regular user-initiated trading "market_liquidation" position was liquidated due to insufficient margin "backstop_liquidation" position was liquidated by backstop mechanism "settlement" position was closed due to Auto-Deleveraging (ADL) or other settlement
'next_cursor'	string	Next cursor for pagination
'has_more'	boolean	True if there exists a 'next_cursor'

Field	Type	Description
'event_type'	string	"fulfill_taker" if maker "fulfill_maker" if taker
'side'	string	"open_long" "open_short" "close_long" "close_short"
'cause'	string	"normal" regular user-initiated trading "market_liquidation" position was liquidated due to insufficient margin "backstop_liquidation" position was liquidated by backstop mechanism "settlement" position was closed due to Auto-Deleveraging (ADL) or other settlement

• Status 400: Invalid request parameters

• Status 401: Unauthorized access

• Status 500: Internal server error

Code Example (Python)

import requests

response = requests.get(
    "/api/v1/trades/history?account=42trU9A5...&symbol=BTC&limit=20&cursor=11115hVka",
    headers={"Accept": "*/*"},
)

data = response.json()