導入ドキュメント
インターフェースの紹介
このインターフェイスは、香港株式市場の個別銘柄に対する K-line 市場データ クエリ サービスを提供します。開発者は、銘柄コードと指定した期間タイプを渡すことにより、対応する期間内の始値、終値、最高値、最低価格、取引高、取引額などの主要な取引データを取得できます。データは1分足の高頻度から年線までの長期次元をカバーしており、財務チャートや定量分析の基礎の構築に適しています。
該当するシナリオ
- 金融端末開発: 株式取引ソフトウェアまたは情報APPに香港株式トレンドチャートデータサポートを提供します。
- 定量的戦略バックテスト: テクニカル指標の計算と戦略検証のために過去の複数期間の K ライン データを取得します。
- 投資分析ツール: 投資家が短期的な変動を監視したり、長期的な傾向を分析および判断したりするのを支援します。
- データ視覚化画面: 主要な香港株の価格変動と取引活動をリアルタイムに表示します。
リクエストと返品の手順
リクエスト方法: POST 主要なパラメータ:
シンボル(必須): 香港在庫商品コード、たとえば08026。type(必須): K ライン サイクル タイプ。1(1分)、5(5分)、15、30、60、120、240(日単位K)、1200(週単位K)、7200(月単位K)、21600(四半期K)、43200(半年K)、86400(K年)。limit(オプション): データ項目の数を返します。デフォルトは 10 です。
結果を返す: このインターフェイスは標準の JSON 構造を返し、主なデータは data.list 配列にあります。各レコードには次の内容が含まれます。
day: データ時点open/close: 始値と終値high/low: 最高価格と最低価格volume: 取引量amount: 取引金額
注: 「code」フィールドはビジネス ステータス コードです。200 は成功を意味し、HTTP ステータス コードと等しくありません。
提案へのアクセス
- 期間の選択: ビジネス ニーズに応じて、適切な
type値を選択します。高頻度の取引シナリオには分単位のデータを使用することをお勧めします。傾向分析には日次 K または週次 K を使用することをお勧めします。 - エラー処理: 戻り値の本文の
codeフィールドを必ず確認してください。値が 200 の場合にのみdataコンテンツを解析します。それ以外の場合は、例外プロンプトのmsgを読んでください。 - キャッシュ戦略: 履歴 K ライン データの変更頻度が低くなります。 API 呼び出しコストを削減するために、非リアルタイムのサイクル データを適切にキャッシュすることをお勧めします。リアルタイムの分行はオンデマンドでリクエストすることをお勧めします。
実装サンプルコード
Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。
リクエスト例
{
"symbol": "品种代码,如:08026",
"type": "k线类型, 1:1分钟,5:五分钟;15:15分钟;30:30分钟,60:60分钟,120:120分钟,240:日K,1200:周K,7200:月K,21600...",
"limit": "返回条数,默认10"
}レスポンス例
{
"msg": "成功",
"code": 200,
"taskNo": "202960247220113090298671",
"data": {
"list": [
{
"volume": "6000",
"high": "0.25000",
"amount": "1284",
"low": "0.20000",
"day": "2024-04-18 11:00:00",
"close": "0.25000",
"open": "0.20000"
}
]
}
}リクエスト項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.symbol | object | {...} |
| properties.symbol.type | string | string |
| properties.symbol.description | string | 品种代码,如:08026 |
| properties.type | object | {...} |
| properties.type.type | string | string |
レスポンス項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.msg | object | {...} |
| properties.msg.type | string | string |
| properties.msg.example | string | 成功 |
| properties.msg.description | string | 接口返回码对应的描述信息 |
| properties.code | object | {...} |