apipick
[ search · endpoint ]Search API · Markets

Stocks, Crypto & Markets Search API

Query global and US equities, crypto, forex, ETFs, mutual funds, commodities, and US market movers from one endpoint. Pre-shaped JSON for AI-driven price lookups, market-data retrieval, and trading research.

●120 credits / call●30 req / minPOST /api/search/markets
[ 01 · live ]

Try Markets Search Live

Enter your API key and run a real query against the live endpoint.

auth · x-api-key

Don't have an API key?

Sign in to your account to create and manage your API keys.

Sign InManage API Keys
5 sample queries — click to load
[ 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

Semantic search across stocks, crypto, forex, ETFs, funds, commodities, and US market movers. Returns ranked records with source URLs ready for downstream 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 ]

Frequently Asked Questions

01

Why is this 120 credits per call?

Market data — equities across 75 exchanges, crypto, forex, funds, and movers — is licensed and index-maintained, so the endpoint is priced at 120 credits (≈ $0.12 per call). Still far below a dedicated market-data API seat.

02

Which markets are covered?

Global and US equities, cryptocurrencies, forex pairs, ETFs, mutual funds, commodity futures, and US market movers (top gainers, losers, most active). All are queried in parallel.

03

Is the data real-time?

Results return the latest available data for each instrument. For point-in-time history, scope with date filters or query a specific instrument and period.

04

Date filtering?

Yes. Pass start_date and end_date in YYYY-MM-DD to scope to a specific window.

05

Tool schema for OpenAI / Claude?

GET /api/search/markets/tool-schema returns ready-to-paste OpenAI function and Claude tool-use definitions.