エンタープライズ注文
ルーティングAPI
カスタムマッチングエンジンおよび法人ブローカレッジインフラを当社の流動性ルーティングAPI、カスタムチャートAPI、EA自動売買システムWebhookシステムに接続するためのデベロッパーリファレンス。登録済み法人エンティティのみに提供されます。
認証
全てのAPIリクエストにはリクエストヘッダーに法人APIキーを含める必要があります。キーは確認済み法人エンティティのみに発行され、環境（サンドボックスおよび本番）ごとにスコープされます。クライアントポータルからクレデンシャルをローテーションしてください。クライアントサイドのコードにキーを埋め込まないでください。
レート制限
レート制限はAPIゲートウェイレベルで法人エンティティごとに適用されます。WebSocketストリーミング接続はリクエストごとの制限の対象外ですが、サービス契約で定義されたメッセージスループットクォータに準拠します。制限を超えると429 Too Many RequestsがRetry-Afterヘッダーとともに返されます。
| エンドポイントグループ | メソッド | 制限 | ウィンドウ |
|---|---|---|---|
| /v2/order/route | POST | 1,000 req | 毎秒 |
| /v2/chart/ohlcv | GET | 500 req | 毎分 |
| /v2/stream/tick | WS | 無制限 | スループットSLA |
| /v2/webhook/register | POST | 100 req | 毎時 |
| /v2/account/* | GET | 300 req | 毎分 |
流動性ルーティングAPI
流動性ルーティングAPIは、カスタムマッチングエンジンと当社のB2B流動性ソリューションネットワーク間のエンタープライズ注文ルーティング接続を提供します。全ての注文フローはFIX 4.4およびFIX 5.0対応ゲートウェイを通じて処理され、リアルタイムの執行確認およびフィル更新のための並列WebSocketストリーミングも利用可能です。
概要
POSTで/v2/order/routeに注文を送信してください。ルーティングエンジンは銘柄、サイズ、現在のプロバイダー可用性に基づいて最適な流動性ティアを解決します。レスポンスには該当する場合の執行確認および部分フィルデータが含まれます。
ルーティングティア
- Tier 1 — プライマリ機関投資家LPプール、最狭スプレッド、最高約定確率
- Tier 2 — セカンダリ集約プール、Tier 1リジェクト時のフォールバック
- Tier 3 — ラストルックプロバイダー、大口ブロック注文専用
FIXプロトコル
FIX 4.4およびFIX 5.0セッションは法人クライアントごとに専用セッションID、ハートビート設定、シーケンス番号管理でプロビジョニングされます。FIXセッションのプロビジョニングはエンタープライズ営業にお問い合わせください。
WebSocketストリーム
法人APIキーでリアルタイム執行イベントを受信するにはwss://stream.asmlink.com/v2/executionsに接続してください。フィル、部分フィル、リジェクト、キャンセル時にイベントがプッシュされます。
{ "order_id": "ORD-20240815-00421", "symbol": "EURUSD", "side": "BUY", "quantity": 5000000, "order_type": "MARKET", "routing_tier": "TIER_1", "account_id": "CORP-ENT-0042", "timestamp_utc": "2024-08-15T09:31:04.882Z" }
{ "order_id": "ORD-20240815-00421", "status": "FILLED", "fill_price": 1.08423, "fill_quantity": 5000000, "liquidity_provider": "LP-TIER1-03", "routing_tier": "TIER_1", "execution_latency_ms": 0.31, "slippage_pips": 0.0, "timestamp_fill_utc": "2024-08-15T09:31:04.913Z", "account_id": "CORP-ENT-0042" }
カスタムチャートAPI
カスタムチャートAPIは、ホワイトラベルプラットフォームビルドに組み込まれた金融チャートソフトウェアおよびB2B取引チャート向けの統合エンドポイントを提供します。OHLCVデータエンドポイントは全対応銘柄・時間足にわたる過去データおよびストリーミングローソク足データを配信し、一般的なテクニカル分析のインジケーターオーバーレイをサポートします。
データエンドポイント
/v2/chart/ohlcv経由で過去のOHLCVデータをリクエストできます。ティック、M1からMNの時間足をサポートします。タイムスタンプパラメータはUnixエポック（ミリ秒）またはISO 8601を受け付けます。
ティックストリーミング
B2B取引チャート向けのライブティックデータをWebSocketエンドポイントwss://stream.asmlink.com/v2/ticks経由でサブスクライブできます。接続時にsymbolおよびdepthフィールドを含むJSONサブスクリプションフレームを送信してください。
インジケーターオーバーレイ
OHLCVリクエストボディにinclude_indicatorsを渡してサーバーサイドで計算されたインジケーターをリクエストできます。対応：SMA, EMA, RSI, MACD, Bollinger Bands, ATR, VWAP。
マルチ時間足
timeframes配列フィールドを使用して複数の時間足にわたるバッチリクエストを1回の呼び出しで実行できます。レスポンスは時間足ごとにキーを持つオブジェクトを返します。
{ "symbol": "XAUUSD", "timeframe": "H1", "from_timestamp": 1723680000000, "to_timestamp": 1723766400000, "include_indicators": ["EMA_20", "RSI_14", "ATR_14"], "price_type": "BID", "account_id": "CORP-ENT-0042" }
{ "symbol": "XAUUSD", "timeframe": "H1", "candle_count": 24, "candles": [ { "t": 1723680000000, "open": 2490.12, "high": 2497.88, "low": 2487.44, "close": 2494.60, "volume": 18420, "ema_20": 2489.33, "rsi_14": 61.4, "atr_14": 8.21 } ], // ... remaining candles truncated }
自動化システムとWebhooks
当社のWebhookシステムはEA自動売買システムインフラにリアルタイムの執行イベント通知を配信します。/v2/webhook/register経由でエンドポイントURLを登録し、注文フィル、リジェクト、マージンコール、システムアラートを網羅するイベントタイプをサブスクライブしてください。全Webhookペイロードは法人シークレットキーを使用してHMAC-SHA256で署名されます。
Webhookは最大5回の配信試行にわたる指数バックオフを備えた設定可能なリトライロジックをサポートします。配信失敗はクライアントポータルに完全なペイロードインスペクションとともにログされます。イベントタイプは高スループットデプロイメントのノイズを低減するために登録時にフィルタリングできます。
イベントタイプ
order.filled— 完全または部分フィルの確認order.rejected— LPまたはリスクエンジンによる注文リジェクトorder.cancelled— クライアント起動またはシステムキャンセルmargin.call— アカウントマージン閾値超過margin.liquidation— 強制清算の執行system.alert— インフラまたは接続イベント
リトライロジック
配信失敗は5秒、30秒、2分、10分、30分間隔でリトライされます。5回の失敗後、イベントはDELIVERY_FAILEDとしてマークされ、手動リプレイのためにキューイングされます。
署名確認
X-CM-SignatureヘッダーをHMAC-SHA256(secret, raw_body)に対して検証してください。署名が一致しないペイロードはリジェクトしてください。
冪等性
各ペイロードには一意のevent_idが含まれます。リトライされた配信を安全に重複排除するために処理済みIDを保存してください。
{ "event_id": "evt_8f3a91c4d02e", "event_type": "order.filled", "timestamp_utc": "2024-08-15T09:31:04.913Z", "account_id": "CORP-ENT-0042", "order_id": "ORD-20240815-00421", "symbol": "EURUSD", "side": "BUY", "execution_status": "FILLED", "fill_price": 1.08423, "fill_quantity": 5000000, "latency_ms": 0.31, "routing_tier": "TIER_1", "delivery_attempt": 1, "signature_header": "X-CM-Signature", "idempotent": true }
{ "url": "https://your-system.example.com/hooks/cm", "events": [ "order.filled", "order.rejected", "margin.call" ], "secret": "whs_your_hmac_secret_here", "account_id": "CORP-ENT-0042" }
環境
2つの隔離された環境が利用可能です。サンドボックス環境は本番環境と完全なAPIパリティを提供しますが、シミュレートされた流動性に対して動作します。サンドボックスキーにはcm_test_のプレフィックスが付き、執行手数料は発生しません。本番環境では法人オンボーディングの完了が必要です。
フルパリティサンドボックス環境で流動性ルーティングAPI、カスタムチャートAPI、Webhookシステムをテストできます。登録済み法人エンティティのみ利用可能です。