Query Recent Trades

Endpoint: /v1/futures/trade

Request Parameters

Method: GET

Example

Bash

curl -X GET "https://oapi.websea.com/v1/futures/trade?symbol=BTC-USDT&size=150"

Query Parameters

Parameter	Required	Type	Example	Description
symbol	Yes	string	BTC-USDT	Trading pair
size	No	int	150	Number of trades to retrieve, range: [1, 2000]

Response Parameters

Parameter	Required	Type	Example	Description
errno	Yes	int	0	Status code
errmsg	Yes	string	success	Status message
result	Yes	object	See example	Result data

Result Fields

Parameter	Required	Type	Example	Description
ts	Yes	long	1499223904680	Data timestamp
symbol	Yes	string	BTC-USDT	Trading pair
data	Yes	array	See example	Trade data

Result → Data Fields

Parameter	Required	Type	Example	Description
id	Yes	long	17592256642623	Trade ID
price	Yes	string	1997	Trade price
amount	Yes	string	0.04	Trade quantity
direction	Yes	string	buy	Trade side: buy or sell
ts	Yes	long	1502448920105	Trade timestamp

Response Example

JSON

{
    "errno": 0,
    "errmsg": "success",
    "result": {
        "symbol": "EOS-USDT",
        "ts": "1499223904680",
        "data": [
            {
                "id": 17592256642623,
                "amount": "0.04",
                "price": "1997",
                "direction": "buy",
                "ts": 1502448920106
            },
            {
                "id": 17592256642622,
                "amount": "0.04",
                "price": "1997",
                "direction": "sell",
                "ts": 1502448920105
            }
        ]
    }
}