銘柄エイリアス
Tradeways の銘柄エイリアスのリファレンス — インポートやライブ同期の際に、Broker 固有の銘柄名がどのように正規銘柄へマッピングされるかを解説します。
銘柄エイリアスは、Broker 固有の銘柄名を Tradeways 内部で使われる正規銘柄へマッピングします。Broker は同じ商品に対して異なる命名規則を使うことがよくあります。たとえば、ある Broker は ESZ5 を送信し、別の Broker は ES.FUT を送信するといった具合です。銘柄エイリアスは、その両方が正規銘柄 ES に解決されることを保証します。
エイリアスは、インポート時および API 取り込み時に自動で作成されます。ユーザーごと、Broker ごと、Broker 口座ごとにスコープが設定されます。
エイリアスが作成される仕組み
Tradeways は受信した約定を処理する際、正規銘柄を特定するために解決チェーンを実行します。
| ステップ | ソース | 説明 |
|---|---|---|
| 1 | ヒント付き銘柄 | Broker が生の銘柄とあわせて正規化済みの銘柄を提供している場合、まずこれがチェックされます。 |
| 2 | 既存のエイリアス | Tradeways は、この銘柄がこの Broker と口座から過去に確認されたことがあるかどうかをチェックします。 |
| 3 | 正規化候補 | 生の銘柄がクリーンアップされ（Broker のプレフィックス、サフィックス、先物の限月コードを除去）、各候補がユーザー商品および組み込みプリセットと照合されます。 |
| 4 | 自動プロビジョニング | API 接続された Broker では、クリーンアップ後の銘柄が既知の Forex または仮想通貨ペアと一致した場合、商品レコードが自動で作成されます。 |
生の銘柄が正常に解決されると、エイリアスレコードが保存されます。これにより、同じ生の銘柄を今後インポートする際には解決チェーンが完全にスキップされます。
エイリアスレコードの構造
各エイリアスは、元の Broker 銘柄を、マッピング先の Tradeways 銘柄とあわせて保存します。エイリアスは Broker と口座にスコープされるため、同じ Broker 銘柄でも口座ごとに異なるマッピングが可能です。
銘柄の正規化
Tradeways は一致を探す際、一般的な Broker のプレフィックス、サフィックス、先物の限月コードを自動で除去します。たとえば、ESZ25 と ES@CME はどちらも ES に解決されます。
手動エイリアスと自動エイリアス
エイリアスは、ファイルインポートまたは API 取り込みの際に生の銘柄が初めて確認されたときに自動で作成されます。また、Broker が自動解決できない銘柄を送信した場合には、設定 UI でエイリアスを手動で作成、編集、削除することもできます。特定の生の銘柄に対する手動エイリアスは、常に自動解決よりも優先されます。
エイリアスが使われる場所
CSV インポートと API インポートはどちらもエイリアスチェーンを通って銘柄を解決します。最初に解決が成功した後はエイリアスが永続化されるため、同じ形式の以降のインポートは即座に解決されます。各約定レコードは元の Broker 銘柄を正規銘柄とあわせて保持するため、いつでも Broker の命名までたどることができます。