Aapipick
검색 API · 예측 시장

예측 시장 검색 API

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

50 크레딧 / 호출30 요청 / 분POST /api/search/prediction-markets

예측 시장 검색 라이브 사용

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

API Authentication Required
Enter your API key to access this service. All API calls require authentication.

API 키가 없으신가요?

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

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

API Integration Guide

Learn how to integrate this API into your applications with code examples and detailed documentation.

API Overview
Polymarket과 Kalshi 예측 시장 계약 전반의 시맨틱 검색. 시장 제목, 요약, 출처 URL 반환.
POST
/api/search/prediction-markets

Base URL

https://www.apipick.com

Full Endpoint

https://www.apipick.com/api/search/prediction-markets
Parameters
Required and optional parameters for this API
query
required
string

Natural-language search query

max_num_results
optional
integer

1–5, default 5

relevance_threshold
optional
number

0.0–1.0 quality filter

country_code
optional
string

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

start_date
optional
string

ISO date YYYY-MM-DD

end_date
optional
string

ISO date YYYY-MM-DD

Code Examples
Copy and paste these examples to quickly integrate the API into your application

cURL Request

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"
}'
Replace YOUR_API_KEY with your actual API key
Response Example
Example response from the API

JSON 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
}
Integration Tips

✓Best Practices

  • • Always include x-api-key header
  • • Always handle errors gracefully
  • • Validate input data before sending
  • • Use HTTPS for secure communication
  • • Cache responses when appropriate

ℹResponse Headers

  • • Content-Type: application/json
  • • x-api-key: Required for authentication
  • • Status codes: 200 (success), 400 (error), 401 (unauthorized)
  • • No rate limiting applied

Rate Limits

⏱️

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
}

자주 묻는 질문

어떤 시장이 포함되나요?

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

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

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

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

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

날짜 필터는요?

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

도구 스키마는?

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