GET 単一商品の履歴Kライン照会（高値・安値・始値・終値）

このインターフェースは履歴Kラインの照会に使用できます。ただし、1回のリクエストで照会できる商品は1つのみです。取得した履歴Kラインはローカルデータベースにキャッシュすることを推奨します。

​

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:

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

2. 外国為替、貴金属、暗号資産、原油、CFD指数、商品のインターフェースURL:

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

​

リクエスト例

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

​

リクエストパラメータ

名称	位置	型	必須	説明
token	query	string	いいえ
query	query	string	いいえ	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
  }
}

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

​

レスポンス結果

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

​

レスポンスデータ構造

名称	型	必須	説明
» ret	integer	true
» msg	string	true
» trace	string	true
» data	object	true
»» code	string	true	コード
»» kline_type	integer	true	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分のみ対応しています。
»» kline_list	[object]	true
»»» timestamp	string	true	このKラインのタイムスタンプ
»»» open_price	string	true	このKラインの始値
»»» close_price	string	true	このKラインの終値: 1. 取引時間中、最新の1本のKラインでは、この価格は最新約定価格でもあります。 2. 休場中、最新の1本のKラインでは、この価格は終値です。
»»» high_price	string	true	このKラインの高値
»»» low_price	string	true	このKラインの安値
»»» volume	string	true	このKラインの約定数量
»»» turnover	string	true	このKラインの約定金額

​

AllTickウェブサイト

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

​

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

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

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