国内先物契約

インターフェースの紹介

このインターフェースは、国内先物市場（内部市場）契約に関する基本的な情報照会サービスを提供します。開発者は、契約コードと完全な中国名 (「上海原油 2407」など) を含む標準の先物品種コード (シンボル) を渡すことで、対応する契約リストを取得できます。データは Alibaba Cloud Market のアップストリーム サービスから取得され、標準化された先物商品の識別を必要とするビジネス システムに適しています。

該当するシナリオ

• 金融端末開発: 取引ソフトウェアまたは市場システムで標準化された契約名を表示します。
• データ クリーニングとマッピング: 内部システムの短縮コードを中国語の汎用契約名に変換します。
• 定量的戦略バックテスト: 戦略を構築するときに、過去の契約のコードと名前の対応を自動的に照合します。
• 情報集約プラットフォーム: 表示される先物品種の名前が国内市場の規制に準拠していることを確認します。

リクエストと返品の手順

リクエスト方法: POST リクエストパラメータ:

• symbol (必須、文字列): 先物商品コード。「SC0」などの公式またはアップストリームのコード表を参照してください。

結果を返す:

• code (数字): ステータス コード、200 は成功を意味します。
• msg (文字列): ステータスの説明。
• taskNo (文字列): このリクエストの一意の追跡番号。
• data.list (配列): 契約リストの配列。
• シンボル (文字列): 契約コード。
• name (文字列): 種類、交換、満了月の情報を含む、契約の中国語名。

提案へのアクセス

1. コードの標準化: 渡される「シンボル」がアップストリームによって定義された形式に厳密に準拠し、大文字と小文字が区別されることを確認してください。そうでない場合、クエリが空になる可能性があります。
2. キャッシュ戦略: 先物契約リストの変更頻度は低くなります (主に月が変わるか、新しい契約が開始されるとき)。 API 呼び出しの数を減らし、応答速度を向上させるために、返された結果をローカルにキャッシュする (TTL を 24 時間に設定するなど) ことをお勧めします。
3. 例外処理: 返された「コード」フィールドを必ず確認してください。ステータス コードが 200 でない場合は、ログの msg プロンプトまたはユーザー プロンプトに従って、「data」の直接解析によって引き起こされるヌル ポインタ例外を回避してください。