Polymarket 데이터 API
Polymarket 호가 데이터를 위한 깔끔한 단일 API: 과거 데이터는 단일 Bearer 키로 REST 위의 일반 JSON으로, 현재 데이터는 실시간 WebSocket 스트림으로 제공합니다. 둘 다 동일한 스냅샷 객체를 내보내므로, 백테스트용으로 작성한 코드가 실시간 피드도 그대로 읽습니다.
DepthFeed Polymarket 데이터 API는 오더북 호가와 가격 데이터를 HTTPS 위의 일반 JSON으로 제공합니다. 미터링되는 REST API가 단일 Bearer 키로 마켓 탐색, 메타데이터, 풀뎁스 과거/최신 스냅샷을 반환하고, WebSocket 스트림이 동일한 객체를 실시간으로 푸시합니다. SDK가 필요 없어 function-calling과 MCP 방식 에이전트 도구를 포함해 어떤 스택에도 그대로 들어갑니다.
한눈에 보는 Polymarket 데이터 API
- 프로토콜
- JSON over HTTPS — REST + WebSocket
- 인증
- Bearer / X-API-Key (또는 WS에서는 ?api_key=)
- 탐색
- 마켓 → 스냅샷 → 실시간 /v3/stream
- 에이전트 친화
- SDK 불필요; MCP / function-calling 친화
- 자산
- 7종 — BTC · ETH · SOL · XRP · DOGE · BNB · HYPE
- 타임스탬프
- 스냅샷별 거래소·수신 Epoch-ms
- 기초 가격
- Binance 현물/선물, 스냅샷별로 조인
- 히스토리
- 7/30/90일 윈도우 + 전체 아카이브(Desk)
- 전송
- REST API + 실시간 WebSocket, 동일한 JSON
- 해상도
- 모든 변동, 또는 ?interval= 30s–1d 다운샘플
이 API가 제공하는 것
과거 데이터는 REST, 실시간은 WebSocket — 하나의 JSON 형태
먼저 마켓을 탐색한 뒤 REST API로 원하는 마켓의 풀뎁스 스냅샷을 가져옵니다. 실시간 스트림(wss://api.depthfeed.com/v3/stream)은 호가가 변할 때마다 동일한 스냅샷 객체를 푸시하므로, 과거 데이터를 리플레이하려고 작성한 로더가 실시간 피드도 그대로 읽습니다. 아카이브로 백테스트한 다음 같은 코드를 스트림에 연결해 곧바로 거래하세요.
자동화와 에이전트를 위한 설계
이 API는 단일 Bearer 키(또는 X-API-Key)를 쓰는 일반 JSON이라 SDK가 필요 없고, 어떤 function-calling이나 MCP 방식 도구 정의에도 곧바로 들어갑니다. WebSocket 프로토콜은 세 개의 JSON op(subscribe / unsubscribe / ping)로 이뤄지며, 헤더를 설정할 수 없는 경우에는 ?api_key= 인증을 씁니다. 오류는 분기 처리하기 좋은 안정적인 코드 enum(AUTH_INVALID, COIN_NOT_IN_PLAN, RATE_LIMIT_BURST, …)을 사용합니다.
미터링, 페이지네이션, 해상도 조절
키셋(커서) 페이지네이션과 플랜별 레이트 리밋이 대량 추출을 예측 가능하게 유지하며, 모든 응답에 X-RateLimit-* 헤더가 붙습니다. 해상도도 직접 고를 수 있습니다. 기본값은 기록된 모든 호가 변동이고, ?interval=(30s–1d)을 추가하면 서버 측에서 버킷당 호가 하나로 다운샘플링됩니다. 복사해 붙여 쓸 수 있는 예제가 담긴 전체 레퍼런스는 문서에 있습니다.
Start pulling polymarket 데이터 api
Free Explorer tier, no card. Full bid/ask depth and the underlying price on every snapshot, over a REST API and a live WebSocket stream.
궁금한 점, 답해 드립니다.
아니요. HTTPS 위의 일반 JSON에 단일 Bearer 키만 쓰므로, HTTP 클라이언트가 있는 어떤 언어에서도 작동하고 래퍼 없이 function-calling이나 MCP 방식 에이전트 도구에 바로 들어갑니다. 실시간 WebSocket은 간단한 세 가지 JSON op(subscribe / unsubscribe / ping)를 사용하며, 헤더를 설정할 수 없는 클라이언트는 ?api_key= 인증으로 처리됩니다.