---
url: "https://predictiontoolkit.com/ko/tools/polymarket-gamma-api/"
publisher: "PredictionToolkit"
dateModified: "2026-11-03"
---

[← 데이터 API](<https://predictiontoolkit.com/ko/polymarket-api/>) 

![Polymarket Gamma API 로고](<https://predictiontoolkit.com/assets/icon-logo-tool-polymarket-gamma-api-f6a03cf91e60-32-a8fd12b110824dad.webp>)

데이터 API

# Polymarket Gamma API: 이벤트와 시장 탐색 API

Polymarket Gamma API는 이벤트, 시장, 태그, 반복 시리즈, 스포츠 메타데이터를 찾는 공개 REST 계층입니다. 후속 가격과 주문장 조회에 사용할 계약을 식별합니다.

[**4.0**5점 만점편집부 평가](<https://predictiontoolkit.com/ko/tools/polymarket-gamma-api/#reviews>) [편집팀 평가](<https://predictiontoolkit.com/ko/tools/polymarket-gamma-api/#reviews>) 

[Gamma API 엔드포인트 열기](<https://gamma-api.polymarket.com/>) gamma-api.polymarket.com

**이용 경로:** API

**가격:** 공개 탐색에는 인증이 필요 없습니다. 가이드에는 해당 읽기의 별도 구독이 없습니다.

[스크린샷](<https://predictiontoolkit.com/ko/tools/polymarket-gamma-api/#screenshots>) [대안 살펴보기](<https://predictiontoolkit.com/ko/tools/polymarket-gamma-api/#alternatives>) 

[데이터 API](<https://predictiontoolkit.com/ko/polymarket-api/>) [공식 개발 도구](<https://predictiontoolkit.com/ko/polymarket-official-tools/>) 

## 스크린샷과 인터페이스

제품 미리보기1 / 2

공식 탐색 참고 문서.

## Polymarket Gamma API 소개

이벤트는 하나 이상의 질문을 묶고 개별 이진 시장은 자체 규칙과 날짜를 가진 YES/NO 계약입니다. 이벤트 URL을 단일 거래 시장으로 보지 말고 ID, slug와 결과·토큰 매핑을 구분하세요.

확인한 /markets/keyset 객체에서 markets는 레코드를, next\_cursor는 다음 페이지를 위한 커서를 담고 있었습니다. CTF 표본 레코드에는 id와 conditionId, JSON으로 인코딩된 outcomes와 clobTokenIds가 있었습니다. 두 배열을 디코딩하고 각 결과 라벨을 같은 인덱스의 토큰과 연결하세요. 이 표본만으로 모든 프로토콜 버전이 동일한 필드를 제공하거나 이용 가능한 CLOB 호가장을 갖는다고 판단할 수는 없습니다.

### 적합한 사용자

-   검색 가능한 시장 카탈로그 구축.
-   정의와 태그가 필요한 조사.
-   경기, 팀, 계약 유형을 연결하는 스포츠 앱.

## 데이터와 API 메서드

-   **이벤트**
    
    알려진 이벤트나 페이지별 목록을 읽습니다.
    
-   **시장**
    
    이진 계약과 후속 식별자를 가져옵니다.
    
-   **태그와 필터**
    
    카테고리, 상태, 지원 속성으로 좁힙니다.
    
-   **시리즈**
    
    반복 이벤트를 주제로 묶습니다.
    
-   **스포츠**
    
    리그, 팀, 승패, 스프레드, 합계 시장을 찾습니다.
    
-   **경기 연결**
    
    slug를 추측하지 않고 경기 ID로 관련 시장을 찾습니다.
    
-   **Keyset 응답**
    
    markets와 next\_cursor를 읽고 결과·토큰 배열이 JSON으로 인코딩돼 있으면 파싱합니다.
    

## 통합 작업

### 카탈로그 구축

열린 이벤트 페이지를 순회하고 ID와 slug 및 결과·토큰 매핑을 보관하세요. 상태와 실시간 가격은 따로 갱신하세요.

### 스포츠 연결

경기와 팀 순서를 확인한 뒤 경기 ID로 세부 기록 베팅 시장과 추가 라인을 찾으세요.

### 링크 해석

URL이나 slug에 해당하는 이벤트 또는 시장을 찾으세요. 이벤트라면 필요한 시장을 선택한 뒤, 그 시장의 결과와 토큰 간 대응 관계를 이용해 CLOB 호가장 조회에 쓸 토큰을 고르세요.

### CTF 주문장 매핑

Gamma id와 conditionId를 별도 필드에 보관하세요. outcomes와 clobTokenIds를 디코딩하고 각 라벨을 같은 인덱스의 토큰과 연결한 뒤 선택한 토큰을 CLOB에 전달하세요. 토큰 데이터나 활성화된 호가장이 없으면 중단하세요.

## 가격과 총비용

공개 탐색에는 인증이 필요 없습니다. 가이드에는 해당 읽기의 별도 구독이 없습니다.

## API 접근과 설정

1.  이벤트, 시장, 시리즈 중 수준을 정하세요.
2.  범위를 제한한 필터 페이지를 요청하세요. 같은 필터와 프로토콜 선택을 유지하면서 next\_cursor를 after\_cursor로 전달하세요.
3.  ID, slug, 태그, 결과·토큰 매핑을 보관하세요.
4.  체결 가능 가격과 주문장은 CLOB를 쓰세요.

[Polymarket API 문서 읽기](<https://docs.polymarket.com/getting-started/api>) 

## 유용한 링크

-   [Polymarket Discord 참여](<https://discord.gg/polymarket>) 

### 확인할 사항

-   전체 카탈로그에는 페이지 처리가 필요합니다.
-   규칙과 날짜는 개별 계약에 속합니다.
-   일정 변경 후 홈·원정 순서가 바뀔 수 있습니다.
-   CTF 표본 필드는 모든 버전의 토큰이나 주문장을 보장하지 않습니다.

## 공개 API 관측

자격 증명 없이 범위를 제한한 탐색 요청 두 건을 수행한 뒤, 반환된 CTF 시장 하나의 식별자를 확인했습니다.

### 커서로 다음 페이지 조회

동작 완료관찰 일시 2026-11-03T12:51:47.585132+00:00

**수행 동작:** closed=false와 limit=2로 /markets/keyset을 요청하고, 반환된 next\_cursor를 after\_cursor로 전달해 같은 필터로 다음 페이지를 조회했습니다.

**관찰 결과:** 두 요청 모두 HTTP 200이었습니다. 각 응답에는 시장 2개가 있었고 두 번째 페이지의 시장 ID는 달랐습니다. 두 응답 모두 markets와 next\_cursor를 포함했습니다.

**범위와 한계:** 이 두 페이지만 읽었습니다. 전체 범위, 모든 갱신 상황에서의 안정적인 순서, 허용되는 최대 페이지 크기를 확인한 것은 아닙니다.

[확인한 출처](<https://gamma-api.polymarket.com/markets/keyset?closed=false&limit=2>) 

### 결과와 식별자 순서 맞추기

동작 완료관찰 일시 2026-11-03T12:51:47.585132+00:00

**수행 동작:** 반환된 시장 하나의 outcomes와 clobTokenIds를 디코딩하고 첫 번째 라벨의 결과로 별도 CLOB 요청을 보냈습니다.

**관찰 결과:** 표본 레코드에는 version v1, 시장 id, conditionId가 있었습니다. 결과 라벨 2개와 토큰 ID 2개는 JSON이 인코딩된 문자열이어서 디코딩 후 같은 인덱스로 맞춰야 했습니다.

**범위와 한계:** CTF 표본입니다. Protocol V2는 포지션 ID를 사용할 수 있으므로 이 형태가 모든 시장의 스키마를 보장하지는 않습니다.

[확인한 출처](<https://gamma-api.polymarket.com/markets/keyset?closed=false&limit=2>) 

Gamma는 탐색 레코드를 제공했고 CLOB는 선택한 결과의 호가장을 확인했으며 Data API는 조건·이벤트 식별자로 집계 요청을 받았습니다. 각 식별자는 서로 다른 연결에 쓰이며 이벤트 제목만으로 대체할 수 없습니다.

자세히 살펴보기

## 평가와 리뷰

편집부 평가

**4.0**5점 만점

사용자 리뷰 0건

PredictionToolkit 편집부

### Polymarket Gamma API에 대한 편집부 의견

Gamma의 공개 탐색과 구조화된 이벤트 메타데이터로 검색 가능한 카탈로그를 구성할 수 있습니다. 전체 범위를 담으려면 페이지 처리를 구현하고 이벤트와 그에 속한 개별 계약을 명확히 구분해야 합니다.

**평가 기준:** 작업 유용성, 문서화된 범위, 설정의 명확성, 접근 및 비용의 투명성.

**평가 날짜:** 2026-10-01

**문서 검토 완료:** 2026-10-01

문서에 근거한 평가입니다. [평가 방법](<https://predictiontoolkit.com/ko/methodology/>) 

### 사용자 리뷰 0

공개된 리뷰가 5건이 되면 주 평가가 사용자 평가로 바뀝니다.

**첫 이용 경험을 공유해 주세요**

구체적인 사례는 다음 사용자가 알맞은 도구를 고르는 데 도움이 됩니다.

## 관련 도구

[카테고리 둘러보기](<https://predictiontoolkit.com/ko/polymarket-api/>) 

![공식 Polymarket CLOB 가격·호가 문서](<https://predictiontoolkit.com/assets/cover-polymarket-clob-api-39f988b081351d90-400.webp>)

![Polymarket CLOB API 로고](<https://predictiontoolkit.com/assets/logo-tool-polymarket-clob-api-765ba4cc040b.webp>)[Polymarket CLOB API](<https://predictiontoolkit.com/ko/tools/polymarket-clob-api/>) 

데이터 API**4.0**편집부

결과 토큰 가격과 깊이를 조회하고 인증 주문은 별도 서명 절차로 처리합니다.

-   접근 API

토큰 ID를 찾은 뒤 주문장을 조회하고 주문합니다.

![Polymarket 공개 스포츠 채널과 하트비트 문서](<https://predictiontoolkit.com/assets/cover-polymarket-sports-websocket-d7d3ffe80862a22d-400.webp>)

![Polymarket Sports WebSocket 로고](<https://predictiontoolkit.com/assets/icon-logo-tool-polymarket-gamma-api-f6a03cf91e60-32-a8fd12b110824dad.webp>)[Polymarket Sports WebSocket](<https://predictiontoolkit.com/ko/tools/polymarket-sports-websocket/>) 

데이터 API**4.0**편집부

스포츠 시장 화면에 실시간 점수, 피리어드, 경기 상태를 추가합니다.

-   접근 API

연결된 경기의 실시간 상태를 유지합니다.

![ARBITER 통합 API 진입점과 예시 시장](<https://predictiontoolkit.com/assets/cover-arbiter-d7074ec9d310a948-400.webp>)

![ARBITER 로고](<https://predictiontoolkit.com/assets/logo-tool-arbiter-bc344e06ee46.svg>)[ARBITER](<https://predictiontoolkit.com/ko/tools/arbiter/>) 

데이터 API**3.5**편집부

Polymarket과 Kalshi의 정규화 시장, 과거 주문장, 지갑 분석, 잠재적 이벤트 일치를 조회하세요.

-   접근 API

API와 데이터 제공자에도 포함됩니다.

## 가이드와 워크플로

-   [Polymarket API 키와 인증](<https://predictiontoolkit.com/ko/guides/polymarket-api-key/>) 
-   [Polymarket API 엔드포인트: Gamma, CLOB, Data](<https://predictiontoolkit.com/ko/guides/polymarket-api-endpoints/>) 
-   [Polymarket이란?](<https://predictiontoolkit.com/ko/guides/how-polymarket-works/>) 

## Polymarket Gamma API 자주 묻는 질문

### 이벤트와 시장은 어떻게 다른가요?

이벤트는 질문을 묶고 이진 시장은 YES/NO 질문 하나를 나타냅니다.

### Gamma가 주문하나요?

아니요. 주문 제출은 CLOB 기능입니다.

### 관련 스포츠 시장은 어떻게 찾나요?

경기 ID와 현재 목록 조회 흐름을 사용하세요.

### 목록은 모두 단순 배열인가요?

아니요. 확인한 /markets/keyset은 markets와 next\_cursor가 있는 객체입니다. 경로에 맞춰 파서를 쓰세요.

이 프로필에서