Builder

Kode builder

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.

Belum dihormati oleh mesin pencocokan

Format kode dan pola lampiran di bawah menjelaskan kontrak yang direncanakan. Mengirimkannya hari ini tidak berbahaya tetapi volume tidak akan dikreditkan sampai program builder aktif.

Apa itu kode

Kodenya adalah pengenal publik. Tidak memiliki izin dan tidak memberikan akses — kehilangan satu itu menjengkelkan tapi tidak berbahaya.

Diterbitkan sekali per profil builder; Anda dapat merotasinya berdasarkan permintaan.
Aman untuk disematkan dalam kode sisi klien, ekstensi browser, atau bot bersama.
Digunakan murni untuk atribusi volume dan tampilan papan peringkat.

Cara melampirkan

Kirim kode dalam header X-Builder-Code (lebih disarankan) atau body order. Keduanya mencapai mesin pencocokan; formulir header lebih ramah untuk rantai proxy.

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
}

Jika kedua formulir ada dan tidak sesuai, nilai body yang menang. Pilih satu dan tetap konsisten.

Format & aturan

Kodenya pendek, berprefiks, dan peka huruf besar/kecil. Validasi berjalan sebelum mesin pencocokan.

Prefiks BLD_ diikuti 12 karakter alfanumerik huruf kecil.
Peka huruf besar/kecil — BLD_aBcDef… tidak sama dengan BLD_abcdef….
Kode tidak valid ditolak dengan BUILDER_CODE_INVALID sebelum order diterima.
Kode yang tidak diketahui tetapi berformat baik diterima tetapi tidak diatribusikan kepada siapa pun.

Pelaporan

Tiga endpoint mengekspos data atribusi. Gunakan untuk menggerakkan dasbor Anda sendiri atau untuk merekonsiliasi terhadap papan peringkat platform.

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

Rotasikan setelah kebocoran kode dengan hati-hati

Merotasi kode menghentikan atribusi baru ke yang lama segera. Order yang menunggu membawa kode aslinya hingga terisi atau dibatalkan, jadi rencanakan rotasi selama jendela aliran rendah.