Trading API v1 Trades

Trade history and management operations

Get trades

get

Retrieve trade history for the authenticated account with optional filtering

Query parameters

symbolstringOptional

Symbol filter

orderIdinteger · int64Optional

Order ID filter

positionIdinteger · int64Optional

Position ID filter

sidestringOptional

Trade side filter (buy, sell)

startTimeinteger · int64Optional

Start timestamp (milliseconds)

endTimeinteger · int64Optional

End timestamp (milliseconds)

pageinteger · int32Optional

Page number (1-based)

Default: 1Example: 1

sizeinteger · int32Optional

Page size

Default: 20Example: 20

Responses

200

Trades retrieved successfully

*/*

Generic paged response for v1 API following trading standards

totalinteger · int32Optional

Total number of items

Example: 100

pageinteger · int32Optional

Current page number

Example: 1

pageSizeinteger · int32Optional

Number of items per page

Example: 10

400

Invalid request parameters

*/*

500

Internal server error

*/*

get

/v1/trades

HTTPcURLJavaScriptPython

GET /api/v1/trades HTTP/1.1
Accept: */*

{
  "total": 100,
  "page": 1,
  "pageSize": 10,
  "items": []
}

Get trade by ID

get

Retrieve a specific trade by its ID

Path parameters

idinteger · int64Required

Trade ID

Responses

200

Trade retrieved successfully

*/*

tradeIdinteger · int64Optional

Unique trade identifier

Example: 123456

orderIdinteger · int64Optional

Order identifier

Example: 654321

positionIdinteger · int64Optional

Position identifier

Example: 789012

assetstringOptional

Asset symbol

Example: BTC

typestringOptional

Option type: CALL or PUT

Example: CALL

fillTypestringOptional

Fill type: FILL or PARTIAL_FILL

Example: FILL

expiryDateinteger · int64Optional

Expiry date (timestamp)

Example: 1712345678000

filledSizeUsdtstringOptional

Filled size in USDT

Example: 100.5

filledSizeContractsstringOptional

Filled size in contracts

Example: 2

strikePricestringOptional

Strike price

Example: 45000

openPricestringOptional

Open price

Example: 44900

openDateinteger · int64Optional

Open date (timestamp)

Example: 1712345678000

feestringOptional

Trade fee

Example: 0.25

tradeSidestringOptional

Trade side: BUY or SELL

Example: BUY

makerbooleanOptional

Is maker trade

Example: false

400

Invalid request parameters

*/*

404

Trade not found

*/*

500

Internal server error

*/*

get

/v1/trades/{id}

HTTPcURLJavaScriptPython

GET /api/v1/trades/{id} HTTP/1.1
Accept: */*

{
  "tradeId": 123456,
  "orderId": 654321,
  "positionId": 789012,
  "asset": "BTC",
  "type": "CALL",
  "fillType": "FILL",
  "expiryDate": 1712345678000,
  "filledSizeUsdt": 100.5,
  "filledSizeContracts": 2,
  "strikePrice": 45000,
  "openPrice": 44900,
  "openDate": 1712345678000,
  "fee": 0.25,
  "tradeSide": "BUY",
  "maker": false
}