콘텐츠로 이동

24시간 시세 목록 조회

엔드포인트: /v1/spot/24kline_list

요청 메서드

GET

설명

하나 또는 여러 현물 거래쌍의 24시간 시장 통계 데이터를 조회합니다.
거래쌍(symbol)을 지정하지 않으면 모든 거래쌍의 데이터가 반환됩니다.

예시

Bash
curl -X GET "https://oapi.websea.com/v1/spot/24kline_list?symbol=BTC-USDT"

쿼리 매개변수

매개변수 필수 여부 타입 예시 설명
symbol 아니요 string BTC-USDT 거래쌍. 여러 개일 경우 쉼표로 구분(예: BTC-USDT,ETH-USDT,EOS-USDT). 생략 시 모든 거래쌍 반환

응답 매개변수

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

결과 필드 설명

JSON
{
  "id": "응답 ID",
  "amount": "최근 24시간 동안의 거래량(기초 자산 기준)",
  "count": "최근 24시간 동안의 체결 횟수",
  "open": "최근 24시간 시가",
  "close": "최근 24시간 종가",
  "low": "최근 24시간 저가",
  "high": "최근 24시간 고가",
  "vol": "최근 24시간 동안의 거래대금(상대 자산 기준)",
  "ask": "최우선 매도 호가",
  "bid": "최우선 매수 호가"
}

응답 예시

JSON
{
  "errno": 0,
  "errmsg": "success",
  "result": [
    {
      "symbol": "BTC-USDT",
      "data": {
        "id": 1564383039,
        "amount": "501.58104763207614180517",
        "count": 21030,
        "open": "9510.3854955",
        "close": "9611.293874",
        "low": "9183.037249591129",
        "high": "9722.409967228807",
        "vol": "4758286.23",
        "ask": "9613",
        "bid": "9610"
      }
    },
    {
      "symbol": "ETH-USDT",
      "data": {
        "id": 1564383052,
        "amount": "16009.212149527699210913",
        "count": 29174,
        "open": "210.117172",
        "close": "211.8394075",
        "low": "199.2297417116734",
        "high": "215.22023539561525",
        "vol": "3340147.73",
        "ask": "213",
        "bid": "209"
      }
    }
  ]
}
JSON
{
  "errno": 10010,
  "errmsg": "failed"
}