PredictionToolkit
Polymarket Data API 소개
지갑 화면은 총손익만으로 충분하지 않습니다. 포지션과 결과를 연결하고 매수·매도, 가격, 수량, 시점을 유지하며 열린 노출과 확정 결과·회전량을 구분하세요. 보유자 페이지는 결과별이므로 asset ID별로 묶어야 합니다.
순위에는 기간과 지표를 명시해야 합니다. 보관된 공개 v2 표본은 data/pagination 구조였으며 limit=1 페이지 뒤에도 결과가 있었습니다. 이 제한된 관측이 지갑 회계, 모든 엔드포인트, 비공개 주문 상태를 검증하지는 않습니다.
적합한 사용자
- 지갑·포트폴리오 대시보드 개발자.
- 공개 참여 활동 연구자.
- 포지션·거래 이력을 대조하는 앱.
기능과 범위
- 포지션과 활동
포트폴리오 대조에 공개 노출·활동을 조회합니다.
- 체결 기록
방향·가격·수량·결과·지갑·시점을 이용합니다.
- 결과별 보유자와 손익
보유자 페이지는 asset ID로 결합합니다. includePnl은 condition 하나와 페이지 크기 100 이하가 필요합니다.
- 미결제약정과 거래량
최대 20개 condition ID나 전체 미결제약정을 조회하며 이벤트 거래량과 지갑 회전량을 구분합니다.
- 결과 확정 상태
상태·지급액·갱신 시점을 확인합니다. expected_settlement_time은 가장 이른 예상치이며 마감 시각이 아닙니다.
- 트레이더·빌더 순위
트레이더 순위와 빌더 거래량·활성 사용자를 조회합니다. 순위 밖 지갑은 순위가 없을 수 있으며 기본값은 일간·손익 순입니다.
- 페이지 처리와 타입
엔드포인트별 구조·커서를 따르고 가능한 SDK 타입과 원시 응답의 새 필드를 확인합니다.
- 보관된 v2 응답 구조
표본에는 data·pagination(limit, offset, has_more, next_cursor)과 user_id, rank, pnl, volume, user_name 행이 있었으며 Gamma 시장 기록과 다릅니다.
Polymarket Data API 활용 워크플로
지갑 화면 구성
포지션·활동을 조회해 토큰·condition ID를 Gamma에 연결하고 노출·확정 결과·회전량을 구분하세요.
시장 참여 조사
condition의 체결·보유자를 asset ID별로 묶고 미결제약정을 추가하세요.
같은 기준으로 순위 비교
같은 기간·지표를 쓰고 동률·순위 없음 상태를 0으로 바꾸지 말고 유지하세요.
순위 페이지 가져오기
time_period·지표를 저장하고 data 행과 불투명 커서를 유지하세요. 한 행의 성공 응답이 전체 범위를 증명하지는 않습니다.
가격과 총비용
검토한 가이드에는 별도 Data API 구독이 없습니다. 공개 분석과 인증 계정 작업은 접근 조건이 다릅니다.
시작하기
시작하기 전에: 서로 다른 결과의 보유자 기록을 합산하지 마세요.
- 공개 분석·지갑 활동 가이드를 읽고 쿼리를 고르세요.
- 응답 구조·페이지 처리를 구현하고 안정적인 메타데이터 ID를 연결하세요.
- 인증이 필요한 계정 작업에만 SecureClient를 사용하세요.
보유자 페이지는 결과별이므로 asset ID로 결합해야 합니다.
유용한 링크
확인할 사항
- 서로 다른 결과의 보유자 기록을 합산하지 마세요.
- includePnl은 condition 하나와 페이지 ≤100이 필요합니다.
- 순위 기간을 명시하세요. 기본값은 일간·손익입니다.
- 정산 예상치는 마감이 아니므로 상태·지급액을 확인하세요.
- 보관된 한 페이지 확인은 회계·모든 스키마·전체 페이지 처리·비공개 주문을 검증하지 않습니다.
자세히 살펴보기
평가와 리뷰
사용자 리뷰 0
공개된 리뷰가 5건이 되면 주 평가가 사용자 평가로 바뀝니다.
구체적인 사례는 다음 사용자가 알맞은 도구를 고르는 데 도움이 됩니다.
관련 도구
카테고리 둘러보기
가이드와 워크플로
Polymarket Data API 자주 묻는 질문
주문을 제출할 수 있나요?
거래 작업에는 CLOB를 사용합니다.
Gamma와 무엇이 다른가요?
Gamma는 이벤트·시장을, Data API는 포지션·활동·참여를 다룹니다.
응답 하나가 전체 이력인가요?
요청 범위를 모두 받을 때까지 문서의 페이지 처리를 따르세요.
limit=1이면 순위 트레이더가 한 명인가요?
아니요. 보관된 응답의 has_more·next_cursor는 전체가 아니라 한 페이지임을 나타냈습니다.