コンテンツへスキップ

ビルダー

ビルダーコード

Planned

Your builder code is an opaque attribution token tied to your builder profile. Order-attribution is live; the fee-share program that converts attributed volume into payouts is planned and not yet active. Sending the code today is harmless and forward-compatible.

マッチャーによってまだ処理されていません

以下のコードフォーマットと添付パターンは計画中の仕様を説明します。今日送信しても害はありませんが、ビルダープログラムが稼働するまでボリュームはクレジットされません。

コードとは何か

コードは公開識別子です。権限を持たず、アクセスを許可しません — 紛失しても面倒ですが危険ではありません。

  • ビルダープロフィールごとに1回発行されます。リクエストでローテーションできます。
  • クライアントサイドコード、ブラウザ拡張、共有ボットに安全に埋め込めます。
  • 純粋にボリュームアトリビューションとリーダーボード表示に使用されます。

添付方法

X-Builder-Codeヘッダー（推奨）または注文ボディのどちらかでコードを送信します。どちらもマッチャーに届きます。ヘッダー形式はプロキシチェーンに親和性があります。

POST /api/v1/orders
Authorization: Bearer $SATORIEX_TOKEN
X-Builder-Code: BLD_abcdef123                # <- header form, preferred
Content-Type: application/json

{
  "market_id": "MKT_ID",
  "outcome_id": "OUT_ID",
  "side": "buy",
  "type": "limit",
  "price": 0.42,
  "size": 100,
  "builder_code": "BLD_abcdef123"            # <- body form, optional
}

両方の形式が存在して値が異なる場合、ボディの値が優先されます。一方を選択して一貫性を保ってください。

フォーマットとルール

コードは短く、プレフィックス付きで、大文字小文字を区別します。バリデーションはマッチャーの前に実行されます。

  • プレフィックスBLD_の後に12文字の小文字英数字。
  • 大文字小文字を区別します — BLD_aBcDef…はBLD_abcdef…と同じではありません。
  • 無効なコードは注文が受理される前にBUILDER_CODE_INVALIDで拒否されます。
  • 不明でも形式が正しいコードは受理されますが、誰にもアトリビュートされません。

レポーティング

3つのエンドポイントがアトリビューションデータを公開します。自分のダッシュボードを動かすか、プラットフォームのリーダーボードと照合するために使用してください。

Not yet availableThese endpoints are not yet live. Check /docs/changelog for availability updates.
GET /api/v1/builders/me/volume?range=7d
GET /api/v1/builders/me/trades?cursor=...
GET /api/v1/builders/leaderboard?range=30d

コード漏洩後のローテーションは慎重に

コードをローテーションすると古いコードへの新規アトリビューションは直ちに停止します。既存の待機注文は約定またはキャンセルされるまで元のコードを持ちます。フロー低下期間にローテーションを計画してください。