Communitygithub.com

mvanhorn/clawdbot-skill-polymarket

Polymarket 예측 시장을 내 손끝에서 - AI 기반 분석으로 배당률 확인, 포트폴리오 추적, 시장 조사, 비교 및 거래까지 가능. 4가지 Polymarket API(Gamma, CLOB, Data API, RTDS WebSocket, Bridge)를 모두 지원합니다. 읽기 전용 작업은 즉시 사용 가능합니다(설정 불필요). ClawHub에서 가장 포괄적인 예측 시장 스킬입니다.

clawdbot-skill-polymarket란 무엇인가요?

이 스킬은 Polymarket CLI를 통해 터미널에서 Polymarket 예측 시장에 접근하고 거래할 수 있는 포괄적인 도구입니다. AI 에이전트가 자연어를 통해 배당률 조회, 이벤트 연구, 시장 비교, 포트폴리오 추적, 실시간 데이터 스트리밍, 자금 브리징, 그리고 거래 실행까지 모든 작업을 수행할 수 있도록 지원합니다. 이 스킬은 Polymarket이 제공하는 5가지 API 계층(Gamma, CLOB, Data API, RTDS WebSocket, Bridge)을 모두 통합하여, 시장 검색 및 조회(Gamma API), 거래 주문(CLOB API), 포트폴리오 분석(Data API), 실시간 데이터(RTDS WebSocket), 그리고 체인 간 자금 이동(Bridge)을 하나의 인터페이스에서 처리합니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼과 함께 사용하도록 설계되었으며, 읽기 전용 명령어는 CLI 설치 없이 즉시 실행 가능하여 누구나 쉽게 시작할 수 있습니다. 복잡한 시장 조사, 트렌드 분석, 그리고 주요 정치, 스포츠, 암호화폐 관련 이벤트의 예측 시장 정보를 필요로 하는 개발자나 트레이더에게 매우 유용한 스킬입니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add mvanhorn/clawdbot-skill-polymarket

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Polymarket

터미널에서 Polymarket 예측 시장을 조회하고 거래하세요. 배당률 탐색, 이벤트 연구, 시장 비교, 포트폴리오 추적, 실시간 데이터 스트리밍, 자금 브리징, 그리고 거래 실행까지 모두 자연어로 가능합니다.

Polymarket은 4개의 개별 API와 Gamma 편의 계층을 제공합니다. 이 스킬은 이 모든 것을 지원합니다.

설정

읽기 전용 명령어는 즉시 실행 가능합니다(설치 불필요). 탐색, 검색, 트렌드, 카테고리, 시장 조사 및 비교 모드는 모두 공개 Gamma API를 사용합니다.

거래, 오더북, 가격 내역 및 고급 기능을 사용하려면 Polymarket CLI를 설치하세요(Rust 바이너리, v0.1.5+):

brew install polymarket/tap/polymarket-cli

거래를 위해 지갑을 설정하세요:

polymarket wallet create
polymarket approve set

또는 ~/.config/polymarket/config.json에 개인 키를 수동으로 설정하세요. 자세한 내용은 CLI 문서를 참조하세요.

CLI는 대화형 REPL도 제공합니다:

polymarket shell

스크립팅 및 파이핑에 적합한 기계 판독 가능 출력을 위해 모든 CLI 명령어에 --output json을 사용하세요.

명령어

시장 탐색 (CLI 불필요)

# 트렌딩/활성 시장 (24시간 거래량 순 정렬)
python3 {baseDir}/scripts/polymarket.py trending

# 더 많은 결과로 트렌딩 보기
python3 {baseDir}/scripts/polymarket.py trending --limit 20

# 키워드로 시장 검색
python3 {baseDir}/scripts/polymarket.py search "trump"

# 슬러그로 특정 이벤트 가져오기
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"

# 카테고리별 시장 가져오기
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto
python3 {baseDir}/scripts/polymarket.py category sports
python3 {baseDir}/scripts/polymarket.py category tech
python3 {baseDir}/scripts/polymarket.py category entertainment
python3 {baseDir}/scripts/polymarket.py category science
python3 {baseDir}/scripts/polymarket.py category business

트렌딩 시장 대시보드 (CLI 불필요)

Polymarket의 가장 인기 있는 시장에 대한 카테고리별 대시보드를 보여줍니다. 트렌딩과 카테고리 필터를 결합하여 전체 개요를 구성하세요.

