주제 리서치
5 크레딧/v1/polymarket/research공개 Polymarket 시장에 대한 서버 측 다중 쿼리 팬아웃입니다. 주제를 병렬 검색으로 확장하고 이벤트를 중복 제거한 뒤 주제와 무관한 결과를 걸러 관련도 순으로 정렬합니다. 이벤트 제목, 시장 질문, 결과 가격, 거래량, 종료일을 반환합니다.
query, limit
Polymarket 엔드포인트
공개 Polymarket 읽기 엔드포인트는 1개입니다. 리서치 주제를 넣으면 예측 시장 세트를 반환합니다. 이벤트 제목, 시장 질문, 결과별 가격, 거래량, 종료일이 포함됩니다. 데이터 API만 지원하며 거래와 지갑 동작은 없습니다.
Polymarket API1개 엔드포인트 지원
문서 보기특정 주제의 Polymarket 예측 시장을 관련도 순으로 정렬해 이벤트 제목, 시장 질문, 결과별 가격, 거래량, 종료일과 함께 반환합니다.
검색을 여러 번 대신 돌리고 주제에서 벗어난 결과는 걸러 줍니다. 한 주제의 시장만 모아 볼 때 사용하세요.
GET/v1/polymarket/research?query=trump+2028+election
query · The research topic — free-text natural language (e.g. 'last 30 days bitcoin halving', 'kanye west tour'). Framing prefixes like 'last N days' and 'what are people saying about' are stripped automatically before expansion.
$ curl https://www.socialcrawl.dev/v1/polymarket/research?query=trump+2028+election \
-H "x-api-key: sc_YOUR_API_KEY"— · 대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Polymarket API 동작
Polymarket도 다른 SocialCrawl 엔드포인트와 같습니다. API 키로 GET /v1/polymarket/research를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. Polymarket 지갑과 별도 SDK는 없습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 카탈로그 전 구간에 같은 키를 사용합니다. Polymarket 계정과 거래 자격 증명은 필요 없습니다.
GET과 쿼리 파라미터
활성 라우트는 GET입니다. query에 자유 형식 주제를 넣습니다. 선택 limit은 팬아웃 레그당 결과 상한을 둡니다. 수식어 문구는 확장 전에 제거됩니다.
크레딧 과금
리서치는 업스트림을 여러 번 치므로 라이브 미스당 5 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다. 잘못된 파라미터는 과금하지 않습니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 시장 행은 data 아래에 담깁니다.
연동 순서
대부분 제품은 주제를 한 번 리서치한 뒤 순위화된 시장을 유지하고 서사가 바뀔 때 다시 호출합니다. 현재 Polymarket에는 다중 엔드포인트 드릴다운 체인이 없습니다.
01주제
GET /v1/polymarket/research?query=…&limit=10자유 형식 리서치 쿼리입니다. 개체, 선거, 이벤트, 시장 주제를 씁니다.
한 문자열이 전체 팬아웃을 구동합니다. 수식어 접두어는 자동으로 제거됩니다.
02리서치
# expand topic into multi-query fan-out시장, 결과 가격, 거래량, 종료일이 있는 순위 이벤트입니다.
서버가 쿼리를 확장하고 비관련 결과를 걸러 관련 시장을 순위화합니다.
03선택
# dedupe, filter, rank markets알림이나 대시보드에 필요한 시장 부분집합입니다.
하위 제품은 보통 전체 이벤트가 아니라 짧은 목록을 감시합니다.
04갱신
# return ranked research payload가격이나 거래량이 다시 필요할 때의 최신 순위 세트입니다.
캐시 히트는 반복 비용을 낮춥니다. 라이브 미스는 다중 쿼리 컴포지트를 다시 실행합니다.
요청
GET /v1/polymarket/research
?query=us+election+odds
&limit=10
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here응답 봉투
{
"success": true,
"data": {
"query": "us election odds",
"markets": [
{
"id": "market_…",
"title": "Example market",
"url": "https://polymarket.com/…",
"ext": {
"volume": 1200000,
"probability": 0.62
}
}
]
},
"credits_used": 5,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
Polymarket은 Analytics 형태 검색 표면입니다. 필드 이름은 공유 SocialCrawl 봉투 아래 있어 클라이언트에 두 번째 파서를 두지 않아도 됩니다.
Enveloperesearch
success, data, credits_used, credits_remaining, request_id, cached
SearchResult / Eventsmarkets[]
순위 이벤트: title, slug, markets[], volume, liquidity, end date, 있는 경우 price changes
Market rowranking fields
시장 질문, 결과 가격, 이벤트 연결, 거래량 신호
Research metaenvelope fields
중복 제거와 비관련 필터 이후 주제 기반 팬아웃 순위(서버 측 컴포지트)
게이트웨이
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Polymarket 전용 사이드카가 아닙니다.
- 01
엣지 수신
Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 키당 레이트 리밋과 동시성을 적용합니다.
- 02
검증 후 차감
레지스트리에서 polymarket/research를 찾습니다. 필수 query 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 5 크레딧을 차감합니다.
- 03
캐시 또는 팬아웃
platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 주제를 최대 6개 검색으로 확장해 공개 Gamma API를 병렬 호출한 뒤 중복 제거, 필터, 순위를 적용합니다.
- 04
정규화 후 반환
업스트림 시장 JSON을 SearchResult 페이로드로 맞춘 뒤 성공 봉투로 감싸 빌링 감사에 남깁니다.
과금 규칙
- 리서치 라이브 미스는 5 크레딧입니다.
- 캐시 히트는 0 크레딧입니다.
- 빈 응답과 하드 실패는 자동 환불됩니다.
- 잘못된 파라미터는 400이며 과금하지 않습니다.
- 잔액이 없으면 402이며 과금하지 않습니다.
- search는 등록되어 있으나 소프트 비활성이며 라이브가 아닙니다.
- 거래와 쓰기 라우트는 없습니다.
- 카탈로그와 같은 API 키를 사용합니다.
- 레이트 리밋과 동시성은 키 단위로 적용됩니다.
데이터 수집
Polymarket 리서치는 공개 예측 시장 데이터를 읽어 주제별 순위 피드를 반환합니다. 코드가 Gamma에 직접 붙거나 다중 쿼리 팬아웃을 구현할 필요는 없습니다.
API에서의 Polymarket
공개 예측 시장과 이벤트를 읽기 전용으로 제공합니다. 주제 모니터링, 서사 추적, 제품 작업에 사용합니다. 주문 체결과 지갑 접근은 없습니다.
업스트림
전용 Polymarket fetcher가 공개 Gamma API를 호출합니다. 리서치는 한 주제를 병렬 검색으로 확장하고 이벤트 id로 중복을 제거한 뒤 관련 없는 결과를 걸러 나머지를 순위화합니다.
응답 형태
success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 이벤트와 시장 행에는 제목, 질문, 가격, 거래량, 종료일이 포함됩니다.
미제공 항목
쓰기 엔드포인트는 없습니다. 거래는 없습니다. polymarket/search는 등록되어 있으나 업스트림 불안정 이후 소프트 비활성이며, 라이브 주제 작업에는 research를 사용합니다.
필드 매핑
topic query→ expanded search legs이벤트 제목, slug, 종료일, 거래량
market cards→ data.markets[] + ext.*시장 질문, 결과 가격, 유동성
rank scores→ research rollup서버 다중 쿼리 팬아웃. 관련 주제 순위 세트
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
1active Polymarket endpoints in the registry
5 credits5 크레딧 고급 컴포지트
주제 단위 예측 시장 리서치
호출은 자유 형식 주제로 research를 쓰는 경우가 많습니다. 여러 검색을 직접 돌리지 않고 관련 시장만 필요할 때입니다. 고급 컴포지트 1개가 쿼리를 확장하고 노이즈를 걸러 시장을 순위화합니다. 고정 5 크레딧입니다. 소셜 플랫폼과 같은 SocialCrawl 키와 봉투를 사용합니다.
리서치는 업스트림 검색을 여러 번 치므로 라이브 미스는 단일 쿼리 소셜 읽기보다 깁니다. 캐시 히트는 즉시 반환됩니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
서사 모니터
Python, cron, Slack 봇선거, 암호화폐, 뉴스 주제로 research를 폴링합니다. 순위 시장의 거래량이나 가격이 움직이면 알립니다.
리서치 노트북
Node, 노트북, BI 적재가설에 맞는 시장 세트를 가져온 뒤 가격과 제목을 테이블에 붙입니다. 다중 쿼리 로직을 직접 쓰지 않습니다.
백엔드 제품 잡
Go, 워커, Explorer주제 리서치를 대시보드와 에이전트 도구에 연결합니다. 카탈로그와 같은 API 키를 사용합니다. 캐시 히트로 반복 비용을 낮춥니다.
엔드포인트
Polymarket API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 Polymarket Gamma API, 뭐가 다른가요?
같은 Polymarket 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | Polymarket Gamma API |
|---|---|---|
| 인증 | 38개 다른 플랫폼과 공유하는 x-api-key 하나면 돼요 | 공개 Gamma 엔드포인트는 키가 필요 없어요 |
| 시작하기 | /v1/polymarket/research에 주제를 담은 GET 한 번이면 돼요 | 무료지만 검색 펼치기와 집계 로직을 직접 짜야 해요 |
| 응답 스키마 | 소셜 소스와 같은 파서를 그대로 쓰는 통합 data.items 구조예요 | Gamma 전용 시장 객체에, 거래용 CLOB은 별도 API예요 |
| 요금 | 리서치 호출당 5 크레딧, 신용카드 없이 100 크레딧 무료 | 무료 |
| 데이터 범위 | 주제 하나로 확률·가격·거래량·마감일을 모은 다중 시장 뷰를 받아요 | 원본 시장 데이터는 풍부하지만 질의 한 번에 하나씩이에요 |
인증
SocialCrawl
38개 다른 플랫폼과 공유하는 x-api-key 하나면 돼요
Polymarket Gamma API
공개 Gamma 엔드포인트는 키가 필요 없어요
시작하기
SocialCrawl
/v1/polymarket/research에 주제를 담은 GET 한 번이면 돼요
Polymarket Gamma API
무료지만 검색 펼치기와 집계 로직을 직접 짜야 해요
응답 스키마
SocialCrawl
소셜 소스와 같은 파서를 그대로 쓰는 통합 data.items 구조예요
Polymarket Gamma API
Gamma 전용 시장 객체에, 거래용 CLOB은 별도 API예요
요금
SocialCrawl
리서치 호출당 5 크레딧, 신용카드 없이 100 크레딧 무료
Polymarket Gamma API
무료
데이터 범위
SocialCrawl
주제 하나로 확률·가격·거래량·마감일을 모은 다중 시장 뷰를 받아요
Polymarket Gamma API
원본 시장 데이터는 풍부하지만 질의 한 번에 하나씩이에요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기SocialCrawl Polymarket API는 무엇인가요?
Polymarket의 공개 Gamma API를 통합해서 감싼 엔드포인트예요. x-api-key 하나로 GET 요청을 보내면 시장 질문, 결과, 확률과 가격, 거래량, 마감일까지 정리된 예측 시장 데이터를 받아볼 수 있어요. 다른 플랫폼과 똑같은 data.items 스키마, 같은 크레딧 체계로 받아보세요.
어떤 Polymarket 엔드포인트를 지원하나요?
한 가지예요. /v1/polymarket/research에 주제를 담아 호출하면 Polymarket 예측 시장에 키워드 검색을 여러 번 펼쳐서, 질문·결과·확률과 가격·거래량·마감일이 담긴 시장들을 하나의 뷰로 모아 돌려줘요.
Polymarket에 API가 있나요? 무료인가요?
네, Polymarket은 공개 Gamma API를 무료로 제공하고, 거래용으로는 CLOB API도 있어요. SocialCrawl은 Gamma를 감싸서 x-api-key 하나, 통합 스키마, 크레딧 과금으로 다른 데이터 소스와 함께 쓰게 해드려요. 새 계정은 카드 없이 100 크레딧을 무료로 받아요.
Polymarket API는 요금이 얼마인가요?
research 엔드포인트는 한 번에 여러 검색을 돌려서 5 크레딧(어드밴스드 티어)이에요. 새 계정은 신용카드 없이 100 크레딧을 무료로 받아 다중 시장 리서치를 20번 정도 돌려보실 수 있어요.
시장마다 어떤 데이터 필드가 오나요?
각 시장에는 질문, 현재 확률과 가격이 붙은 결과별 정보, 총 거래량, 마감일, 그리고 진행·마감·확정 같은 상태가 담겨 와요. 모든 필드가 SocialCrawl 스키마에 맞춰져 있어서 48개 플랫폼에 같은 파서를 그대로 쓰실 수 있어요.
research 엔드포인트는 단순 키워드 검색보다 뭐가 더 좋나요?
research는 한 주제로 키워드 검색을 여러 번 펼쳐서 결과를 하나의 예측 시장 뷰로 모아줘요. 질의 하나의 결과가 아니라 주제 전반의 사건 확률을 보고 싶은 트레이더, 퀀트 리서처, 기자에게 맞춰 만들었어요.
Polymarket 데이터를 API로 받는 가장 좋은 방법은 무엇인가요?
원본 시장 객체만 필요하다면 무료인 Gamma API로도 충분해요. 주제 단위 분석이 필요하다면 SocialCrawl의 /v1/polymarket/research가 좋아요. 키워드 검색을 여러 번 펼쳐서 확률·가격·거래량이 담긴 다중 시장 뷰를 5 크레딧에 한 번에 돌려드려요. 신용카드 없이 100 크레딧으로 바로 시작할 수 있어요.
Polymarket 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Polymarket 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Polymarket 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Polymarket 스크래핑 API와 공식 Polymarket API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Polymarket 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧 하나로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요 — SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요