跳到內容

建構者

開發者代碼

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.

撮合引擎尚未識別

以下代碼格式和附加方式說明規劃合約。今日提交無害，但在開發者計畫上線前，交易量不會被記入。

代碼的用途

代碼是公開識別碼。它不攜帶任何權限，也不授予任何存取權——遺失代碼令人惱火，但不危險。

  • 每個開發者個人資料發放一次；可申請輪換。
  • 可安全嵌入客戶端程式碼、瀏覽器擴充功能或共用機器人。
  • 純粹用於交易量歸因和排行榜顯示。

如何附加

透過 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 拒絕。
  • 格式正確但未知的代碼會被接受，但不歸因給任何人。

報表查詢

三個端點提供歸因資料。使用它們為您自己的儀表板提供資料，或與平台排行榜進行核對。

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

代碼洩露後的輪換請謹慎

輪換代碼後，舊代碼立即停止接受新歸因。現有掛單將保留原始代碼，直至成交或取消，因此請在低流量時段安排輪換。