Polymarket API를 이용해 바이브 코딩하다가 경험하고 배운 것들을 기록합니다. 공식 문서만으로 이해하기 어려웠던 인증 구조, 단위 변환, 실제 트러블슈팅 경험 위주로 정리했습니다.

목차

  1. 개요
  2. 인증 설정
  3. 주요 API
    1. 잔액 조회
    2. 마켓 조회
    3. 주문 생성
    4. 거래 내역 조회
  4. 에러 대응
  5. 버전 호환성

개요

Polymarket 아키텍처 (Proxy 지갑 구조)

Polymarket은 두 개의 지갑 주소가 존재합니다.

구분 설명
EOA (ex. MetaMask 주소) 실제 개인키를 보유한 서명 주체
Proxy 지갑 (Funder 주소) Polymarket이 생성한 스마트 컨트랙트 지갑. 실제 USDC 잔액 보유. Polymarket.com UI에 표시됨

Proxy 지갑 주소 확인: Polymarket.com 로그인 → 우측 상단 프로필 → 지갑 주소 복사

CLOB API vs Gamma API 역할 구분

API 역할 베이스 URL
CLOB API 주문 생성/취소, 오더북 조회, 잔액 조회, 트레이드 내역 https://clob.polymarket.com
Gamma API 마켓 목록, 이벤트/슬롯 정보, 마켓 결과 조회 https://gamma-api.polymarket.com

사용 라이브러리

pip install py-clob-client==0.34.6 # 반드시 최신 버전을 확인하세요.

인증 설정