websocket URL :

wss://wsapi.bitz.top/

データ圧縮

データ伝送効率を改善するため、Bit-Z Websocketは2019年10月8日17:00(UTC + 8)に非圧縮データのサポートを停止し、GZIP圧縮データのみを出力します。Bit-Z APIユーザーができるだけ早めにアップグレードしてください:サブスクライブするときにdataType = 1パラメーターを追加すると、ユーザーはデータを受信する後にローカルで解凍します。 解凍については、ドキュメントとdemoを参照してください

ハートビートと持続戦略

  1. クライアントは5秒ごとに ping文字列をサーバに送信し、サーバはこのハートビートとの長い接続を維持するためpong文字列を返信する
  2. 10秒ごとにサーバを検測:もし60秒以内にクライアントのpingが `受信しない場合、自動的に連続を切断する。
  3. 5秒ごとにサーバがクライアントとのネットワーク接続状況を検測する。もしネットワークが中断されると、サーバーは今回の契約を削除し、クライアントにも新しいメッセージを受信しない。クライアントはこの時点で購読再要求`の必要があり, 購読リクエストを開始して、以前の購読請求は無効になります
  4. サーバがクライアントに新しいメッセージを送信するとき、サーバはこの時点のネットワークの接続状況(ネットワークの中断など)も検測します。

要求コマンド書式を送信:

送信json

{"action":"Topic.sub","data":{"symbol":"bz_usdt","type":"market,depth,order,kline","resolution":"60min","_CDID":"100002","dataType": "1"},"msg_id":1562156656532}

解析して展示する:

{
    "action": "Topic.sub",
    "data": {
        "symbol": "bz_usdt",
        "type": "market,depth,order,kline",
        "resolution": "60min",
        "_CDID": "100002",
        "dataType": "1"
    },
    "msg_id": 1562156656532
}

コマンド詳細:

action:
  • 購読請求:Topic.sub 購読を追加、Topic.unsub 購読をキャンセル;単選
data :
1. symbol
  • 取引ペア名称、例: btc_usdteth_btc;単選
    2. type
  • 購読タイプ オプション:相場 market、深度depth、取引オーダーorder、k線kline; コンマで区切って複数選択できます
    3. resolution (転送非必要)
  • 購読のタイプはklineがある時転送必要:1min5min15min30min60min4hour1day5day1week1mon; 単選
    4. _CDID
  • サイト情報 bitzサイト値: 100002

    5. dataType(非必要 デフォルト0)
    • 0:(デフォルト)文字列形式データ

    • 1:gzip圧縮後のバイナリ形式データであり、ユーザークライアントに解凍する必要があります

      msg_id:

      現在のミリ秒タイムスタンプ

クライアント受信メッセージ:

1. market 相場情報:

{
    "msgId": 0,  # メッセージID
    "params": [],  #パラメータ
    "data": {  # データ
        "btc_usdt": {  #取引ペア名称
            "s": "btc_usdt", #取引ペア名称
            "q": "748289393.19", #24時間取引額
            "v": "68457.02", #24時間取引量
            "tp": "6.58",  #今日の価格変動
            "p24": "11.74", #24時間の価格変更
            "o": "10138.95", #始値
            "h": "11500.00",  #24時間の最高価格
            "l": "9728.61",  #24時間の最低価格
            "n": "11330.00", #現在価格
            "nP": 4,  #数量小数点位の展示
            "pP": 2, #価格小数点位の展示
            "cny": "77978.74", #人民元推定値
            "usd": "11330.00", #ドル推定値
            "krw": "13235981.30", #ウォン推定値
            "jpy": "1220905.17" #日本円推定値
        },
        ...... #他のすべての取引ペアの相場
    },
    "action": "Pushdata.market", #購読タイプ
    "time": 1562159048028, #メッセージ時間
    "source": "sub-api" #送信元
}

2. order 取引オーダー情報:

{
    "msgId": 0, #メッセージID
    "params": { #パラメータ
        "symbol": "bz_usdt" #取引ペア名称
    },
    "action": "Pushdata.order", #購読タイプ
    "data": [ #data
        {
            "id": 1216814315, #id
            "t": "21:04:10", #時間
            "T": 1562159050, #タイムスタンプ
            "p": "0.1599", #価格
            "n": "2185.0000", #数量
            "s": "sell" #方向 sell: 売る buy:買う
        }
    ],
    "time": 1562159051901, #メッセージ時間
    "source": "sub-api" #送信元
}

3. depth 深度情報:

{
    "msgId": 0, #メッセージID
    "params": { #パラメータ
        "symbol": "bz_usdt" #取引ペア名称
    },
    "action": "Pushdata.depth", #購読タイプ
    "data": { #data
        "asks": [ # コミッションの方向: asks: 売る、bids:買う
            [
                "0.1586", #価格
                "616.4175", #数量
                "97.7638" #合計
            ]
        ]
    },
    "time": 1562159910917, #メッセージ時間
    "source": "sub-api" #送信元
}

4. kline k線情報:

{
    "msgId": 0, #メッセージID
    "params": { #パラメータ
        "symbol": "bz_usdt", #取引ペア名称
        "resolution": "60min" #kラインタイプ
    },
    "action": "Pushdata.kline", #購読タイプ
    "data": { #data
        "bars": [ # k線リストを含む
            {
                "time": "1562155200000", #ミリ秒タイムスタンプ
                "open": "0.1609", #始値
                "high": "0.1635", #最高価格
                "low": "0.1575", #最低価格
                "close": "0.1603", #終値
                "volume": "1288739.3374", #取引量
                "datetime": "2019-07-03 20:00:00" #k線時間
            }
        ],
        "resolution": "60min", #kラインタイプ
        "symbol": "bz_usdt", # k線取引ペア名称
        "from": "1562155200000", #開始時間
        "to": "1562151600000", #終了時間
        "size": 1 #k線総数
    },
    "time": 1562156715923, #メッセージ時間
    "source": "sub-api" #送信元
}

エラーメッセージ:

  • -101001 購読タイプtypeパラメータエラー
  • -101002 購読取引ペアsymbol取得失敗
  • -101003 Kラインスケールresolutionエラー

results matching ""

    No results matching ""