---
url: "https://predictiontoolkit.com/ko/guides/polymarket-api-endpoints/"
publisher: "PredictionToolkit"
dateModified: "2026-11-02"
---

[← Polymarket 가이드](<https://predictiontoolkit.com/ko/guides/>) 

# Polymarket 엔드포인트: 호스트와 식별자 선택

작성: PredictionToolkit · 수정: 2026-11-02

**목차**

-   [작업부터 선택](<https://predictiontoolkit.com/ko/guides/polymarket-api-endpoints/#section-0>) 
-   [식별자 분리](<https://predictiontoolkit.com/ko/guides/polymarket-api-endpoints/#section-2>) 
-   [공개 호가 연결](<https://predictiontoolkit.com/ko/guides/polymarket-api-endpoints/#section-4>) 
-   [지갑 조회 선택](<https://predictiontoolkit.com/ko/guides/polymarket-api-endpoints/#section-6>) 
-   [트레이더와 빌더 구분](<https://predictiontoolkit.com/ko/guides/polymarket-api-endpoints/#section-8>) 
-   [결과 확인](<https://predictiontoolkit.com/ko/guides/polymarket-api-endpoints/#section-10>) 
-   [제한과 비공개 작업](<https://predictiontoolkit.com/ko/guides/polymarket-api-endpoints/#section-12>) 

Gamma, CLOB와 Data API는 서로 다른 질문에 답합니다. 이 가이드는 문서화된 요청을 출처에 기록된 공개 확인과 구분합니다. 서비스는 이 디렉터리가 아니라 해당 제공자가 운영합니다.

## 작업부터 선택

-   탐색: https://gamma-api.polymarket.com GET /markets/keyset?closed=false&limit=1.
-   호가: https://clob.polymarket.com GET /book?token\_id={outcome token ID}.
-   순위: https://data-api.polymarket.com GET /v2/leaderboard?time\_period=day&limit=1. 이 공개 요청 세 개는 계정 인증 정보가 필요 없습니다.

## 식별자 분리

이벤트는 시장을 묶습니다. Gamma id는 메타데이터를, conditionId는 온체인 조건을 식별합니다. 표본 CTF 시장의 outcomes와 clobTokenIds는 인덱스로 대응하는 JSON 인코딩 배열이었습니다. 토큰을 선택하기 전에 두 배열을 모두 파싱하고 길이가 같은지 확인하세요. 필드가 없거나 대응하지 않거나 프로토콜에 적합하지 않으면 중지합니다. 숫자 Gamma id를 조건이나 토큰 대신 사용하지 마세요.

## 공개 호가 연결

기록된 확인은 진행 중인 Gamma 시장 하나와 선택 토큰의 호가를 인증 없이 받아 모두 HTTP 200이었습니다. Gamma는 markets와 next\_cursor, CLOB는 market, asset\_id, bids, asks, timestamp를 반환했습니다. market은 conditionId, asset\_id는 토큰과 맞았습니다. 반복은 다른 시장, 빈 결과나 호가 오류일 수 있습니다. 표본 가격을 현재 시세로 쓰지 마세요.

## 지갑 조회 선택

문서화된 Data 경로에는 GET /v2/positions?user={proxy wallet}&limit=1과 GET /v2/activity?user={proxy wallet}이 있습니다. 조사할 권한이 있는 공개 프록시 지갑 주소를 사용하세요. 기록된 확인에서는 지갑을 조회하지 않았습니다. 포지션의 기본값은 OPEN입니다. 조건 필터에는 Gamma id 대신 condition을 사용합니다. 페이지 조회는 data와 pagination, 포지션의 condition\_id 및 token\_id를 예상합니다. 불투명한 next\_cursor를 null까지 따르세요. pagination.offset은 표시 메타데이터이며 요청 매개변수가 아닙니다. 각 경로의 기본값, 필터, 한도와 빈 결과를 확인합니다.

## 트레이더와 빌더 구분

트레이더 요청은 HTTP 200과 user\_id 한 행, data/pagination, has\_more 및 next\_cursor를 반환했으며 첫 페이지만 확인했습니다. 반면 GET /v2/builders/leaderboard?time\_period=day&limit=1은 builder\_code 연동, 귀속 거래량과 활성 사용자를 설명하며 문서만 검토했습니다. PNL 또는 VOLUME, 기간과 단위를 표시하세요. 일일 평가 손익은 전체 기간의 실현 손익과 다르며 거래량은 결과 지분 수량으로 USD 금액이나 보장 수익이 아닙니다. 순위는 사람의 신원이나 연동을 입증하지 않습니다.

## 결과 확인

-   호스트, 경로와 공개·비공개 경계를 기록합니다.
-   Gamma id, conditionId와 토큰을 나누고 book.market·asset\_id를 맞춥니다.
-   페이지 번호 대신 data/pagination과 커서를 보존합니다.
-   user\_id·builder\_code, 지표, 기간과 단위를 명시합니다.

## 제한과 비공개 작업

비공개 CLOB GET /data/orders에는 L2 HMAC 인증이 필요하며 주문 제출에는 지갑 서명도 필요합니다. 공개 지갑 활동은 비공개 주문 상태나 사람의 신원이 아닙니다. 기록된 확인은 Gamma 한 페이지, CTF 호가창 하나와 트레이더 한 페이지만 다뤘으며 지갑 회계, 전체 페이지, 비공개 요청, 서명, 주문이나 지연 시간을 확인하지 않았습니다. 과거 자료나 향후 가용성을 보장하지 않습니다. 주소, 키, 비밀 값 또는 서명을 디렉터리에 보내지 마세요.

## 조사 계속하기

-   [Polymarket Gamma API: 이벤트와 시장 탐색 API](<https://predictiontoolkit.com/ko/tools/polymarket-gamma-api/>)  · 배경 정보: 탐색을 봅니다.
-   [Polymarket CLOB API: 호가 조회와 주문 관리](<https://predictiontoolkit.com/ko/tools/polymarket-clob-api/>)  · 배경 정보: 호가와 비공개 주문을 봅니다.
-   [Polymarket Data API: 공개 활동으로 지갑 분석 구성](<https://predictiontoolkit.com/ko/tools/polymarket-data-api/>)  · 배경 정보: 포지션과 순위를 봅니다.
-   [Polymarket API 키와 인증](<https://predictiontoolkit.com/ko/guides/polymarket-api-key/>)  · 배경 정보: 인증을 이해합니다.
-   [Polymarket API와 데이터 제공자](<https://predictiontoolkit.com/ko/polymarket-api/>)  · 배경 정보: API를 비교합니다.