Polymarket API 문서: 엔드포인트, 레이트 제한 및 사용법
"polymarket api docs"를 검색했다면, Polymarket과 통합하거나 구축할 때 필요한 정확한 엔드포인트, 인증 모델 및 실무 한도를 찾고 있는 것입니다. 아래에는 사용하게 될 세 가지 공개 REST API와 마켓 WebSocket, 주요 매개변수 및 레이트 제한이 정리되어 있습니다. 또한 거래를 위해 CLOB가 요구하는 사항과 PolyArb가 이러한 인터페이스를 활용해 인트라-마켓 차익거래를 발견하는 방법도 다룹니다.
공식 API 엔드포인트 및 인터페이스 맵
Polymarket은 세 개의 공개 REST 인터페이스와 하나의 마켓 WebSocket을 제공합니다. 마켓 및 이벤트용 Gamma API는 https://gamma-api.polymarket.com에 있습니다. 포지션, 거래 및 미결제약정용 Data API는 https://data-api.polymarket.com에 있습니다. 오더북 및 트레이딩용 CLOB API는 https://clob.polymarket.com에 있습니다. 실시간 마켓 소켓은 wss://ws-subscriptions-clob.polymarket.com/ws/market 입니다. 각 인터페이스는 목적이 다릅니다: Gamma는 목록 및 필터용, Data는 히스토리와 온체인 유도 활동용, CLOB는 라이브 오더북 조회와 주문 제출용(조회는 공개; 거래는 API 키 + HMAC 필요)입니다. WebSocket은 연결당 최대 500개 종목에 대해 북 및 가격 변동 이벤트를 스트리밍합니다.
Gamma /markets 매개변수 및 제한
Gamma의 /markets 엔드포인트는 키셋 페이징을 지원합니다: 이전 호출에서 반환된 after_cursor를 사용하세요; offset은 HTTP 422로 거부됩니다. 유용한 쿼리 매개변수로는 limit(최대 1000), slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address, closed, active, archived, order, ascending, tag_id 등이 있습니다. 레이트 제한: /markets는 10초당 300요청으로 제한됩니다; /markets + /events의 결합된 목록 호출은 10초당 900요청으로 제한됩니다. Gamma API 전체 허용량은 10초당 4000요청입니다.
CLOB 및 거래 메커니즘
CLOB는 오더북, Midpoint, 가격 이력, 주문 제출/취소 기능을 노출합니다. 거래에는 API 키와 HMAC이 필요하며 조회는 공개입니다. Polymarket의 틱 사이즈, best_bid_ask 이벤트, 그리고 FAK 마켓 주문 헬퍼는 CLOB와 마켓 WebSocket을 통해 제공됩니다. 메이커 수수료는 0이며 테이커 수수료는 카테고리별로 다릅니다. 거래 에이전트를 구축하는 경우, 어트리뷰션과 빌더 수수료 보상을 위한 Polymarket의 Builder Program을 고려하세요.
PolyArb가 이들 API를 사용하는 방법
PolyArb는 Gamma와 CLOB 오더북을 폴링하고 마켓 WebSocket을 구독하여 Σ bestAsk < $1.00인 인트라-마켓 차익거래 기회를 탐지합니다. 우리 봇은 무료 봇(약 800ms)을 능가하기 위해 저지연 인프라(40ms 플랜)에서 운영되며, $99/month 플랜과 거래당 $7.62 최소 보장 이익을 제공합니다. 우리는 라이브 best_bid_ask 이벤트, CLOB Midpoint, 그리고 Data API 히스토리를 결합해 주문 크기를 결정하고 부분 체결을 피합니다. 일반적인 운영 리스크로는 UMA를 통한 결의 분쟁, 슬리피지, 수수료 변경, 결제 타이밍, 스마트 컨트랙트 리스크가 있습니다.
오늘부터 PolyArb로 Polymarket 차익거래 시작하세요
월 $99 구독으로 40ms 레이턴시, Telegram 및 Discord 알림, 비수탁 실행, 그리고 거래당 $7.62 최소 보장 이익을 받을 수 있습니다.
FAQ
- 공식 Polymarket API 베이스 URL은 어디인가요?
- Gamma: https://gamma-api.polymarket.com; Data: https://data-api.polymarket.com; CLOB: https://clob.polymarket.com; WebSocket: wss://ws-subscriptions-clob.polymarket.com/ws/market.
- 마켓 데이터를 읽으려면 인증이 필요합니까?
- 아니요. Gamma, Data 및 공개 CLOB 엔드포인트의 조회는 인증 없이 가능합니다. CLOB에서 주문을 제출하려면 API 키와 HMAC이 필요합니다.
- /markets의 중요한 레이트 제한은 무엇인가요?
- /markets는 10초당 300요청으로 제한됩니다. /markets와 /events의 결합된 목록 호출은 10초당 900요청으로 제한됩니다. Gamma API 전체 제한은 10초당 4000요청입니다.
- 실시간 오더북 업데이트에 WebSocket을 사용할 수 있나요?
- 예. 마켓 WebSocket은 실시간 북, price_change, best_bid_ask, last_trade_price, tick_size_change 이벤트를 제공합니다. 10초마다 핑을 보내며 연결당 최대 500개 종목을 지원합니다.