メインコンテンツへスキップ

​
インターフェース説明

このインターフェースは、商品の最新約定価格（リアルタイムTickデータ、現在値および最新価格）の一括購読に対応しています。履歴約定価格（履歴Tickデータ）には対応していません。 各WebSocket接続では、このリクエストを送信するたびに、バックエンドはデフォルトで前回の購読リクエストを上書きします。たとえば、最初に商品A、B、Cを購読しており、E、F、Gを追加したい場合は、A、B、C、E、F、Gをまとめて再送信する必要があります。購読が成功するとデータがプッシュされます。 注意事項:
  1. 購読に一度成功した後は、頻繁に購読リクエストを再送信する必要はありません。10秒ごとにハートビートを送信する必要があり、インターフェースはリアルタイムでデータをプッシュします。30秒以内にハートビートリクエストを受信しない場合はタイムアウトとみなし、リクエスト元のWebSocket接続を切断します。
  2. 接続時には、ネットワークなどの原因で切断された後に自動再接続できるよう、自動再接続ロジックを追加できます。

​
インターフェース制限

  1. 必ずお読みください: WebSocketインターフェース制限
  2. 必ずお読みください: エラーコード説明

​
インターフェースURL

1. 米国株、香港株、A株、主要指数データのインターフェースURL:
  • ベースパス: /quote-stock-b-ws-api
  • 完全URL: wss://quote.alltick.co/quote-stock-b-ws-api
2. 外国為替、貴金属、暗号資産、原油、CFD指数、商品のインターフェースURL:
  • ベースパス: /quote-b-ws-api
  • 完全URL: wss://quote.alltick.co/quote-b-ws-api

​
リクエスト例

1. 米国株、香港株、A株、主要指数データのリクエスト例: 接続を確立するたびに、認証tokenを次のようにURLへ付加する必要があります。 wss://quote.alltick.co/quote-stock-b-ws-api?token=your_token 接続成功後、必要に応じて具体的な株式市場データを購読できます。詳細な呼び出し方法は以下のドキュメントを参照してください。 2. 外国為替、貴金属、暗号資産、原油、CFD指数、商品のリクエスト例: 接続を確立するたびに、認証tokenを次のようにURLへ付加する必要があります。 wss://quote.alltick.co/quote-b-ws-api?token=your_token 接続成功後、必要に応じて具体的な外国為替、暗号資産、貴金属、商品データを購読できます。詳細な呼び出し方法は以下のドキュメントを参照してください。

​
リクエスト - プロトコル番号: 22004

​
JSON定義

フィールド名称型必須説明
cmd_idプロトコル番号integerはいTick購読リクエストのプロトコル番号は固定で22004です。
seq_idレスポンスIDintegerはい購読リクエスト識別子。レスポンスで返却されます。任意値で、リクエストごとに重複しても構いません。
trace追跡IDstringはいリクエストログ情報用の追跡ID。任意値で、リクエストごとに重複させないでください。
symbol_list商品リストarrayはい具体的な形式は下記のsymbol定義を参照してください。

​
Symbol定義

フィールド名称型必須説明
codeコードstringはい詳細はcodeリストを参照してください: codeリストを開く
注意: code値の大文字・小文字は商品リスト内のcodeと一致させる必要があります。

​
データ構造（JSON）

{
  "cmd_id": 22004,
  "seq_id": 123,
  "trace": "3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
  "data": {
    "symbol_list": [
      {
        "code": "BTCUSDT"
      },
      {
        "code": "ETHUSDT"
      }
    ]
  }
}

​
レスポンス - プロトコル番号: 22005

​
データ構造（JSON）

{
  "ret": 200,
  "msg": "ok",
  "cmd_id": 22005,
  "seq_id": 123,
  "trace": "3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
  "data": {}
}

​
プッシュ - プロトコル番号: 22998

​
データ定義

フィールド名称型説明
codeコードstring詳細はcodeリストを参照してください: codeリストを開く
seq相場シーケンス番号integer
tick_time相場タイムスタンプinteger単位: ミリ秒
price約定価格string最新約定価格
volume約定数量string最新約定価格に対応する約定数量
turnover約定金額string約定金額
trade_direction取引方向string取引方向:
1. 0はデフォルト値、1は買い、2は売りです。
2. 外国為替、貴金属、エネルギーはデフォルトで1のみ返します。
3. 株式と暗号資産は市場状況により0、1、2を返す場合があります。
4. 詳細説明:
0: 中立。最良買気配と最良売気配の間の価格で約定したことを示します。
1: アグレッシブ買い。売気配価格またはそれ以上の価格で約定したことを示します。
2: アグレッシブ売り。買気配価格またはそれ以下の価格で約定したことを示します。

​
データ構造（JSON）

{
  "cmd_id": 22998,
  "data": {
    "code": "1288.HK",
    "seq": 1782180168224,
    "tick_time": 1782180164000,
    "price": "651.12",
    "volume": "300",
    "turnover": "12345.6",
    "trade_direction": 1
  }
}

​
AllTickウェブサイト

公式サイト: https://alltick.co/