Skip to main content

Get Public Trading History

Query recent public trading data in Zoomex.

Covers: Spot / USDT perpetual/ Inverse contract

You can download archived historical trades here:

HTTP Request

GET /cloud/trade/v3/market/recent-trade

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct type. spot,linear,inverse
symbolfalsestringSymbol name
  • required for spot/linear/inverse
limitfalseintegerLimit for data size per page.
  • [1,1000], default: 500

Response Parameters

ParameterTypeComments
categorystringProducts category
listarrayObject
> execIdstringExecution ID
> symbolstringSymbol name
> pricestringTrade price
> sizestringTrade size
> sidestringSide of taker Buy, Sell
> timestringTrade time (ms)

Request Example

GET /cloud/trade/v3/market/recent-trade?category=linear&symbol=BTCUSDT&limit=1 HTTP/1.1
Host: openapi-testnet.zoomex.com

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"category": "linear",
"list": [
{
"execId": "2100000000007764263",
"symbol": "BTCUSDT",
"price": "16618.49",
"size": "0.00012",
"side": "Buy",
"time": "1672052955758"
}
]
},
"retExtInfo": {},
"time": 1672053054358
}