> ## Documentation Index > Fetch the complete documentation index at: https://alltick.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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インターフェース制限](/ja/getting-started/http-interface-restrictions) 2. 必ずお読みください: [エラーコード説明](/ja/getting-started/error-code-description) ## インターフェースURL **1. 米国株、香港株、A株、主要指数データのインターフェースURL:** * ベースパス: `/quote-stock-b-api/kline` * 完全URL: [https://quote.alltick.co/quote-stock-b-api/kline](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](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](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](https://quote.alltick.co/quote-b-api/kline?token=your_token\&query=queryData) ## リクエストパラメータ | 名称 | 位置 | 型 | 必須 | 説明 | | ----- | ----- | ------ | --- | --------------------------- | | token | query | string | いいえ | | | query | query | string | いいえ | queryリクエストパラメータ説明を参照してください。 | ## queryリクエストパラメータ ```json theme={null} { "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のみ対応しています。 | ## レスポンス例 ```json theme={null} { "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/](https://alltick.co/) ## インターフェースデバッグ デバッグ可能なモジュールでパラメータを入力し、リクエストを送信します。