apipick
[ search · endpoint ]검색 API · 예측 시장

예측 시장 검색 API

정치, 경제, 스포츠, 시사에 대한 Polymarket·Kalshi 계약 쿼리. 군중 예측 검색과 LLM 워크플로의 확률 근거 제공을 위한 미리 정형화된 JSON.

●50 크레딧 / 호출●30 요청 / 분POST /api/search/prediction-markets
[ 01 · live ]

예측 시장 검색 라이브 사용

API 키를 입력하고 라이브 엔드포인트에 실제 쿼리를 실행하세요.

auth · x-api-key

API 키가 없으신가요?

계정에 로그인하여 API 키를 생성하고 관리하세요.

로그인API 키 관리
5개 샘플 쿼리 — 클릭하여 불러오기
[ 02 · integrate ]

Integration guide

Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and Python.

spec
POST/api/search/prediction-markets
base
https://www.apipick.com

Polymarket과 Kalshi 예측 시장 계약 전반의 시맨틱 검색. 시장 제목, 요약, 출처 URL 반환.

parameters
querystringrequired

Natural-language search query

max_num_resultsintegeroptional

1–5, default 5

relevance_thresholdnumberoptional

0.0–1.0 quality filter

country_codestringoptional

ISO country code (e.g. US, GB)

start_datestringoptional

ISO date YYYY-MM-DD

end_datestringoptional

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/prediction-markets" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "2026 US presidential election",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
● 200 · response
{
  "query": "2026 US presidential election",
  "results": [
    {
      "title": "Example result",
      "url": "https://example.com/article",
      "snippet": "Short excerpt of the page content…",
      "source_type": "web",
      "published_at": "2026-04-15",
      "score": 0.92
    }
  ],
  "result_count": 1,
  "credits_used": 50,
  "remaining_credits": 99
}
[ 03 · limits ]

Rate limits

Throttling is per API key, sliding 60-second window. Hit the limit and you get a clean 429 with a Retry-After header.

request rate

30req/min

Per API key, per endpoint. Sliding 60-second window.

concurrency

3concurrent

Max simultaneous in-flight requests per API key.

response headers
X-RateLimit-LimitMaximum requests allowed per minute
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetSeconds until the current window resets
Retry-AfterSeconds to wait before retrying (only on 429)
● 429 · too many requests
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}
[ faq ]

자주 묻는 질문

01

어떤 시장이 포함되나요?

Polymarket(탈중앙, USDC 결제)과 Kalshi(CFTC 규제). 라이브와 결산 완료 시장 모두 검색 가능.

02

라이브 배당이 반환되나요?

결과에는 시장 메타데이터와 출처 URL이 포함됩니다. 실시간 가격은 출처 URL이나 시장의 네이티브 API를 따르세요. 본 엔드포인트는 검색·발견에 최적화되어 있으며 고빈도 시세용은 아닙니다.

03

직접 호출 대신 이걸 쓰는 이유는?

엔드포인트 하나, 인증 흐름 하나, 양 플랫폼 통합 시맨틱 검색, 통일된 크레딧 청구. 두 개의 별도 API를 통합하지 않고 에이전트가 확률적 주장을 근거지어야 할 때 유용합니다.

04

날짜 필터는요?

네. start_date / end_date가 시장을 등록일이나 결산일로 필터합니다.

05

도구 스키마는?

GET /api/search/prediction-markets/tool-schema가 OpenAI와 Claude 도구 사용 정의를 반환합니다.