트레이딩
거래 가이드
주문 제출, 체결 확인, 포지션 관리. 이 챕터에서는 첫 curl 호출부터 호가 봇 운영까지 SatoriEx 거래의 전 과정을 설명합니다.
기본은 수탁형, 원할 때 온체인
SatoriEx is a custodial CLOB exchange — orders are signed by your session token, not by your wallet, so trades are fast and require no per-trade network gas. On-chain settlement via the CTF bridge is planned. Today, every fill settles on the SatoriEx ledger.
첫 거래, 처음부터 끝까지
REST API로 오더북을 조회한 후 지정가 주문을 제출하세요. 공개 마켓 데이터는 인증이 필요 없지만 주문 제출은 인증이 필요합니다.
# 1) Read the order book
curl https://staging.satoriex.io/api/v1/markets/MKT_ID/orderbook
# 2) Place a limit order (auth required)
# Returns 202 Accepted — order is queued; fills arrive via WebSocket
curl -X POST https://staging.satoriex.io/api/v1/orders \
-H "Authorization: Bearer $SATORIEX_TOKEN" \
-H "Content-Type: application/json" \
-d '{"market_id":"MKT_ID","outcome_id":"OUT_ID","side":1,"price":4200,"quantity":100}'
# side: 1=buy 2=sell | price: BPS (4200 = 42%) | quantity: sharesReplace MKT_ID and OUT_ID with values from /api/v1/markets. Start with small sizes on a low-volume market while you validate your integration.
챕터 탐색
주문 생애주기
제출부터 체결까지: 주문이 거치는 모든 상태와 각각의 의미.
더 보기주문 귀속
빌더 코드로 주문에 태그를 달아 거래량을 통합에 귀속시키세요.
더 보기인증
세션 토큰, OAuth 스코프, 모든 거래 호출에 필요한 헤더.
더 보기주문 취소
단일, 대량, 비상 버튼 취소 패턴 — 취소 불가한 경우 포함.
더 보기포지션
미결 포지션 조회, 조기 청산, 실현 손익 추적.
더 보기수탁형 거래
수탁형 거래가 거래당 서명이 필요 없는 이유와 온체인 비용이 발생하는 경우.
더 보기매칭 엔진
가격-시간 우선순위, 거래 중단, 재시작, 엔진이 강제하는 공정성 규칙.
더 보기자본 효율적 다중 결과
자본 효율적 다중 결과 설계 — 예정, 미출시.
더 보기