[ search · endpoint ]Such-API · Märkte

Aktien-, Krypto- & Märkte-Such-API

Frage globale und US-Aktien, Krypto, Forex, ETFs, Fonds, Rohstoffe und US-Market-Mover über einen Endpunkt ab. Vorformatiertes JSON für KI-gestützte Preisabfragen, Marktdaten-Abruf und Trading-Recherche.

120 Credits / Aufruf30 Anf./Min.POST /api/search/markets
[ 01 · live ]

Märkte-Suche live testen

Gib deinen API-Key ein und führe eine echte Anfrage gegen den Live-Endpunkt aus.

auth · x-api-key

Noch keinen API-Key?

Melde dich an, um API-Keys zu erstellen und zu verwalten.

5 Beispielanfragen — zum Laden klicken
[ 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

Semantische Suche über Aktien, Krypto, Forex, ETFs, Fonds, Rohstoffe und US-Market-Mover. Liefert gerankte Datensätze mit Quell-URLs, bereit für nachgelagerte 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 ]

Häufig gestellte Fragen

01

Warum 120 Credits pro Aufruf?

Marktdaten — Aktien an 75 Börsen, Krypto, Forex, Fonds und Mover — sind lizenziert und indexgepflegt, daher kostet der Endpunkt 120 Credits (≈ 0,12 $ pro Aufruf). Immer noch weit unter einem dedizierten Marktdaten-API-Platz.

02

Welche Märkte sind abgedeckt?

Globale und US-Aktien, Kryptowährungen, Forex-Paare, ETFs, Investmentfonds, Rohstoff-Futures und US-Market-Mover (größte Gewinner, Verlierer, aktivste Titel). Alle werden parallel abgefragt.

03

Sind die Daten in Echtzeit?

Die Ergebnisse liefern die neuesten verfügbaren Daten je Instrument. Für punktgenaue Historie grenze mit Datumsfiltern ein oder frage ein bestimmtes Instrument und einen Zeitraum ab.

04

Datumsfilterung?

Ja. Übergib start_date und end_date im Format YYYY-MM-DD, um auf ein bestimmtes Fenster einzugrenzen.

05

Tool-Schema für OpenAI / Claude?

GET /api/search/markets/tool-schema liefert einsatzbereite OpenAI-Funktions- und Claude-Tool-Use-Definitionen.