API & MCP for AI Assistants
HistoricalData.net offers a free metadata API and an MCP server so that tools and AI assistants can check what data we sell — symbol coverage, date ranges, prices — before a purchase. The datasets themselves (CSV bundles) are paid downloads delivered by email; this interface never returns market data rows.
REST API
| Endpoint | Purpose |
|---|---|
GET /api/status | Current data freshness: stock bundle date, latest options EOD date, ticker counts |
GET /api/symbol/{ticker} | Coverage for one symbol: stock date ranges, active/delisted records (incl. reused symbols), data sizes, options availability |
GET /api/catalog | Datasets for sale with live coverage, sizes, prices and purchase links |
Machine-readable spec: /openapi.json (OpenAPI 3.1).
Example:
curl https://historicaldata.net/api/symbol/AAPL
MCP Server
Endpoint: https://historicaldata.net/mcp (Streamable HTTP, stateless, no authentication required).
| Tool | Purpose |
|---|---|
search_symbol | Check whether a ticker / option underlying is included, with coverage and sizes |
get_catalog | List datasets with live coverage, prices and purchase links |
get_pricing | Current prices, delivery terms and purchase links |
get_free_sample | Links to free sample files (identical format to paid data) |
Add it to an MCP-capable client (e.g. Claude) as a remote HTTP server with the URL above. Example tool call over raw HTTP:
curl -X POST https://historicaldata.net/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_symbol","arguments":{"symbol":"TSLA"}}}'
Rate Limits & Terms
- 30 requests per minute per IP. Responses are cacheable (Cache-Control headers are set).
- Single-symbol lookups only — this interface is not a bulk symbol-master database and may not be scraped to build one.
- Metadata and pricing only; market data itself is licensed per the License Agreement and delivered after purchase.
- Please do not bulk-download the sample files under
/file/programmatically. - Availability is best-effort; for guaranteed answers email [email protected].
What the data behind this is
U.S. stock daily and 1-minute bars from November 2003 (15,000+ active and 50,000+ delisted tickers, unadjusted and split/dividend-adjusted prices side by side) and U.S. options EOD data from May 2002 (quotes, volume, open interest, Greeks, implied volatility). See the stocks page, options page and data methodology.
Last updated: 2026-06-11. Questions: [email protected].