Polymarket API 개발자를 위한: Data, CLOB, and Polygon RPC

Source: Dev.to

위에 있는 소스 링크 외에 번역할 텍스트를 제공해 주시면 한국어로 번역해 드리겠습니다.

Gamma API – 시장 탐색

• 공개이며 인증이 필요 없습니다.
• Events(최상위 질문)와 Markets(특정 거래 가능한 결과)를 노출합니다.
• 각 시장은 결과와 1:1로 매핑되는 outcomePrices 배열을 포함하며, 이는 내재된 확률을 나타냅니다(예: 0.62 = YES가 62 %일 확률).
• 활성 상태, 24 h 거래량, 태그, 개방/폐쇄 상태 등으로 필터링할 수 있습니다.
• Important: 시장에 실시간 CLOB 유동성이 있다고 가정하기 전에 enableOrderBook: true인지 확인하십시오.

CLOB – 하이브리드 트레이딩 엔진

CLOB는 오프‑체인 주문 매칭과 온‑체인 EIP‑712 결제를 처리합니다.

• 접근: 공식 SDK (TypeScript, Python, Rust) 또는 일반 REST.
• 인증:
  1. L1 – 지갑 서명을 통해 가스 비용 없이 API 자격 증명을 생성합니다.
  2. L2 – 자격 증명을 사용해 모든 주문 호출 시 빠른 HMAC‑서명 요청을 수행합니다.
• 주문 유형:
  • GTC – Good‑Till‑Cancelled (북에 남아 있음)
  • GTD – Good‑Till‑Date (시간 제한)
  • FOK – Fill‑Or‑Kill (전부 혹은 전무)
  • FAK – Fill‑And‑Kill (가능한 만큼 채우고 나머지는 취소)
• 사전 주문 체크: 유효한 EIP‑712 서명, 충분한 USDC.e 잔액, 승인된 CTF Exchange 허용량, 그리고 유효한 L2 자격 증명.

데이터 API – 사용자 수준 분석

지갑에 대한 상세 분석을 제공합니다:

• 시장 전반에 걸친 현재 포지션.
• 타임스탬프, 규모, 실현/미실현 손익이 포함된 전체 거래 내역.
• 지갑별 활동 피드.

대시보드 구축이나 전략 성과를 시간에 따라 분석하는 데 유용합니다.

WebSocket – 실시간 업데이트

Four subscription channels:

Production note: 인증된 세션이 비활성화되면 Polymarket는 모든 미체결 주문을 취소합니다. 봇은 세션을 유지하기 위해 주기적인 하트비트를 전송해야 합니다.

Step‑by‑Step Integration Overview

1. Polygon 지갑을 설정하고 POL을 입금합니다.
2. USDC.e를 Polymarket 프로필 주소에 입금합니다.
3. 지갑에서 L2 API 자격 증명을 파생합니다.
4. client.setAllowances()를 한 번 실행하여 CTF Exchange를 승인합니다.
5. Gamma API를 통해 마켓을 가져옵니다.
6. 주문서를 검사합니다.
7. CLOB SDK 또는 REST 엔드포인트를 통해 지정가 주문을 합니다.
8. 실시간 체결을 위해 관련 WebSocket 채널을 구독합니다.
9. 체인 상 확인을 위해 CTF Exchange에서 OrderFilled 이벤트 리스너를 설정합니다.

These steps give you a foundation for analytics tools, automated trading bots, or custom interfaces.

• clob-client (TypeScript) – 주문 배치 및 API 자격 증명 처리.
• real-time-data-client – 내장 재연결 로직이 있는 WebSocket 구독.
• clob-order-utils – 저수준 EIP‑712 주문 서명.
• rs-clob-client (Rust).
• Polymarket Agents (Python) – LLM 기반 자율 거래를 위한 레퍼런스 구현.
• Goldsky‑powered subgraphs – 포지션, 주문서, P&L, 미결제이자(open interest)를 위한 GraphQL 엔드포인트.
• Polygon RPC – Chainstack을 통한 프로덕션 급 아카이브 접근 및 WebSocket.

위험 및 고려 사항

• 시장 위험: 잘못된 예측은 약정된 금액 전부를 잃게 할 수 있습니다.
• 유동성 위험: 유동성이 낮은 시장은 깊이가 부족할 수 있습니다.
• 오라클 위험: 결과에 이의가 제기될 경우 정산 지연이 발생할 수 있습니다.
• 규제 위험: 지리적 제한이 적용될 수 있으니, 귀하의 관할 구역에서 예측 시장의 법적 지위를 확인하십시오.
• 스마트‑컨트랙트 위험: 모든 온‑체인 플랫폼과 마찬가지로 취약점이 존재할 수 있습니다.

손실을 감당할 수 있는 자금만 사용하고 적절한 실사를 수행하십시오.

결론

Polymarket API는 예측 시장을 프로그래밍 가능한 인프라로 전환합니다:

• Polygon에서 빠르고 저비용 결제.
• USDC.e 기반 거래.
• Gamma(발견), CLOB(실행), Data(분석), WebSocket(실시간) 전반에 걸친 깔끔한 기본 요소.
• 기존 EVM 도구(Solidity, ethers.js, viem, Foundry)를 수정 없이 사용할 수 있습니다.

생태계가 아직 초기 단계라, 잘 문서화되고 감시된 계약과 투명한 온체인 히스토리를 기반으로 거래 봇, 확률 대시보드, 분석 파이프라인 등을 구축할 수 있는 충분한 기회를 제공합니다.

Read the full article on Chainstack Blog