PredictionToolkit
Polymarket Gamma API 소개
이벤트는 하나 이상의 질문을 묶고 개별 이진 시장은 자체 규칙과 날짜를 가진 YES/NO 계약입니다. 이벤트 URL을 단일 거래 시장으로 보지 말고 ID, slug와 결과·토큰 매핑을 구분하세요.
확인한 /markets/keyset 응답에는 markets와 next_cursor가 있습니다. CTF 시장 표본은 id, conditionId 및 JSON으로 인코딩된 outcomes와 clobTokenIds 배열을 포함했습니다. 결과 라벨과 토큰의 인덱스를 맞춰야 하며 이 표본이 모든 프로토콜 버전의 동일한 필드나 이용 가능한 CLOB 호가창을 입증하지는 않습니다.
적합한 사용자
- 검색 가능한 시장 카탈로그 구축.
- 정의와 태그가 필요한 조사.
- 경기, 팀, 계약 유형을 연결하는 스포츠 앱.
기능과 범위
- 이벤트
알려진 이벤트나 페이지별 목록을 읽습니다.
- 시장
이진 계약과 후속 식별자를 가져옵니다.
- 태그와 필터
카테고리, 상태, 지원 속성으로 좁힙니다.
- 시리즈
반복 이벤트를 주제로 묶습니다.
- 스포츠
리그, 팀, 승패, 스프레드, 합계 시장을 찾습니다.
- 경기 연결
slug를 추측하지 않고 경기 ID로 관련 시장을 찾습니다.
- Keyset 응답
markets와 next_cursor를 읽고 결과·토큰 배열이 JSON으로 인코딩돼 있으면 파싱합니다.
Polymarket Gamma API 활용 워크플로
카탈로그 구축
열린 이벤트 페이지를 순회하고 ID와 slug 및 결과·토큰 매핑을 보관하세요. 상태와 실시간 가격은 따로 갱신하세요.
스포츠 연결
경기와 팀 순서를 확인한 뒤 경기 ID로 세부 기록 베팅 시장과 추가 라인을 찾으세요.
링크 해석
URL이나 slug로 이벤트 또는 시장을 찾아 관련 ID를 주문장 조회에 쓰세요.
CTF 주문장 매핑
Gamma id와 conditionId를 구분하고 결과·토큰 순서를 유지하세요. 토큰을 CLOB에 전달하되 토큰 데이터나 활성 주문장이 없으면 중단하세요.
가격과 총비용
공개 탐색에는 인증이 필요 없습니다. 가이드에는 해당 읽기의 별도 구독이 없습니다.
시작하기
시작하기 전에: 전체 카탈로그에는 페이지 처리가 필요합니다.
- 이벤트, 시장, 시리즈 중 수준을 정하세요.
- 작은 필터 페이지를 요청하세요.
- ID, slug, 태그, 결과·토큰 매핑을 보관하세요.
- 체결 가능 가격과 주문장은 CLOB를 쓰세요.
이벤트는 YES/NO 계약 하나가 아닌 여러 시장을 포함할 수 있습니다.
유용한 링크
확인할 사항
- 전체 카탈로그에는 페이지 처리가 필요합니다.
- 규칙과 날짜는 개별 계약에 속합니다.
- 일정 변경 후 홈·원정 순서가 바뀔 수 있습니다.
- CTF 표본 필드는 모든 버전의 토큰이나 주문장을 보장하지 않습니다.
자세히 살펴보기
평가와 리뷰
사용자 리뷰 0
공개된 리뷰가 5건이 되면 주 평가가 사용자 평가로 바뀝니다.
구체적인 사례는 다음 사용자가 알맞은 도구를 고르는 데 도움이 됩니다.
관련 도구
카테고리 둘러보기
가이드와 워크플로
Polymarket Gamma API 자주 묻는 질문
이벤트와 시장은 어떻게 다른가요?
이벤트는 질문을 묶고 이진 시장은 YES/NO 질문 하나를 나타냅니다.
Gamma가 주문하나요?
아니요. 주문 제출은 CLOB 기능입니다.
관련 스포츠 시장은 어떻게 찾나요?
경기 ID와 현재 목록 조회 흐름을 사용하세요.
목록은 모두 단순 배열인가요?
아니요. 확인한 /markets/keyset은 markets와 next_cursor가 있는 객체입니다. 경로에 맞춰 파서를 쓰세요.