# 전체 트렌딩 대시보드 - 순서대로 실행하여 그림 구성:
python3 {baseDir}/scripts/polymarket.py trending --limit 10
python3 {baseDir}/scripts/polymarket.py category politics --limit 5
python3 {baseDir}/scripts/polymarket.py category crypto --limit 5
python3 {baseDir}/scripts/polymarket.py category sports --limit 5
python3 {baseDir}/scripts/polymarket.py category tech --limit 5

사용자가 "대시보드" 또는 "개요"를 요청하면 모든 카테고리 쿼리를 실행하고 결과를 섹션별로 명확한 제목과 함께 그룹화하여 표시하세요. 각 시장의 거래량과 현재 배당률을 포함하세요.

시장 조사 모드 (CLI 불필요)

시장 조사는 Polymarket 배당률을 맥락 분석과 결합합니다. 사용자가 시장을 "조사"하거나 배당률 이상의 심층 분석을 요청할 때:

  1. 시장 데이터 가져오기 - search 또는 event 명령어 사용
  2. 배당률 분석 - 시장이 의미하는 바는 무엇인가? 엣지가 있는가?
  3. 맥락 제공 - 귀하의 지식을 사용하여 배당률을 움직이는 요인 설명
  4. 역사적 움직임 표시 - CLI를 사용 가능하면 가격 내역 가져오기
  5. 합의와 비교 - Polymarket 배당률이 여론조사, 전문가 의견 또는 다른 예측 시장과 어떻게 비교되는가?
# 1단계: 시장 찾기
python3 {baseDir}/scripts/polymarket.py search "fed rate cut"

# 2단계: 상세 이벤트 데이터 가져오기
python3 {baseDir}/scripts/polymarket.py event "fed-rate-decision-march-2026"

# 3단계: CLI 가능하면 추세를 보기 위해 가격 내역 가져오기
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# 4단계: 유동성 평가를 위한 오더북 깊이 확인
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

데이터 수집 후, 연구 결과를 구조화된 보고서로 종합하세요:

  • 현재 배당률: 예/아니오 비율 및 그 의미
  • 거래량 및 유동성: 이 시장에 얼마나 많은 자금이 있는가, 거래할 만큼 유동적인가?
  • 추세: 배당률이 상승 중인가 하락 중인가? 최근 급등이 있었는가?
  • 맥락: 배당률을 움직이는 실제 이벤트 또는 데이터 포인트는 무엇인가?
  • 주요 날짜: 시장은 언제 해소되는가? 다가오는 촉매제는?
  • 위험 요소: 갑작스러운 움직임을 유발할 수 있는 것은?

시장 비교 모드 (CLI 불필요)

관련 시장을 나란히 비교합니다. 차익거래 찾기, 조건부 확률 이해, 또는 다른 결과 간의 관계를 확인하는 데 유용합니다.

# 각 시장을 검색하여 두 개 이상의 관련 시장 비교
python3 {baseDir}/scripts/polymarket.py search "trump 2028"
python3 {baseDir}/scripts/polymarket.py search "desantis 2028"
python3 {baseDir}/scripts/polymarket.py search "newsom 2028"

사용자가 "시장 비교" 또는 "나란히 배당률 보기"를 요청할 때:

  1. 사용자가 언급한 각 시장 검색
  2. 비교 테이블 형식으로 배당률 표시
  3. 거래량 차이 기록 (거래량이 높을수록 더 신뢰할 수 있는 배당률)
  4. 명백한 불일치 표시 (예: 합계가 약 100%여야 하는데 그렇지 않은 확률)
  5. 관련 결과 간의 스프레드 강조

비교 결과를 테이블 형식으로 포맷:

시장 비교: 2028년 대통령 선거

| 후보자    | 예      | 거래량  | 유동성   |
|-----------|---------|---------|----------|
| 트럼프    | 32.5%  | $4.2M  | 높음     |
| 디샌티스  | 18.1%  | $1.8M  | 중간     |
| 뉴섬      | 12.4%  | $890K  | 중간     |
| 해리스    | 8.7%   | $2.1M  | 중간     |

포트폴리오 대시보드 (CLI + 지갑 필요)

포지션, 손익, 미체결 주문을 한 눈에 볼 수 있는 전체 포트폴리오를 확인하세요.

# 모든 미체결 포지션 보기
python3 {baseDir}/scripts/polymarket.py positions

# 특정 지갑의 포지션 보기
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

# USDC 잔고 확인
python3 {baseDir}/scripts/polymarket.py wallet-balance

# 특정 토큰의 잔고 확인
python3 {baseDir}/scripts/polymarket.py wallet-balance --token TOKEN_ID

# 모든 미체결 주문 목록
python3 {baseDir}/scripts/polymarket.py orders

