Mã nhà phát triển

Mã là gì

Mã là định danh công khai. Nó không mang quyền và không cấp quyền truy cập — mất một cái thật phiền nhưng không nguy hiểm.

• Được cấp một lần cho mỗi hồ sơ nhà phát triển; bạn có thể xoay vòng theo yêu cầu.
• An toàn để nhúng vào code phía client, tiện ích mở rộng trình duyệt hoặc bot chia sẻ.
• Chỉ dùng cho phân bổ khối lượng và hiển thị bảng xếp hạng.

Cách đính kèm

Gửi mã trong header X-Builder-Code (ưu tiên) hoặc nội dung lệnh. Cả hai đều đến công cụ khớp; dạng header thân thiện hơn với chuỗi 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
}

Nếu cả hai dạng cùng có và không đồng nhất, giá trị nội dung thắng. Chọn một cái và nhất quán.

Định dạng & quy tắc

Mã ngắn, có tiền tố và phân biệt hoa thường. Xác thực chạy trước công cụ khớp.

• Tiền tố BLD_ theo sau là 12 ký tự chữ thường và số.
• Phân biệt hoa thường — BLD_aBcDef… không giống BLD_abcdef….
• Mã không hợp lệ bị từ chối với BUILDER_CODE_INVALID trước khi lệnh được chấp nhận.
• Mã chưa biết nhưng đúng định dạng được chấp nhận nhưng không được phân bổ cho ai.

Báo cáo

Ba endpoint hiển thị dữ liệu phân bổ. Sử dụng để cung cấp dữ liệu cho bảng điều khiển của bạn hoặc đối chiếu với bảng xếp hạng của nền tảng.

GET /api/v1/builders/me/volume?range=7d
GET /api/v1/builders/me/trades?cursor=...
GET /api/v1/builders/leaderboard?range=30d