helebest/holo-polymarket

Polymarket Query

Polymarket 예측 시장을 조회하는 읽기 전용 스킬입니다(주문을 체결하지 않음). 다음 두 가지 요구를 충족합니다:

• 시장 조사: 인기 이벤트, 검색, 이벤트 상세, 과거 가격 및 확률/거래량 추세.
• 포지션 및 고래 추적: 리더보드, 특정 주소의 포지션 및 손익(P&L), 거래 내역.

실제 매수/매도(주문 체결, 취소, 잔액, 주문 관리)를 하려면 polymarket-trade 스킬을 사용하세요.

빠른 시작

1. 환경 확인: bash, curl, jq, gamma-api.polymarket.com / data-api.polymarket.com / clob.polymarket.com 접근 가능.
2. 작업 유형 선택: 시장 정보 / 고래 및 포지션 / 과거 추세.
3. 해당 명령어 실행: bash <skill-dir>/scripts/polymarket.sh <command> [args...].

전체 명령어 목록: references/commands.md. 문제 해결: references/troubleshooting.md.

명령어 선택

• 빠른 시장 인기 확인: hot [limit].
• 키워드로 시장 검색: search <keyword> [limit].
• Slug로 이벤트 상세 조회(토큰 포함): detail <event-slug>.
• 최고 트레이더 추적 / 포지션 확인: leaderboard (별칭 lb) → positions (별칭 pos) → trades.
  • 미결제 포지션만: positions <address> [limit] --active.
  • 내 지갑: POLYMARKET_FUNDER (또는 FUNDER) 설정 시, positions / trades 명령어에 주소를 입력하지 않으면 기본값으로 사용됩니다. 프록시 지갑 주소(자금/포지션을 보유한 주소)를 사용하고, 서명자/EOA는 사용하지 마세요.
• 시계열 분석:
  • 확률 테이블: history
  • 시작/종료 변화 요약: trend
  • 거래량 변화: volume-trend
• 파일 내보내기: history/trend/volume-trend에 --format csv|json 및 선택적 --out <file> 추가.

최소 예제

# 1) 인기 시장
bash <skill-dir>/scripts/polymarket.sh hot 5

# 2) 검색 + 상세
bash <skill-dir>/scripts/polymarket.sh search bitcoin 5
bash <skill-dir>/scripts/polymarket.sh detail fed-decision-in-march-885

# 3) 고래 및 포지션 추적
bash <skill-dir>/scripts/polymarket.sh lb 10 pnl week
bash <skill-dir>/scripts/polymarket.sh pos 0xc257ea... 10
bash <skill-dir>/scripts/polymarket.sh pos 0xc257ea... 10 --active   # 미결제만
bash <skill-dir>/scripts/polymarket.sh trades 0xc257ea... 10

# 4) 과거 추세 + 내보내기
bash <skill-dir>/scripts/polymarket.sh history fed-decision-in-march-885 2025-01-01 2025-01-31 1d
bash <skill-dir>/scripts/polymarket.sh trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format csv
bash <skill-dir>/scripts/polymarket.sh volume-trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format json --out /tmp/volume.json

매개변수 규칙: from/to는 YYYY-MM-DD 형식; interval은 1h / 4h / 1d.

일반적인 오류

• 누락된 의존성: curl / jq 설치.
• 네트워크 오류: API 접근 가능 여부 및 타임아웃 확인; 필요 시 CURL_TIMEOUT 증가. 프록시 환경에서는 HTTPS_PROXY가 자동 감지됩니다.
• 과거 가격 오류: POLYMARKET_BEARER_TOKEN 또는 자격 증명 파일 확인(아래 참조).
• 인수 오류: 명령어 사용법과 날짜 형식(YYYY-MM-DD) 재확인.

자격 증명(과거 가격 엔드포인트만 필요)

과거 가격 엔드포인트는 베어러 토큰이 필요할 수 있습니다. 다음 순서로 확인됩니다(에이전트 중립적, 특정 런타임에 종속되지 않음):

1. POLYMARKET_BEARER_TOKEN 환경 변수
2. POLYMARKET_CREDENTIALS_FILE이 가리키는 파일
3. 프로젝트 디렉토리의 ./.credentials (gitignored 처리 권장)
4. ~/.config/holo-polymarket/credentials
5. ~/.openclaw/credentials/polymarket_credentials (레거시 대체)

자격 증명 파일은 KEY=VALUE 형식이며 BEARER_TOKEN / TOKEN 필드를 지원합니다.

동일한 파일(또는 환경 변수)은 POLYMARKET_FUNDER / FUNDER — 내 프록시 지갑 주소를 제공할 수도 있습니다. 설정되면 positions / trades 명령어에 주소를 입력하지 않을 때 기본값으로 사용됩니다. 이것이 조회 스킬이 읽는 유일한 신원 정보이며, 나머지는 모두 읽기 전용이고 공개 정보입니다.

트레이딩 경계

이 스킬은 읽기 전용이며 주문을 체결하지 않습니다. 매수/매도, 취소, 잔액 및 주문 관리를 위해서는 polymarket-trade 스킬(공식 CLOB API 기반)을 사용하세요.