사용자가 "포트폴리오 대시보드" 또는 "내 상태가 어떤가요?"를 요청하면 세 가지 명령어(positions, wallet-balance, orders)를 모두 실행하고 통합된 보기를 제시하세요:

  • 포지션: 각 포지션별 현재 시장 가격, 진입 가격(가능한 경우), 미실현 손익
  • USDC 잔고: 새로운 거래에 사용 가능한 현금
  • 미체결 주문: 가격과 수량이 포함된 대기 중인 지정가 주문
  • 총 포트폴리오 가치: 포지션 합계 + USDC 잔고

오더북 및 가격 (CLI 필요, 지갑 불필요)

# 토큰의 오더북
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

# 가격 내역 (간격: 1m, 1h, 6h, 1d, 1w, max)
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# 특정 데이터 포인트 수로 가격 내역
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1h --fidelity 48

지갑 (CLI 필요)

polymarket wallet create
polymarket wallet show
polymarket wallet balance
polymarket wallet balance --token TOKEN_ID

거래 (CLI + 지갑 필요)

모든 거래는 실행을 위해 --confirm이 필요합니다. 이것이 없으면 주문은 미리보기만 됩니다. 이것은 안전 기능입니다 - 실행되기 전에 어떤 일이 일어날지 항상 확인할 수 있습니다.

비용 및 수수료 투명성

거래를 실행하기 전에 스킬은 다음을 표시합니다:

  • 주문 유형: 지정가 또는 시장가
  • 방향: 매수 또는 매도
  • 가격: 귀하의 지정가(또는 시장가 주문의 경우 "market")
  • 수량: 주식 수
  • 예상 비용: 지정가 주문의 경우 가격 x 수량, 시장가 주문의 경우 달러 금액
  • Polymarket 수수료: Polymarket은 CLOB(중앙 제한 주문장)에서 거래 수수료를 부과하지 않습니다
  • 가스비: 온체인 작업(승인, 분할, 상환)은 Polygon에서 MATIC 가스가 필요합니다. 일반적인 가스: $0.01-0.05
# 지정가 주문 미리보기(--confirm 없음 = 미리보기만)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10

# 지정가 주문 실행
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.50 --size 10

# 매도 지정가 주문
python3 {baseDir}/scripts/polymarket.py --confirm trade sell --token TOKEN_ID --price 0.70 --size 10

# 시장가 주문: 현재 가격으로 $5어치 매수
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --market-order --amount 5

# 포스트 온리 지정가 주문(오더북에만 대기, 유동성을 빼앗지 않음 - 2026년 1월 이상)
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.45 --size 20 --post-only

주문 및 포지션 (CLI + 지갑 필요)

# 미체결 주문 목록
python3 {baseDir}/scripts/polymarket.py orders

# 특정 주문 취소
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel ORDER_ID

# 모든 주문 취소
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel all

# 포지션 보기
python3 {baseDir}/scripts/polymarket.py positions
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

API 참조

Polymarket은 4개의 개별 API와 Gamma 편의 계층을 제공합니다. 각각은 다른 목적을 제공합니다.

1. Gamma API (gamma-api.polymarket.com) - 공개, 인증 불필요

시장 탐색 및 검색을 위한 고급 편의 API입니다. 모든 읽기 전용 명령어에서 사용됩니다.

  • 기본 URL: https://gamma-api.polymarket.com
  • GET /events - 이벤트 목록 (매개변수: order, ascending, closed, limit, tag_slug)
  • GET /search - 시장 검색 (매개변수: query, limit)
  • GET /events/slug/{slug} - 슬러그로 이벤트 조회
  • GET /comments - 시장에 대한 댓글 목록 및 필터링
  • GET /profiles/{address} - 공개 사용자 프로필
  • GET /series - 그룹화된 이벤트 컬렉션 (예: "2028년 선거" 시리즈)
  • GET /sports - 스포츠 메타데이터 (팀, 경기, 해소 기준 포함)
  • GraphQL: POST /query - 구독 지원이 포함된 전체 GraphQL 엔드포인트

2. CLOB API (clob.polymarket.com) - 거래

