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

​
GET /kline

​
インターフェース説明

このインターフェースは履歴Kラインの照会に使用できます。ただし、1回のリクエストで照会できる商品は1つのみです。取得した履歴Kラインはローカルデータベースにキャッシュすることを推奨します。 HTTPインターフェースでKラインを取得する場合は、/kline と /batch-kline の2つのインターフェースを組み合わせて使用することを推奨します。手順は次のとおりです。
  • まず、/kline インターフェースで履歴データをポーリング取得し、ローカルデータベースに保存します。以後の履歴データは顧客側データベースから直接取得でき、再度インターフェースを呼び出す必要はありません。
  • その後、/batch-kline インターフェースを継続的に使用し、複数商品の最新2本のKラインを一括取得してデータベースを更新します。
この方法により最新Kラインをすばやく更新でき、履歴Kラインを頻繁にリクエストすることで頻度制限を受けることも避けられます。

​
リクエスト頻度

プラン単独リクエスト複数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株、主要指数データのインターフェースURL: 2. 外国為替、貴金属、暗号資産、原油、CFD指数、商品のインターフェースURL:

​
リクエスト例

1. 米国株、香港株、A株、主要指数データのリクエスト例: 照会リクエストを送信する際は、メソッド名とtoken情報を含める必要があります。リクエスト例は次のとおりです。 https://quote.alltick.co/quote-stock-b-api/kline?token=your_token&query=queryData 2. 外国為替、貴金属、暗号資産、原油、CFD指数、商品のリクエスト例: 照会リクエストを送信する際は、メソッド名とtoken情報を含める必要があります。リクエスト例は次のとおりです。 https://quote.alltick.co/quote-b-api/kline?token=your_token&query=queryData

​
リクエストパラメータ

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

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

{
  "trace": "3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
  "data": {
    "code": "857.HK",
    "kline_type": 1,
    "kline_timestamp_end": 0,
    "query_kline_num": 2,
    "adjust_type": 0
  }
}
名称型必須説明
tracestringはいログ照会に使用するトレースコードです。リクエストごとに一意にしてください。
dataobjectはい
» codestringはいcodeリストを確認し、照会するcodeを選択してください: [codeリストを開く]
注意: code値の大文字・小文字は商品リスト内のcodeと一致させる必要があります。
» kline_typeintegerはい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_endintegerはい指定時刻から過去に向かってKラインを照会します。
1. 0を渡すと、現在最新の取引日から過去に向かってKラインを照会します。
2. 指定時刻を使う場合はタイムスタンプを渡し、そのタイムスタンプから過去に向かって照会します。
3. タイムスタンプ指定に対応しているのは外国為替、貴金属、暗号資産のみで、株式系codeは対応していません。
» query_kline_numintegerはい1. 照会するKライン本数を示します。1回のリクエストで最大500本まで取得でき、タイムスタンプを使って過去方向に繰り返し取得できます。
2. このフィールドで前日終値を照会できます。kline_type に8、query_kline_num に2を渡すと、返却された2本のKラインのうちタイムスタンプが小さいデータが前日終値です。
» adjust_typeintegerはい復権タイプです。株式系codeの場合のみ有効です。例: 0: 除権、1: 前方復権。現在は0のみ対応しています。

​
レスポンス例

{
  "ret": 200,
  "msg": "ok",
  "trace": "3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
  "data": {
    "code": "857.HK",
    "kline_type": 1,
    "kline_list": [
      {
        "timestamp": "1677829200",
        "open_price": "136.421",
        "close_price": "136.412",
        "high_price": "136.422",
        "low_price": "136.407",
        "volume": "0",
        "turnover": "0"
      },
      {
        "timestamp": "1677829260",
        "open_price": "136.412",
        "close_price": "136.401",
        "high_price": "136.415",
        "low_price": "136.397",
        "volume": "0",
        "turnover": "0"
      }
    ]
  }
}

​
レスポンス結果

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

​
レスポンスデータ構造

名称型必須説明
» retintegertrue
» msgstringtrue
» tracestringtrue
» dataobjecttrue
»» 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_list[object]true
»»» timestampstringtrueこのKラインのタイムスタンプ
»»» open_pricestringtrueこのKラインの始値
»»» close_pricestringtrueこのKラインの終値:
1. 取引時間中、最新の1本のKラインでは、この価格は最新約定価格でもあります。
2. 休場中、最新の1本のKラインでは、この価格は終値です。
»»» high_pricestringtrueこのKラインの高値
»»» low_pricestringtrueこのKラインの安値
»»» volumestringtrueこのKラインの約定数量
»»» turnoverstringtrueこのKラインの約定金額

​
AllTickウェブサイト

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

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

GET /kline デバッグモジュールを開く

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