llms.txt Content
# Twelve Data
> Twelve Data is a financial market data platform providing real-time and historical data for stocks, forex, cryptocurrencies, ETFs, mutual funds, bonds, and commodities via REST API, WebSocket, SDKs, and an MCP server. Coverage spans 1M+ instruments across 250+ exchanges in 90+ countries. Free tier available; REST base URL is https://api.twelvedata.com, WebSocket is wss://ws.twelvedata.com.
Key facts for quick orientation:
- Authentication: API key via `apikey` query parameter or `Authorization: apikey <key>` header. Get a key at https://twelvedata.com/register (free Basic plan, no credit card).
- Quickstart: `curl "https://api.twelvedata.com/price?symbol=AAPL&apikey=your_api_key"`
- Credits model: most endpoints cost 1 credit per symbol; premium data (fundamentals, analysis) costs more. Plan tiers: Basic (free) → Grow → Pro → Ultra (individual); Venture → Enterprise → Enterprise+ (business).
- All documentation pages are available as clean markdown for LLMs under https://twelvedata.com/docs/llms/
- OpenAPI spec: https://api.twelvedata.com/doc/swagger/openapi.json
- Hosted MCP server: https://mcp.twelvedata.com (streamable-http); open source at https://github.com/twelvedata/mcp
- Real-time WebSocket streaming latency averages ~170 ms; uptime SLA 99.95% (99.99% on Enterprise).
## Docs
- [Introduction](https://twelvedata.com/docs/llms/introduction.md): Quickstart, authentication, API keys, base URLs, error codes, rate limits, SDKs, OpenAPI spec
- [Market data](https://twelvedata.com/docs/llms/market-data.md): /time_series (OHLCV bars, 1min–1month), /quote, /price, /eod, /market_movers, cross rates — for stocks, forex, crypto, ETFs
- [Reference data](https://twelvedata.com/docs/llms/reference-data.md): Instrument catalogs (/stocks, /forex_pairs, /cryptocurrencies, /etfs, /funds, /bonds, /commodities), /symbol_search, /exchanges, /market_state, exchange schedules
- [Fundamentals](https://twelvedata.com/docs/llms/fundamentals.md): Income