Query Market Trades

Endpoint: /v1/spot/trade

Request Method

GET

Example

Bash

curl -X GET "https://oapi.websea.com/v1/spot/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	int	1499184000	Data timestamp
symbol	Yes	string	BTC-USDT	Trading pair
data	Yes	array	See example	Trade data

Data Fields

JSON

"data": [
  {
    "id": "Trade ID",
    "price": "Trade price",
    "amount": "Trade quantity",
    "vol": "Trade notional value (price × quantity)",
    "direction": "Aggressive side (buy / sell)",
    "ts": "Trade execution time"
  }
]

Response Example

JSON

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

JSON

{
  "errno": 10010,
  "errmsg": "failed"
}