跳到内容

构建者

开发者代码

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

代码泄露后谨慎轮换

轮换代码立即停止对旧代码的新归因。现有挂单保持其原始代码直至成交或撤销，因此请在低流量窗口期规划轮换。