クォート取得(バッチ)
read-only · idempotent
複数シンボルの現在価格を 1 回の呼び出しで取得します。
get_quote のバッチ版で、最大 50 シンボルのクォートを一度に返します。 複数のポジションやウォッチリストの価格を確認する際に、往復回数を削減できます。
各シンボルは独立して解決されます。QUOTE セッションが利用可能であればライブのビッド/アスクを、 そうでなければ TRADE セッションの最終約定価格にフォールバックします。失敗したシンボルは errors 配列で報告され、成功したシンボルの処理を妨げません。
パラメータ:
- symbols: シンボル名の配列(例: [“EURUSD”, “XAUUSD”, “GBPUSD”])
- 1 リクエストにつき 1〜50 シンボル
- get_quote の symbol パラメータと同じ形式
レスポンスフィールド:
- quotes: クォートオブジェクトの配列(シンボルごとに get_quote と同じフィールド)
- errors: 価格データのないシンボルの { symbol, error } 配列
- count: 成功したクォートの数
- errorCount: 失敗したシンボルの数
使用方法:
- ループで get_quote を N 回呼び出す代わりに使用してください
- ライブ価格が必要な場合は、まず subscribe_quotes を呼び出してください
- errors 配列を確認して、購読が必要なシンボルを特定してください
これは読み取り専用の操作であり、リスクチェックはありません。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
symbols | string | はい | クォートを取得するシンボルの配列(例: [‘EURUSD’, ‘XAUUSD’]) |