コンテンツへスキップ

トレーディング

注文アトリビューション

Planned

注文アトリビューションは送信する全ての注文にビルダー識別子をタグ付けします。SatoriExはこれらのタグを使って、取引を生み出した統合にボリュームをクレジットします。

アトリビューション配線はまだ稼働していません

以下の`X-Builder-Code`ヘッダーと`builder_code`ボディフィールドは計画中の仕様を説明します。注文マッチャーはまだどちらも読み取っていません — 送信しても構いませんが、プログラムがリリースされるまでボリュームはクレジットされません。アクティベーション日はchangelogをご覧ください。

クレジットされるもの

タグ付き注文は、あなたのサーフェスで誰が取引ボタンをクリックしたかに関わらず、ビルダーボリュームに貢献します。

  • 約定ボリューム — ティア閾値と手数料シェア計算にカウントされます。
  • 取引件数 — ビルダーダッシュボードと公開リーダーボードに表示されます。
  • ユーザーコホート — 登録時にタグ付けされた紹介ユーザーと取引時にタグ付けされた注文。

注文にタグを付ける方法

ビルダーコードをX-Builder-Codeヘッダー(推奨)または注文ボディに含めて送信します。ヘッダー形式はプロキシを経由しても維持されます。ボディ形式はカスタムヘッダーを設定できないクライアントに便利です。

POST /api/v1/orders
Authorization: Bearer $SATORIEX_TOKEN
Content-Type: application/json

{
  "market_id": "MKT_ID",
  "outcome_id": "OUT_ID",
  "side": 1,
  "price": 4200,
  "quantity": 100
}

// side: 1 = buy, 2 = sell (int8)
// price: basis points where 10000 = 100% probability ($1.00), e.g. 4200 = 42%
// quantity: number of shares (integer)

両方の形式が存在して値が異なる場合、ボディの値が優先されます。混乱を避けるためどちらか一方のみ使用してください。

Prices are in basis points (BPS) where 10000 = 100% probability ($1.00). Quantities are in shares (integer units).

ルール

  • タグは注文が受理されると変更不可です — 待機注文を再タグ付けすることはできません。
  • 自己取引(自分のリテールユーザーが自分の待機注文に対して取引)は拒否され、クレジットされません。
  • 疑わしいボリューム — ウォッシュパターン、循環取引 — はティア計算から除外されます。
  • ビルダーコードのない注文は通常の注文です。何も壊れません。

スケールアップ前にアトリビューションをテストしてください

ステージングで小さなタグ付き注文を出し、SatoriExへの本番トラフィックを向ける前に/api/v1/builders/me/volumeに表示されることを確認してください。