[ search · endpoint ]API de búsqueda · Mercados

API de búsqueda de acciones, cripto y mercados

Consulta renta variable global y de EE. UU., cripto, forex, ETFs, fondos, materias primas y movers de EE. UU. desde un solo endpoint. JSON preformateado para consultas de precios, datos de mercado y análisis de trading con IA.

●120 créditos / llamada●30 req / minPOST /api/search/markets

[ 01 · live ]

Prueba la búsqueda de mercados en vivo

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

auth · x-api-key

Clave API

¿No tienes una clave API?

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

Iniciar sesión Gestionar claves API

[ 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/markets

base

https://www.apipick.com

Búsqueda semántica en acciones, cripto, forex, ETFs, fondos, materias primas y movers de EE. UU. Devuelve registros ordenados con URLs fuente listos para LLMs.

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/markets" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Current price and market cap of Apple (AAPL)",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "Current price and market cap of Apple (AAPL)",
  "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": 120,
  "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 ]

Preguntas frecuentes

¿Por qué cuesta 120 créditos por llamada?

Los datos de mercado — renta variable en 75 mercados, cripto, forex, fondos y movers — están licenciados y requieren mantenimiento de índice, así que el endpoint cuesta 120 créditos (≈ $0.12 por llamada). Aún muy por debajo de un asiento de API de datos de mercado dedicado.

¿Qué mercados cubre?

Renta variable global y de EE. UU., criptomonedas, pares de forex, ETFs, fondos de inversión, futuros de materias primas y movers de EE. UU. (mayores subidas, bajadas y más activos). Todos se consultan en paralelo.

¿Los datos son en tiempo real?

Los resultados devuelven los últimos datos disponibles de cada instrumento. Para histórico puntual, acota con filtros de fecha o consulta un instrumento y periodo concretos.

¿Filtrado por fecha?

Sí. Pasa start_date y end_date en formato YYYY-MM-DD para acotar a una ventana concreta.

¿Esquema de herramienta para OpenAI / Claude?

GET /api/search/markets/tool-schema devuelve definiciones listas para pegar de función de OpenAI y de uso de herramientas de Claude.