Aapipick
API de búsqueda · Mercados de predicción

API de búsqueda de mercados de predicción

Consulta contratos de Polymarket y Kalshi sobre política, economía, deportes y actualidad. JSON preformateado para recuperar pronósticos de masa y anclar probabilidades en flujos LLM.

50 créditos / llamada30 req / minPOST /api/search/prediction-markets

Prueba la búsqueda de mercados de predicción en directo

Introduce tu API Key y ejecuta una consulta real contra el endpoint en producción.

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

¿No tienes una clave API?

Inicia sesión en tu cuenta para crear y gestionar tus claves API.

Iniciar sesiónGestionar claves API
5 consultas de ejemplo — haz clic para cargar

API Integration Guide

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

API Overview
Búsqueda semántica en contratos de mercados de predicción de Polymarket y Kalshi. Devuelve títulos de mercados, resúmenes y URLs fuente.
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
}

Preguntas frecuentes

¿Qué mercados están cubiertos?

Polymarket (descentralizado, liquidación en USDC) y Kalshi (regulado por la CFTC). Tanto los mercados activos como los resueltos son consultables.

¿Se devuelven cuotas en tiempo real?

Los resultados incluyen metadatos del mercado y URLs fuente. Para precios en tiempo real, sigue la URL fuente o la API nativa del mercado. El endpoint está optimizado para recuperación y descubrimiento, no para cotizaciones de alta frecuencia.

¿Por qué usar esto en lugar de ir directo?

Un endpoint, una autenticación, búsqueda semántica entre ambas plataformas y facturación unificada por créditos. Útil cuando un agente necesita anclar una afirmación probabilística sin integrar dos APIs separadas.

¿Filtro por fecha?

Sí. start_date / end_date filtran mercados por fecha de listado o resolución.

¿Esquema tool?

GET /api/search/prediction-markets/tool-schema devuelve definiciones de tool use de OpenAI y Claude.