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

​
POST /batch-kline

​
インターフェース説明

このインターフェースは複数商品を一括照会でき、複数のKラインタイプ（1分、15分、30分など）も一括照会できます。ただし、一括照会できるのは最新2本のKラインのみです。 HTTPインターフェースでKラインを取得する場合は、/kline と /batch-kline を組み合わせて使用することを推奨します。
  • まず、/kline インターフェースで履歴データをポーリング取得し、ローカルデータベースに保存します。
  • その後、/batch-kline インターフェースで複数商品の最新2本Kラインを継続的に一括取得し、データベースを更新します。
この方法により最新Kラインをすばやく更新でき、履歴Kラインを頻繁にリクエストすることで頻度制限を受けることを避けられます。

​
リクエスト頻度

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

​
インターフェース制限

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

​
インターフェースURL

1. 米国株、香港株、A株、主要指数データのインターフェースURL: 2. 外国為替、貴金属、暗号資産、原油、CFD指数、商品のインターフェースURL:

​
リクエスト例

1. 米国株、香港株、A株、主要指数データのリクエスト例: 商品の最新Kラインを一括照会する場合、一括照会パラメータが多いためbodyに配置します。URLパラメータにはtokenのみを保持します。 https://quote.alltick.co/quote-stock-b-api/batch-kline?token=your_token 2. 外国為替、貴金属、暗号資産、原油、CFD指数、商品のリクエスト例: 商品の最新Kラインを一括照会する場合、一括照会パラメータが多いためbodyに配置します。URLパラメータにはtokenのみを保持します。 https://quote.alltick.co/quote-b-api/batch-kline?token=your_token

​
商品の最新Kラインを一括照会する場合、一括照会パラメータが多いためbodyに配置します。URLパラメータにはtokenのみを保持します。

​
Bodyリクエストパラメータ

{
  "trace": "c2a8a146-a647-4d6f-ac07-8c4805bf0b74",
  "data": {
    "data_list": [
      {
        "code": "700.HK",
        "kline_type": 1,
        "kline_timestamp_end": 0,
        "query_kline_num": 1,
        "adjust_type": 0
      },
      {
        "code": "GOOGL.US",
        "kline_type": 1,
        "kline_timestamp_end": 0,
        "query_kline_num": 1,
        "adjust_type": 0
      }
    ]
  }
}

​
リクエストパラメータ

名称位置型必須説明
tokenquerystringはいtokenが不明な場合は、担当者へお問い合わせください。
bodybodyobjectいいえ
» tracebodystringはいログ照会に使用するトレースコードです。リクエストごとに一意にしてください。
» databodyobjectはい
»» data_listbody[object]はい
»»» codebodystringはいcodeリストを確認し、照会するcodeを選択してください: [codeリストを開く]
注意: code値の大文字・小文字は商品リスト内のcodeと一致させる必要があります。
»»» kline_typebodyintegerはいKラインタイプ:
1. 1は1分K、2は5分K、3は15分K、4は30分K、5は時間足、6は2時間K（株式は2時間K非対応）、7は4時間K（株式は4時間K非対応）、8は日足、9は週足、10は月足です。注: 株式は2時間K、4時間Kに対応していません。
2. 最短のKラインは1分のみ対応しています。
3. 前日終値を照会する場合、kline_type に8を渡します。
»»» kline_timestamp_endbodyintegerはい指定時刻から過去に向かってKラインを照会します。
1. 0を渡すと最新取引日から過去に向かって照会します。
2. タイムスタンプを渡すと、そのタイムスタンプから過去に向かって照会します。
3. タイムスタンプ指定に対応しているのは外国為替、貴金属、暗号資産のみで、株式系codeは対応していません。
»»» query_kline_numbodyintegerはい1. 照会するKライン本数を示します。このインターフェースでは最大2本のKラインのみ照会できます。
2. このフィールドで前日終値を照会できます。kline_type に8、query_kline_num に2を渡すと、返却された2本のKラインのうちタイムスタンプが小さいデータが前日終値です。
»»» adjust_typebodyintegerはい復権タイプです。株式系codeの場合のみ有効です。例: 0: 除権、1: 前方復権。現在は0のみ対応しています。

​
レスポンス例

{
  "ret": 200,
  "msg": "ok",
  "trace": "c2a8a146-a647-4d6f-ac07-8c4805bf0b74",
  "data": {
    "kline_list": [
      {
        "code": "700.HK",
        "kline_type": 1,
        "kline_data": [
          {
            "timestamp": "1677829200",
            "open_price": "136.421",
            "close_price": "136.412",
            "high_price": "136.422",
            "low_price": "136.407",
            "volume": "0",
            "turnover": "0"
          }
        ]
      },
      {
        "code": "GOOGL.US",
        "kline_type": 1,
        "kline_data": [
          {
            "timestamp": "1677829200",
            "open_price": "136.421",
            "close_price": "136.412",
            "high_price": "136.422",
            "low_price": "136.407",
            "volume": "0",
            "turnover": "0"
          }
        ]
      }
    ]
  }
}

​
レスポンス結果

ステータスコードステータスの意味説明データモデル
200OKOKInline
名称型必須説明
» retintegertrue
» msgstringtrue
» tracestringtrue
» dataobjecttrue
»» kline_list[array]true
»»» codestringtrue商品コード
»»» kline_typeintegertrueKラインタイプ:
1. 1は1分K、2は5分K、3は15分K、4は30分K、5は時間足、6は2時間K（株式は2時間K非対応）、7は4時間K（株式は4時間K非対応）、8は日足、9は週足、10は月足です。注: 株式は2時間K、4時間Kに対応していません。
2. 最短のKラインは1分のみ対応しています。
»»» kline_data[array]true
»»»» timestampstringtrueKラインのタイムスタンプ
»»»» open_pricestringtrueKラインの始値
»»»» close_pricestringtrueKラインの終値:
1. 取引時間中、最新の1本ではこの価格は最新約定価格でもあります。
2. 休場中、最新の1本ではこの価格は終値です。
»»»» high_pricestringtrueKラインの高値
»»»» low_pricestringtrueKラインの安値
»»»» volumestringtrueKラインの約定数量
»»»» turnoverstringtrueKラインの約定金額

​
AllTickウェブサイト

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

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

POST /batch-kline デバッグモジュールを開く

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