빌더
빌더 코드
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
코드 유출 후 교체는 신중하게
코드를 교체하면 이전 코드로의 새 귀속이 즉시 중단됩니다. 기존 대기 주문은 체결되거나 취소될 때까지 원래 코드를 유지하므로, 트래픽이 적은 시간에 교체를 계획하십시오.