모든 거래 작업을 위한 중앙 제한 주문장 API입니다. Polymarket CLI로 래핑됩니다.

  • 기본 URL: https://clob.polymarket.com
  • GET /prices-history - 과거 가격 (간격: 1m, 1h, 6h, 1d, 1w, max)
  • GET /spread - 토큰의 매수-매도 스프레드
  • GET /fee-rate - 수수료 구조 세부 정보
  • GET /rewards - 일일 메이커/테이커 수익
  • POST /order - 주문 제출
  • POST /orders - 배치 주문 (요청당 최대 15개)
  • DELETE /order/{id} - 주문 취소
  • 주문 채점 - 주문 제출 전 메이커 리베이트 자격 확인
  • 포스트 온리 주문 (2026년 1월) - 오더북에만 대기하고 스프레드를 절대 넘지 않는 주문
  • 하트비트 API (2026년 1월):
    • POST /heartbeat - 10초 이내에 전송해야 하며, 그렇지 않으면 모든 미체결 주문이 자동 취소됨
    • 마켓 메이커가 주문 존재를 유지하는 데 사용됨
    • 하트비트가 만료되면 해당 API 키에 대한 모든 대기 주문이 취소됨

3. Data API (data-api.polymarket.com) - 포트폴리오 및 분석

포트폴리오 추적, 거래 내역 및 시장 분석을 위한 전용 API입니다. 공개 엔드포인트는 인증이 필요하지 않습니다.

  • 기본 URL: https://data-api.polymarket.com
  • GET /positions?user={address} - 현재 열린 포지션
    • 정렬 기준: TOKENS, CURRENT, INITIAL, CASHPNL, PERCENTPNL
  • GET /closed-positions?user={address} - 과거 종료된 포지션
  • GET /activity?user={address} - 활동 피드
    • 유형: TRADE, SPLIT, MERGE, REDEEM, REWARD
  • GET /value?user={address} - USD 기준 포트폴리오 평가액
  • GET /trades - 거래 내역
    • 필터 기준: user, market, side
    • 페이지당 최대 500개 결과
  • GET /holders?market={conditionId} - 시장의 상위 토큰 보유자
  • GET /oi - 시장 전체 미결제 약정
  • GET /volume - 시장 전체 거래량
  • GET /leaderboard - 트레이더 순위 (구성 가능한 기간)

포트폴리오 대시보드 및 분석에는 Data API를 사용하세요. CLOB API보다 더 풍부한 포지션 데이터를 제공하며, 손익 계산 및 활동 내역이 포함됩니다.

4. RTDS WebSocket (wss://ws-live-data.polymarket.com) - 실시간 스트리밍

WebSocket을 통한 실시간 데이터 스트리밍. 폴링 없이 실시간 업데이트를 받으려면 토픽을 구독하세요.

  • URL: wss://ws-live-data.polymarket.com
  • 프로토콜: WebSocket을 통한 JSON 메시지
  • 토픽:
    • comments - 실시간 댓글 활동
      • 이벤트: comment_created, comment_removed, reaction_created, reaction_removed
    • crypto_prices - 실시간 암호화폐 가격
      • 자산: BTC, ETH, SOL, XRP
      • 소스: Binance + Chainlink 오라클
  • 동적 구독 관리 - 단일 연결 내에서 토픽을 즉시 구독 및 구독 취소
  • 실시간 대시보드 구축, 댓글 감정 모니터링, 또는 5분 암호화폐 시장에 공급되는 암호화폐 가격 추적에 유용

5. Bridge API (bridge.polymarket.com) - 크로스체인 입금 및 출금

여러 체인에 걸쳐 Polymarket 안팎으로 자금을 브리징합니다.

  • 기본 URL: https://bridge.polymarket.com
  • POST /deposit - 입금 주소 생성
    • 지원 체인: EVM(Ethereum, Polygon, Arbitrum 등), Solana, Bitcoin
    • 선택한 체인에 대한 고유 입금 주소 반환
  • POST /withdraw (2026년 1월) - USDC.e를 지원되는 모든 체인으로 브리징
  • GET /supported-assets - 모든 지원 자산 및 체인 목록
  • GET /quote - 크로스체인 브리징 견적 가져오기 (수수료, 예상 시간)

사용자가 터미널을 떠나지 않고 Polymarket 안팎으로 자금을 이동해야 할 때 Bridge API를 사용하세요.


새로운 시장 유형

  • 5분 암호화폐 시장 (2026년 2월) - BTC/ETH/SOL 가격 변동에 대한 초단기 시장. RTDS crypto_prices 데이터에서 공급됩니다.
  • 스포츠 시장 - 팀 정보, 경기 일정 및 해소 기준이 포함된 Gamma /sports 엔드포인트를 통한 전용 스포츠 메타데이터.

오류 복구

API 오류 (Gamma API)

Gamma API가 오류를 반환하거나 연결할 수 없는 경우:

  • HTTP 429 (속도 제한)

…

[기타 내용은 번역 범위를 벗어납니다]

관련 스킬