K라인(캔들)

K라인 데이터 조회

엔드포인트: /v1/futures/kline

요청 매개변수

메서드: GET

예시

Bash

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

쿼리 매개변수

매개변수	필수 여부	타입	예시	설명
symbol	예	string	BTC-USDT	거래쌍
period	예	string	1min	K라인 주기: 1min, 5min, 15min, 30min, 1hour, 6hour, 12hour, 1day, 1week
size	아니요	int	150	조회할 레코드 수, 범위: [1, 2000]
start	아니요	int	16745631221	시작 타임스탬프
end	아니요	int	16745631221	종료 타임스탬프

응답 매개변수

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

결과 필드

매개변수	필수 여부	타입	예시	설명
ts	예	long	1499223904680	데이터 타임스탬프
symbol	예	string	BTC-USDT	거래쌍
period	예	string	1min	K라인 주기: 1min, 5min, 15min, 30min, 60min, 1day, 1mon, 1week, 1year
data	예	array	예시 참조	K라인 데이터

결과 → 데이터 필드

매개변수	필수 여부	타입	예시	설명
id	예	long	1499223904680	K라인 ID
amount	예	string	37593.0266	거래량
count	예	int	1	체결 횟수
open	예	string	1935.2000	시가
close	예	string	1879.0000	종가 (최신 K라인의 경우 현재가)
low	예	string	1856.0000	저가
high	예	string	1940.0000	고가
vol	예	string	71031537.97866500	거래대금 (체결가 × 체결량의 합계)

응답 예시

JSON

{
    "errno": 0,
    "errmsg": "success",
    "result": {
        "symbol": "EOS-USDT",
        "period": "1min",
        "ts": "1499223904680",
        "data": [
            {
                "id": 1499184000,
                "amount": "37593.0266",
                "count": 0,
                "open": "1935.2000",
                "close": "1879.0000",
                "low": "1856.0000",
                "high": "1940.0000",
                "vol": "71031537.97866500"
            }
        ]
    }
}