# Twelve Data (slim)

> Twelve Data is a market data API for prices and time series across stocks, ETFs, funds, forex, crypto and commodities, with technical indicators, fundamentals, news and filings. Agents call the REST API, the WebSocket or the hosted MCP server.

- Full: https://www.anchorterminal.com/tools/twelve-data.md (~8,200 tokens) · this version ~2,080 tokens · JSON https://www.anchorterminal.com/tools/twelve-data.json · canonical https://www.anchorterminal.com/tools/twelve-data
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-04 · pricing https://www.anchorterminal.com/tools/twelve-data#pricing · reviews https://www.anchorterminal.com/tools/twelve-data#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**BB · 70/100 · rank #197 of 1349 · #2 in Financial market data · agent-ready · confidence medium**


Assessment: A public OpenAPI 3.1 document with error responses on all 187 operations, Markdown docs and pricing for agents, a status page with two short incidents in 90 days, and an MCP server behind OAuth 2.1. The REST key still travels in the query string as a documented option, no enums are declared, and free and individual plans forbid company use.

## Facts

- Kind: HTTP API · vendor: Twelve Data Pte. Ltd. · category: Financial market data · legal entity: Twelve Data Pte. Ltd. · provenance 83/100
- Endpoint: `https://api.twelvedata.com` (HTTP, Streamable HTTP, stdio, websocket)
- Auth: OAuth or key · pricing: Freemium · x402: no · licence: unknown
- Probe metrics: not measured yet (probes haven't run)
- Surface listed: The REST API at api.twelvedata.com and the hosted MCP server at mcp.twelvedata.com/mcp, read from the OpenAPI document, llms.txt and the Markdown docs, pricing.md and the pricing page, auth.md, the terms and privacy policy, the status page, the trust centre, the news page and a shallow clone of twelvedata/mcp on 3 November 2026. No account was made and no tool was called
- API: 187 GET operations tagged technical indicators (102), fundamentals (20), reference data (18), mutual funds (11), analysis (9), ETFs (8), regulatory (7), market data (6), currencies, money market funds and advanced. Base URL https://api.twelvedata.com with no version in the path
- Coverage: The vendor says more than 1 million instruments on 250 exchanges in 90 countries, with real-time US equities on every plan, real-time EU and delayed Australian data on Pro, Cboe Europe real time announced in January 2026, and exchange add-ons such as ASX and Cboe Canada priced per year
- Rate limits: Credits per minute by plan, 8 on Basic up to 10,946 on the top Ultra and Enterprise tiers, an 800 a day cap on Basic, WebSocket credits per subscribed symbol. 429 when exceeded, no Retry-After documented
- MCP server: Hosted at mcp.twelvedata.com/mcp over streamable HTTP with OAuth 2.1 (auth.twelvedata.com, scope `twelvedata`, resource indicator required). The open-source server runs over stdio or local HTTP with the key in a .env file and defines 27 tools with readOnlyHint, the 3 login and usage tools included
- Response size: `outputsize` 1 to 5,000 (default 30), `format=CSV`, `dp` decimal places, `start_date` and `end_date`, `date`, batch requests, and `type`, `exchange` and `country` filters
- Errors: JSON with `code`, `message` and `status`; 400 bad parameters, 401 bad key, 403 plan lacks access, 404 not found, 414 parameter too long, 429 limit, 500 server. Null fields are documented as expected when data is unavailable
- SDKs: Official twelvedata-python (791 stars, v1.4.0 of 27 April 2026), twelvedata-node, twelvedata-go, twelvedata-java, twelvedata-r-sdk and twelvedata-cli; community C#, PHP and TypeScript clients listed in the docs
- Use terms: Free and individual plans are internal, non-commercial use; business plans are required for any company, team, fund or organisation. External display and redistribution need Venture or above or a written agreement. Data must be deleted within 30 days of termination
- Security: Trust centre on SafeBase (SOC 2, GDPR, CCPA, ten policies, Azure hosting). No security.txt, bug bounty or public disclosure process found
- Legal entity: Twelve Data Pte. Ltd., UEN 202006058W, 20A Tanjong Pagar Road, Singapore, per the terms and privacy policy. The about page's structured data gives a founding date of 2020
- Prices: Grow, 55 credits a minute $29 per month (plan); Pro, 610 credits a minute $99 per month (plan); Ultra, 2,584 credits a minute $329 per month (plan); Venture, 610 credits a minute $149 per month (plan); Enterprise, 10,946 credits a minute $1099 per month (plan)

- Scores: Reliability 83, Performance pending, Schema & documentation 83, Agent ergonomics 84, Security & auth 54, Payments & pricing 30, Task success pending, Maintenance & community 82, Transparency & trust 67 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted lines. · Schema & documentation, A public OpenAPI 3.1 document covers 187 operations, every one with a description and 200, 400, 401, 403, 404, 414, 429 and 500 responses, a… · Agent ergonomics, The REST API is the surface graded. · Security & auth, The REST key is a plain per-account key with no scopes, accepted as a header or as `?apikey=` (20 less 10 for the query string). · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, Read as a closed service. · Transparency & trust, A closed service under terms that name the entity, define internal use, business use and redistribution, and were last updated 1 January 202…
- Sources: 23, open questions: 8, both in the full twin
- Capabilities: market.prices, market.history, market.fundamentals, market.crypto, market.indices, market.news, market.filings, data.markets
- JSON: https://www.anchorterminal.com/api/v1/tools/twelve-data.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/twelve-data.svg` or a link to https://www.anchorterminal.com/tools/twelve-data from a page on twelvedata.com or one of its subdomains, or the README at the root of github.com/twelvedata/mcp, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: support@twelvedata.com; https://support.twelvedata.com/en/; https://twelvedata.com/contact; more in the full twin

## Before you call it

1. Send the key as `Authorization: apikey <key>`, not in the URL; the hosted MCP server takes OAuth only, so never paste a key into a connector's key field
2. Set `outputsize` (1 to 5,000, default 30) and `format=CSV` on time_series to keep responses small, and read `status` in the JSON body since errors come with HTTP codes and a `message`
3. Count credits, not calls; most endpoints cost one credit per symbol and the Basic plan allows 8 a minute and 800 a day, with 429 when exceeded
4. A 403 means the key's plan lacks the endpoint or symbol, not a bad key; check pricing.md before escalating
5. Use trial symbols from twelvedata.com/exchanges to test premium data on the free plan

## Connect

```bash
pip install twelvedata
```

```bash
curl -H "Authorization: apikey $TWELVE_DATA_API_KEY" "https://api.twelvedata.com/time_series?symbol=AAPL&interval=1day&outputsize=30"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/twelve-data

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| EODHD | C | 59 | market.history, market.prices, market.fundamentals, market.filings, market.news, market.indices, market.crypto, data.markets | https://www.anchorterminal.com/tools/eodhd.min.md |
| Financial Modeling Prep | D | 48.7 | market.fundamentals, market.prices, market.history, market.filings, market.news, market.indices, market.crypto, data.markets | https://www.anchorterminal.com/tools/financial-modeling-prep.min.md |
| Finnhub | E | 45.1 | market.prices, market.fundamentals, market.news, market.filings, market.history, market.crypto, market.indices, data.markets | https://www.anchorterminal.com/tools/finnhub.min.md |
| Financial Datasets | C | 61.8 | market.fundamentals, market.filings, market.prices, market.history, market.news, market.indices, data.markets | https://www.anchorterminal.com/tools/financial-datasets.min.md |
| Intrinio | C | 54.2 | market.prices, market.fundamentals, market.filings, market.news, market.history, market.indices, data.markets | https://www.anchorterminal.com/tools/intrinio.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)