Gamma API

Polymarket Gamma API는 시장 수준의 데이터(시장, 이벤트, 태그, 시리즈, 프로필)를 노출하는 공개 REST API입니다. 개발자와 트레이더는 인증 없이 시장 목록을 조회하고 이벤트 메타데이터를 가져오며, 인덱스 페이지나 마켓 디렉토리를 구축할 때 이를 사용합니다.

핵심 요약

Gamma API는 공개 읽기 전용 API로 인증이 필요하지 않습니다. 시장, 이벤트, 태그, 시리즈, 프로필을 나열할 때 사용하세요.
/markets 엔드포인트는 레이트 제한이 있습니다: 10초당 300 요청. 페이징은 커서 기반의 after_cursor를 사용합니다(오프셋은 거부됩니다).
유용한 쿼리 매개변수로는 limit(최대 1000), after_cursor, slug 또는 condition_ids 같은 배열 필터들, closed나 active 같은 불리언 플래그가 있습니다.
/markets와 /events를 조합할 때는 주의하세요: 두 엔드포인트의 결합된 목록 한도는 10초당 900 요청이며, 전체 API 표면의 한도는 10초당 4000 요청입니다.

Gamma API의 사용 방식

Gamma API는 Polymarket 시장에 대한 표시용 데이터의 표준 공개 표면입니다. 프론트엔드, 집계기, 리서치 도구는 /markets와 /events 같은 엔드포인트를 호출해 시장 목록, 카테고리 페이지, 태그 필터를 채웁니다.

중요 매개변수와 동작

limit: 페이지 크기를 제어합니다. 기본값은 20, 최대값은 1000입니다.
after_cursor: 커서 기반 페이징입니다. offset은 HTTP 422로 거부되므로 오프셋을 사용하지 마세요.
필터링: 여러 쿼리 파라미터가 배열을 허용합니다(예: slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address).
플래그: closed(기본값 false), active, archived는 마켓 상태로 필터링합니다.
정렬: order 파라미터는 쉼표로 구분된 필드 목록을 받습니다(예: volume24hr,volume,liquidity,endDate)며, ascending(불리언)과 함께 사용합니다.

레이트 제한 및 실무 권장사항

/markets 전용 제한: 10초당 300 요청.
/markets + /events의 결합된 목록 제한: 10초당 900 요청.
전체 Gamma API 표면 제한: 10초당 4000 요청.

고처리량 인덱싱을 계획한다면 지수적 백오프를 구현하고 커서 기반 페이징 패턴을 준수하세요. 적절한 경우 목록을 캐시하고 동일 리소스를 과도하게 폴링하지 마세요.

예시 요청 (curl)

curl "https://gamma-api.polymarket.com/markets?limit=50&order=volume24hr&ascending=false"

Polymarket 맥락에서

Gamma는 UI 목록, 태그 페이지 또는 온체인 상태를 필요로 하지 않는 통합에서 시장 메타데이터가 필요할 때 접근하는 공개 읽기 전용 API입니다(온체인 포지션과 트레이드 정보는 Data API를, 오더북 작업은 CLOB API를 사용하세요). Gamma는 읽기 전용이자 공개이므로 마켓 디렉토리나 탐색 도구를 구축하기에 적합한 곳입니다.

참고

/glossary/data-api
/glossary/clob-api

마지막 메모

Polymarket Gamma API는 시장 메타데이터를 얻기 위한 첫 방문 지점입니다. 문서화된 파라미터를 사용하고 레이트 제한을 준수하여 요청이 거부되는 일을 피하세요.

Gamma API

관련 용어