金融ダッシュボードの構築や自動売買ボットの開発において、信頼性の高い履歴K線（Kline/キャンドルスティック）データはテクニカル分析の生命線です。バックテストの実施から市場トレンドの可視化まで、Alltick API は様々なアセットクラスのデータ取得を可能にする洗練された REST インターフェースを提供します。
本ガイドでは、Alltick の K線エンドポイントの使用方法、パラメータの詳細、および購読プランごとのデータ取得可能期間について解説します。
Alltick K線エンドポイントの概要
履歴K線データを取得するためのプライマリ・エンドポイントは以下の通りです：
このインターフェースは GET メソッド を使用しますが、一般的な REST API とは異なり、パラメータを JSON クエリ文字列 として渡す必要があります。
リクエスト構造とパラメータ詳細
API を正しく呼び出すには、認証用の token と query オブジェクトが必要です。主要なパラメータは以下の通りです：
| パラメータ名 | 型 | 説明 |
| token | String | 固有の API 認証トークン。 |
| code | String | アセットシンボル（例：仮想通貨 BTCUSDT、個別株 AAPL など）。 |
| kline_type | Integer | K線の時間軸（例：8 は「日足」などの特定のインターバルを指定）。 |
| kline_timestamp_end | Integer | データ取得範囲の終了 Unix タイムスタンプ。 |
| query_kline_num | Integer | 1回のリクエストで取得するK線の本数。 |
| adjust_type | Integer | 株価の修正（権利落落調整など）のタイプ。 |
プロのヒント:
kline_timestamp_endが正しい Unix 形式（秒単位）であることを確認してください。形式が異なると、空のレスポンスや同期エラーの原因となります。
購読プラン別のデータ取得可能期間
取得できる履歴データの深さ（過去に遡れる期間）は、契約している Alltick のプランによって異なります。プロジェクトの要件に合わせて、以下の制限事項を確認してください。
1. 標準マルチアセットプラン
一般的な市場分析や仮想通貨プロジェクトに最適なプランです。
- Free & Basic プラン: 最大 1年間 の履歴データ。
- Premium プラン: 最大 3年間 の履歴データ。
- Professional プラン: 最大 5年間 の履歴データ。
2. 地域別株式プラン（香港/中国/米国）
香港、中国、または米国市場の特定プランを購読している場合、履歴データの深さは通常、直近 500 本分 のK線に限定されます。これは、短期のスイングトレードやデイトレードの分析に十分な量です。
なぜ履歴データの取得に Alltick を選ぶのか？
quote-b-api/kline エンドポイントを利用することで、フィンテック開発者は以下のメリットを享受できます。
- 一貫性: 機関投資家レベルのプラットフォームで使用される高品質なデータにアクセス。
- スケーラビリティ: 無料で開始し、バックテストのニーズに応じて 1 年から 5 年へとシームレスにアップグレード。
- 多機能性: 単一のエンドポイント構造で、FX、仮想通貨、グローバル株式を統合的に管理。
コーディングを始める準備はできましたか？ Alltick ダッシュボードにアクセスして API トークンを取得し、リアルタイムおよび履歴データを今すぐアプリケーションに統合しましょう。
