コンテンツにスキップ

Websocket / ローソク足チャンネル

エンドポイント: /ws/v1/futures/market

説明

ローソク足データを取得します。プッシュ頻度は最短で1秒間隔です。イベント(約定)が発生しない場合はプッシュされません。

チャンネル名

kline${period}

注:チャンネル名内の "period" は期間を表します。例:1分足は kline1min です。現在サポートされている期間は以下の通りです。

期間 値
1分 1min
5分 5min
15分 15min
30分 30min
1時間 1hour
6時間 6hour
12時間 12hour
1日 1day
1週間 1week
1ヶ月 1mon

リクエストパラメータ

パラメータ名 必須 型 例 説明
op はい string sub 操作。sub:購読、unsub:購読解除
channel はい string kline1min チャンネル名
symbol はい string BTC-USDT 取引ペア名

レスポンスパラメータ

パラメータ名 必須 型 例 説明
errno はい int 0 ステータスコード
errmsg はい string success ステータスメッセージ
op はい string sub 操作。sub:購読、unsub:購読解除
channel はい string kline1min チャンネル名
symbol はい string BTC-USDT 取引ペア名

プッシュデータパラメータ

パラメータ名 必須 型 例 説明
channel はい string kline1min チャンネル名
symbol はい string BTC-USDT 取引ペア
id はい long 1499184000 ローソク足ID
amount はい string 37593 約定数量(単位:枚)
count int 1 約定件数
open string 1935.2000 始値
close string 1879.0000 終値
low string 1856.0000 安値
high string 1940.0000 高値
vol string 71031537.978665 取引額

プッシュ例

JSON
{
  "channel": "kline1min",
  "symbol": "BTC-USDT",
  "id": 1499184000,
  "amount": "37593",
  "count": 1,
  "open": "1935.2000",
  "close": "1879.0000",
  "low": "1856.0000",
  "high": "1940.0000",
  "vol": "71031537.978665"
}