Skip to content

Builders

Builder code

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.

Not yet honored by the matcher

The code formats and attachment patterns below describe the planned contract. Sending them today is harmless but volume will not be credited until the builder program goes live.

What the code is

The code is a public identifier. It carries no permission and grants no access โ€” losing one is annoying but not dangerous.

  • Issued once per builder profile; you can rotate it on request.
  • Safe to embed in client-side code, browser extensions, or shared bots.
  • Used purely for volume attribution and leaderboard display.

How to attach

Send the code in either the X-Builder-Code header (preferred) or the order body. Both reach the matcher; the header form is friendlier to proxy chains.

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
}

If both forms are present and disagree, the body value wins. Pick one and stay consistent.

Format & rules

The code is short, prefixed, and case-sensitive. Validation runs before the matcher.

  • Prefix BLD_ followed by 12 lowercase alphanumeric characters.
  • Case-sensitive โ€” BLD_aBcDefโ€ฆ is not the same as BLD_abcdefโ€ฆ.
  • Invalid codes are rejected with BUILDER_CODE_INVALID before the order is accepted.
  • Unknown but well-formed codes are accepted but attributed to no one.

Reporting

Three endpoints expose attribution data. Use them to power your own dashboards or to reconcile against the platform's leaderboard.

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

Rotate after a code leak with caution

Rotating a code stops new attribution to the old one immediately. Existing rests carry their original code until they fill or cancel, so plan rotations during low-flow windows.