A株APIでリアルタイム相場を取得する方法：REST APIの接続とデータ処理ガイド
A株APIを使って最新の株価情報を取得する方法を解説します。REST APIの接続、Pythonによるリクエスト、相場データの処理、REST APIとWebSocketの使い分けを紹介します。
株価情報ダッシュボードを開発する際、1銘柄の価格を取得することは最初のステップにすぎません。実際には、APIから返されるデータが対象銘柄に対応しているか、相場データの時刻が信頼できるか、そして画面に価格変動が適切に反映されるかを考慮する必要があります。
金融テクノロジーの開発者にとって、適切なA株APIを選択することで、相場データの収集基盤を自ら構築・管理する負担を軽減できます。この記事では、実際の開発ニーズに基づき、REST APIを使用して中国A株の最新気配値を取得する方法、レスポンスデータの処理方法、および更新頻度に応じた接続方式の選び方を解説します。
リアルタイム相場を取得する前に、適切なAPIを選ぶ
A株の相場アプリケーションでは、通常、最新気配値と過去のローソク足データという2種類のデータが必要です。
最新気配値は、現在価格、出来高、取引時刻などの情報を表示するのに適しています。一方、過去のローソク足データは、チャートの描画、テクニカル指標の計算、初期表示用の履歴チャートの作成などに使用されます。用途が異なるため、最新気配値の取得を過去のローソク足データの取得で代用することはできません。
AllTickは、中国A株、香港株、米国株向けの株式相場APIを提供しています。REST APIには、最新気配値、過去のローソク足、板情報、銘柄の基本情報などを取得するためのインターフェースが用意されています。必要なときに相場を照会するアプリケーションであれば、REST APIから導入できます。相場の変化を継続的に受信する必要がある場合は、WebSocketによる購読も検討します。
PythonでA株の相場データを取得する
接続する前に、API Keyを取得し、対象銘柄のコードがAllTickの対応銘柄リストに含まれていることを確認してください。A株の銘柄コードには取引所のサフィックスが使用されます。例えば、600416.SHは上海証券取引所の銘柄、000627.SZは深圳証券取引所の銘柄を表します。
最新気配値を取得する場合は、過去のローソク足データ用インターフェースではなく、/v1/quote/{queryData}を使用します。AllTickの新しいREST APIでは、X-API-Keyリクエストヘッダーによって認証を行います。また、GETリクエストのクエリパラメータは、ドキュメントで指定された方法に従ってエンコードする必要があります。
以下のPythonコードでは、まずリクエストパラメータを構成し、過去のローソク足データ用インターフェースを呼び出して、データ接続の流れを確認する方法を示します。
import json
import os
import requests
API_KEY = os.environ["ALLTICK_API_KEY"]
query_data = {
"trace": "ashare-kline-001",
"data": {
"code": "600416.SH",
"kline_type": 1,
"kline_timestamp_end": 0,
"query_kline_num": 2,
"adjust_type": 0
}
}
url = "https://quote.alltick.co/quote-stock-b-api/v1/kline"
response = requests.get(
url,
params={
"query": json.dumps(query_data, separators=(",", ":"))
},
headers={"X-API-Key": API_KEY},
timeout=10
)
response.raise_for_status()
result = response.json()
if result.get("ret") != 200:
raise RuntimeError(f"API error: {result.get('msg')}")
print(result["data"])このコードは、直近の1分足ローソクを2本取得し、リクエスト、認証、レスポンス解析の流れを確認するためのものです。リアルタイムの最新気配値を取得するコードではなく、気配値取得用インターフェースの検証に代わるものでもありません。実際に接続する際は、最新のREST APIドキュメントに従って気配値取得用インターフェースのリクエストパラメータを設定し、返されるフィールドが業務要件に合っていることを確認してください。
相場データを処理する際に確認すべきポイント
APIからデータを受信した後、すべてのフィールドをそのままフロントエンドに渡すべきではありません。少なくとも、次の3点を処理する必要があります。
相場データの時刻と受信時刻を区別する。 相場データの時刻は市場イベントが発生した時刻を示し、受信時刻はアプリケーションがデータを取得した時刻を示します。両方を記録することで、APIレスポンス、ネットワーク転送、フロントエンド更新の各段階で発生した遅延を調査しやすくなります。
古いデータで新しいデータを上書きしない。 システムが複数のリクエストを同時に処理する場合、レスポンスの到着順序がリクエストの送信順序と異なることがあります。キャッシュを更新する際は、利用可能な相場時刻やデータ識別情報に基づいて更新ルールを設計し、単純に最後に到着したレスポンスで現在の値を上書きしないようにします。
更新がないことをAPI障害と誤認しない。 中国A株市場には、集合競売、連続競売、昼休みなどの取引時間帯があります。取引時間外に新しい約定が発生しなければ、最新約定データが長時間変化しないことがあります。異常かどうかを判断する際は、取引カレンダー、相場データのタイムスタンプ、APIの状態、エラーメッセージを組み合わせて確認します。
また、最新気配値取得用インターフェースでは、最新約定価格、出来高、売買代金、約定時刻、売買方向などのデータを取得できます。ただし、過去のTickデータを取得するためのインターフェースではありません。戦略研究で過去のTickデータを完全な形で利用する必要がある場合は、該当する製品とインターフェースがその要件に対応しているか、事前に確認してください。
REST APIとWebSocketのどちらを選ぶべきか
どちらを選ぶかは、相場データの更新要件によって決まります。どちらか一方が常に優れているわけではありません。
- REST API： 画面の初期化、必要なときの最新気配値の照会、過去のローソク足の読み込み、リクエスト頻度が低い相場ダッシュボードに適しています。
- WebSocket： 相場データの更新を継続的に受信するアプリケーションに適しています。HTTPリクエストを繰り返し送信する負担を軽減できますが、接続切断、再購読、データ復旧などへの対応が必要です。
少数の銘柄を表示するアプリケーションであれば、まずREST APIでデータ接続を完成させる方法が考えられます。多数の銘柄を継続的に更新する必要がある場合は、WebSocket購読とローカルキャッシュの導入を検討します。いずれの方式でも、プランごとのリクエスト制限、対応銘柄の範囲、実際の更新要件を踏まえて検証する必要があります。
業務に適したA株データAPIを選ぶ方法
APIを選ぶ際は、価格だけでなく、対象銘柄がサポートされているか、必要な相場データを取得できるか、過去データの提供範囲は十分か、そしてリクエスト頻度が業務規模に合っているかを確認してください。
AllTickの株式相場API製品ページでは、中国A株、香港株、米国株向けの相場データ機能が紹介されています。また、開発者はREST APIドキュメントで、リクエストパラメータ、認証方法、レスポンス構造を確認できます。
A株リアルタイム相場APIを探している開発者には、まず少数の対象銘柄を選び、最新気配値、相場時刻、異常レスポンスを検証してから、キャッシュやWebSocket購読を段階的に導入することをおすすめします。これにより、データ経路の問題を早期に発見し、インターフェースの検証が完了する前に複雑なシステムを構築してしまうリスクを減らせます。
なお、AllTickが提供する相場データは情報提供を目的とするものであり、取引や投資に関する助言として直接扱うべきではありません。利用前に、適用されるデータ利用許諾および再配信の制限についても確認してください。