GET 板情報（最新深度 / Order Book）照会

本インターフェース文書では、AllTick株式HTTP APIの「GET 最新板情報照会」APIについて説明します。米国株、香港株、A株などの最新板情報を照会でき、買一・売一、複数段階の買気配・売気配、板深度情報を取得できます。リクエストURL、パラメータ説明、レスポンスフィールド形式、頻度制限も示し、量化取引、マーケットメイキングシステム、相場端末でリアルタイム注文板データを利用する際に役立ちます。

​

GET /depth-tick

​

インターフェース説明

各商品タイプで取得できる最大板深度は次のとおりです。

1. 取引が活発でない商品では、取得できる深度が下表の最大値より少ない場合があります。これは正常です。
2. 板の片側が空になる場合があります。たとえば、株式がストップ高またはストップ安になった場合、板の片側が空になることがあります。

項目	外国為替、貴金属、原油	暗号資産	香港株	米国株	A株
深度説明	最大1段	最大5段	最大10段	最大1段	最大5段

​

リクエスト頻度

プラン	単独リクエスト	複数HTTPインターフェースを同時にリクエスト
無料	10秒ごとに1回のみリクエスト可能	1. 10秒に1つのインターフェースのみリクエスト可能。 2. 複数インターフェースをリクエストする場合、/batch-kline は10秒間隔が必要です。 3. すべてのインターフェース合計で1分あたり最大10回（6秒に1回）。 4. 1日の最大リクエスト数は1,000回。超過した場合は翌日未明に利用が回復します。
ベーシック	1秒ごとに1回のみリクエスト可能	1. 同一秒内に1つのインターフェースのみリクエスト可能。 2. 複数インターフェースをリクエストする場合、/batch-kline は3秒間隔が必要です。 3. すべてのインターフェース合計で1分あたり最大60回（1秒に1回）。 4. 1日の最大リクエスト数は86,400回。超過した場合は翌日未明に利用が回復します。
アドバンス	1秒あたり最大10回リクエスト可能	1. すべてのインターフェース合計で1秒あたり10回までリクエスト可能。 2. 複数インターフェースをリクエストする場合、/batch-kline は2秒間隔が必要です。 3. すべてのインターフェース合計で1分あたり最大600回（1秒に10回）。 4. 1日の最大リクエスト数は864,000回。超過した場合は翌日未明に利用が回復します。
プロフェッショナル	1秒あたり最大20回リクエスト可能	1. すべてのインターフェース合計で1秒あたり20回までリクエスト可能。 2. 複数インターフェースをリクエストする場合、/batch-kline は1秒間隔が必要です。 3. すべてのインターフェース合計で1分あたり最大1,200回（1秒に20回）。 4. 1日の最大リクエスト数は1,728,000回。超過した場合は翌日未明に利用が回復します。
香港株すべて	1秒あたり最大20回リクエスト可能	1. すべてのインターフェース合計で1秒あたり20回までリクエスト可能。 2. 複数インターフェースをリクエストする場合、/batch-kline は1秒間隔が必要です。 3. すべてのインターフェース合計で1分あたり最大1,200回（1秒に20回）。 4. 1日の最大リクエスト数は1,728,000回。超過した場合は翌日未明に利用が回復します。
A株すべて	1秒あたり最大20回リクエスト可能	1. すべてのインターフェース合計で1秒あたり20回までリクエスト可能。 2. 複数インターフェースをリクエストする場合、/batch-kline は1秒間隔が必要です。 3. すべてのインターフェース合計で1分あたり最大1,200回（1秒に20回）。 4. 1日の最大リクエスト数は1,728,000回。超過した場合は翌日未明に利用が回復します。
米国株すべて	1秒あたり最大20回リクエスト可能	1. すべてのインターフェース合計で1秒あたり20回までリクエスト可能。 2. 複数インターフェースをリクエストする場合、/batch-kline は1秒間隔が必要です。 3. すべてのインターフェース合計で1分あたり最大1,200回（1秒に20回）。 4. 1日の最大リクエスト数は1,728,000回。超過した場合は翌日未明に利用が回復します。

​

インターフェース制限

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

​

インターフェースURL

1. 米国株、香港株、A株、主要指数データ:

• ベースパス: /quote-stock-b-api/depth-tick
• 完全URL: https://quote.alltick.co/quote-stock-b-api/depth-tick

2. 外国為替、貴金属、暗号資産、原油、CFD指数、商品:

• ベースパス: /quote-b-api/depth-tick
• 完全URL: https://quote.alltick.co/quote-b-api/depth-tick

​

リクエスト例

1. 米国株、香港株、A株、主要指数データ:

照会リクエストを送信する際は、メソッド名とtoken情報を含めます。例:

https://quote.alltick.co/quote-stock-b-api/depth-tick?token=your_token&query=queryData

2. 外国為替、貴金属、暗号資産、原油、CFD指数、商品:

照会リクエストを送信する際は、メソッド名とtoken情報を含めます。例:

https://quote.alltick.co/quote-b-api/depth-tick?token=your_token&query=queryData

​

リクエストパラメータ

名称	位置	型	必須	説明
token	query	string	いいえ
query	query	string	いいえ	queryリクエストパラメータ説明を参照してください。

​

queryリクエストパラメータ

次のJSONをURLエンコードし、URLの query クエリ文字列に設定します。

{
  "trace": "edd5df80-df7f-4acf-8f67-68fd2f096426",
  "data": {
    "symbol_list": [
      {
        "code": "857.HK"
      },
      {
        "code": "UNH.US"
      }
    ]
  }
}

名称	型	必須	説明
trace	string	はい
data	object	はい
» symbol_list	[object]	はい
»» code	string	いいえ	コード。codeリストから照会するcodeを選択してください。 注意: code値は大文字・小文字を区別し、商品リスト内のcodeと一致させる必要があります。

​

レスポンス例

{
  "ret": 200,
  "msg": "ok",
  "trace": "edd5df80-df7f-4acf-8f67-68fd2f096426",
  "data": {
    "tick_list": [
      {
        "code": "857.HK",
        "seq": "30686349",
        "tick_time": "1677830357227",
        "bids": [
          {
            "price": "136.424",
            "volume": "100000.00"
          }
        ],
        "asks": [
          {
            "price": "136.427",
            "volume": "400000.00"
          }
        ]
      }
    ]
  }
}

​

レスポンス結果

ステータスコード	ステータスの意味	説明	データモデル
200	OK	OK	Inline

名称	型	必須	説明
» ret	integer	true	戻りコード
» msg	string	true	戻りコードに対応するメッセージ
» trace	string	true	リクエストトレース
» data	object	true
»» tick_list	[object]	true
»»» code	string	false	コード
»»» seq	string	false	相場シーケンス番号
»»» tick_time	string	false	相場タイムスタンプ
»»» bids	[object]	false	買い板リスト
»»»» price	string	false	価格
»»»» volume	string	false	数量
»»» asks	[object]	false	売り板リスト
»»»» price	string	false	価格
»»»» volume	string	false	数量。 1. 一部のCFD指数は数量を提供しません。 2. 外国為替、貴金属、エネルギー、株式、暗号資産はいずれも数量を提供します。

​

AllTickウェブサイト

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

​

インターフェースデバッグ

GET /depth-tick デバッグモジュールを開く

デバッグ可能なモジュールでパラメータを入力し、リクエストを送信します。