시장 체결 내역 조회

엔드포인트: /v1/spot/trade

요청 메서드

GET

예시

Bash

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

쿼리 매개변수

매개변수	필수 여부	타입	예시	설명
symbol	예	string	BTC-USDT	거래쌍
size	아니요	int	150	조회할 체결 내역 개수. 범위: [1, 2000]

응답 매개변수

매개변수	필수 여부	타입	예시	설명
errno	예	int	0	상태 코드
errmsg	예	string	success	상태 메시지
result	예	object	예시 참조	결과 데이터

결과 필드

매개변수	필수 여부	타입	예시	설명
ts	예	int	1499184000	데이터 타임스탬프
symbol	예	string	BTC-USDT	거래쌍
data	예	array	예시 참조	체결 데이터

데이터 필드

JSON

"data": [
  {
    "id": "체결 ID",
    "price": "체결 가격",
    "amount": "체결 수량",
    "vol": "체결 금액 (가격 × 수량)",
    "direction": "체결 방향 (buy / sell)",
    "ts": "체결 시간"
  }
]

응답 예시

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"
}