POSTfinance-external-futures-price
海外先物相場
海外先物相場
導入ドキュメント
インターフェースの紹介
このインターフェースは、主流の外部先物品種のリアルタイム相場データを提供します。特定の先物商品コード(シンボル)を渡すことで、最新の価格、売買注文、出来高、建玉、増減などの主要な市場フィールドを取得できます。このデータは、国際商品や金融デリバティブの価格を監視する必要があるビジネスシナリオに適しています。
該当するシナリオ
- 金融情報プラットフォーム: 国際先物市場のリアルタイムのダイナミクスと市場動向を表示します。
- 定量的取引支援: 戦略モデルに基本的な価格と出来高のデータ入力を提供します。
- 企業リスク管理: 原材料 (原油、金属、農産物など) の国際価格変動を監視します。
- 個人投資ツール: 市場読み取りソフトウェアまたは価格警告通知サービスを開発します。
リクエストと返品の手順
- リクエスト方法: POST
- 主要パラメータ:
symbol(必須)、先物商品コードです。有効な値を入力するには、公式のコード表を参照する必要があります。 - 戻り構造:
code/msg: インターフェイスのステータス コードと説明。200 は成功を意味します。data: 特定の市場データを含むオブジェクト。価格: 最新のリアルタイム価格。bid/ask: 買値と売値。volume/hold: 取引高と建玉。change/changeRate: 増減量と増減率。update_time: データ更新のタイムスタンプ。
提案へのアクセス
- コード マッピング: 無効なコードによるクエリの失敗を避けるために、有効な「シンボル」コード テーブルを必ず維持してください。
- 頻度制御: リアルタイムの市場データは頻繁に更新されます。高頻度の無効なリクエストを回避するために、実際のビジネス ニーズに基づいて適切なポーリング間隔を設定することをお勧めします。
- データ検証: 返されたデータを解析するときは、「コード」フィールドをチェックしてリクエストが成功したことを確認し、ネットワーク例外またはタイムアウトの処理に注意してください。
- タイム ゾーンに関する注意:
update_timeはタイムスタンプ形式であり、フロントエンドに表示されるときにユーザーのローカル タイム ゾーンに変換する必要があります。
実装サンプルコード
Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。
リクエスト例
{
"symbol": "期货品种代码,详见代码表"
}レスポンス例
{
"msg": "成功",
"code": 200,
"taskNo": "883993816152322760914592",
"data": {
"change": "5.0300",
"ask_vol": "3",
"bid_vol": "10",
"hold": "249261.000",
"volume": "5347",
"high": "312.800",
"update_time": 1721629440,
"low": "307.600",
"price": "312.530",
"name": "美黄豆粉",
"ask": "312.600",
"changeRate": "1.6358",
"preclose": "307.500",
"bid": "312.500",
"open": "307.600"
}
}リクエスト項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.symbol | object | {...} |
| properties.symbol.type | string | string |
| properties.symbol.description | string | 期货品种代码,详见代码表 |
| required | array | "symbol" |
| required[] | string | symbol |
レスポンス項目
以下の項目はサンプル 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 | {...} |