Twelve Data website screenshot

Twelve Data

Twelve Data is a financial market data provider offering real-time and historical data for stocks, forex, cryptocurrencies, ETFs, indices, commodities, and funds through a single REST API and a real-time WebSocket. Coverage spans time series (OHLCV), quotes and prices, 100-plus technical indicators, reference and catalog data, and company fundamentals. Every request is authenticated with an apikey and metered as API credits; a free Basic plan grants 800 API credits per day. Real-time price streaming is delivered over a WebSocket at wss://ws.twelvedata.com/v1/quotes/price.

Twelve Data publishes 6 APIs on the APIs.io network, including WebSocket Streaming API, Core Data API, Fundamentals API, and 3 more. Tagged areas include Market Data, Financial Data, Stocks, Forex, and Crypto.

The Twelve Data catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.

Twelve Data’s developer surface includes authentication, documentation, support, engineering blog, CLI, changelog, sandbox, and 33 more developer resources.

75.4/100 exemplar ▬ flat Agent 51/100 agent ready Full breakdown ↓
scored 2026-08-17 · rubric v0.11.0
AccessPaidSelf serve
6 APIs 1 MCP Servers
Market DataFinancial DataStocksForexCryptoReal-Time DataTechnical IndicatorsFundamentals

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-17 · rubric v0.11.0
Composite quality — 75.4/100 · exemplar
Contract Quality 13.3 / 21
Developer Ergonomics 14.7 / 17
Commercial Clarity 17.0 / 17
Operational Transparency 8.1 / 11
Governance 5.4 / 10
Discoverability 7.9 / 9
Regulatory Posture 9.0 / 15
Agent readiness — 51/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Regulatory Posture applies to this provider. Its tags matched the Securities & Market Data regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/twelvedata: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

Twelve Data WebSocket Streaming API

Real-time price streaming over a persistent, bidirectional WebSocket at wss://ws.twelvedata.com/v1/quotes/price. Clients authenticate with an apikey query parameter, send JSON s...

Twelve Data Core Data API

Real-time quotes, latest prices, and end-of-day data.

Twelve Data Fundamentals API

Company profiles, statements, dividends, earnings, and analysis.

Twelve Data Reference Data API

Catalogs of instruments, exchanges, and supporting metadata.

Twelve Data Technical Indicators API

100+ technical analysis indicators computed over time series.

Twelve Data Time Series API

Historical and real-time OHLCV time series.

Postman Collections 6

Ready-to-run Postman collections for exercising this provider's APIs.

Open Collections 8

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Twelve Data API

OPEN COLLECTION

Twelve Data REST API

OPEN COLLECTION

Scroll for all 8

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

twelvedata-mcp.yml

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Twelvedata Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Twelve Data Real-Time Price WebSocket

AsyncAPI 2.6 description of Twelve Data's **real-time price WebSocket**. Unlike a one-way HTTP Server-Sent Events stream, this is a genuine, bidirectional WebSocket (`wss://`) s...

ASYNCAPI

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Twelve Data API Rules

8 rules · 1 errors 7 warnings

SPECTRAL

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Twelvedata Authentication

apiKey · 2 schemes

SECURITY

Twelvedata Domain Security

TLSv1.3 · DMARC

SECURITY

Twelvedata Trust Center

SOC 2, GDPR

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Twelvedata Agentic Access

26 operations

26 operations · 0 acting

AGENTIC

Resources

Get Started 4

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Build 6

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 5

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: twelvedata
url: https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/apis.yml
name: Twelve Data
kind: company
description: Twelve Data is a financial market data provider offering real-time and historical data for stocks, forex, cryptocurrencies,
  ETFs, indices, commodities, and funds through a single REST API and a real-time WebSocket. Coverage spans time series (OHLCV),
  quotes and prices, 100-plus technical indicators, reference and catalog data, and company fundamentals. Every request is
  authenticated with an apikey and metered as API credits; a free Basic plan grants 800 API credits per day. Real-time price
  streaming is delivered over a WebSocket at wss://ws.twelvedata.com/v1/quotes/price.
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/twelvedata.png
tags:
- Market Data
- Financial Data
- Stocks
- Forex
- Crypto
- Real-Time Data
- Technical Indicators
- Fundamentals
created: '2026-07-11'
modified: '2026-07-22'
specificationVersion: '0.19'
apis:
- aid: twelvedata:twelvedata-websocket-streaming-api
  name: Twelve Data WebSocket Streaming API
  tags:
  - Real-Time Data
  - WebSocket
  - Streaming
  - Market Data
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://twelvedata.com/docs/websocket/ws-real-time-price
  baseURL: wss://ws.twelvedata.com/v1/quotes/price
  properties:
  - url: https://twelvedata.com/docs/websocket/ws-real-time-price
    type: Documentation
  - url: asyncapi/twelvedata-asyncapi.yml
    type: AsyncAPI
  description: Real-time price streaming over a persistent, bidirectional WebSocket at wss://ws.twelvedata.com/v1/quotes/price.
    Clients authenticate with an apikey query parameter, send JSON subscribe / unsubscribe / reset control messages, and receive
    pushed price events (roughly 170ms average latency), subscribe-status acknowledgements, and heartbeats.
- aid: twelvedata:twelvedata-core-data-api
  name: Twelve Data Core Data API
  description: Real-time quotes, latest prices, and end-of-day data.
  humanURL: https://twelvedata.com/docs#time-series
  baseURL: https://api.twelvedata.com
  tags:
  - Core Data
  properties:
  - type: OpenAPI
    url: openapi/twelvedata-core-data-api-openapi.yml
  - type: OpenAPI
    url: openapi/twelvedata-openapi-original.json
  - type: Overlay
    url: overlays/twelvedata-core-data-api-overlay.yaml
  - type: Documentation
    url: https://twelvedata.com/docs#time-series
  - type: PostmanCollection
    url: collections/twelvedata.postman_collection.json
  - type: OpenCollection
    url: collections/twelvedata.opencollection.json
  - type: Documentation
    url: https://twelvedata.com/docs#core-data
  - type: Documentation
    url: https://twelvedata.com/docs#technical-indicators
  - type: Documentation
    url: https://twelvedata.com/docs#reference-data
  - type: Documentation
    url: https://twelvedata.com/docs#fundamentals
- aid: twelvedata:twelvedata-fundamentals-api
  name: Twelve Data Fundamentals API
  description: Company profiles, statements, dividends, earnings, and analysis.
  humanURL: https://twelvedata.com/docs#time-series
  baseURL: https://api.twelvedata.com
  tags:
  - Fundamentals
  properties:
  - type: OpenAPI
    url: openapi/twelvedata-fundamentals-api-openapi.yml
  - type: Overlay
    url: overlays/twelvedata-fundamentals-api-overlay.yaml
  - type: Documentation
    url: https://twelvedata.com/docs#time-series
  - type: PostmanCollection
    url: collections/twelvedata.postman_collection.json
  - type: OpenCollection
    url: collections/twelvedata.opencollection.json
  - type: Documentation
    url: https://twelvedata.com/docs#core-data
  - type: Documentation
    url: https://twelvedata.com/docs#technical-indicators
  - type: Documentation
    url: https://twelvedata.com/docs#reference-data
  - type: Documentation
    url: https://twelvedata.com/docs#fundamentals
- aid: twelvedata:twelvedata-reference-data-api
  name: Twelve Data Reference Data API
  description: Catalogs of instruments, exchanges, and supporting metadata.
  humanURL: https://twelvedata.com/docs#time-series
  baseURL: https://api.twelvedata.com
  tags:
  - Reference Data
  properties:
  - type: OpenAPI
    url: openapi/twelvedata-reference-data-api-openapi.yml
  - type: Overlay
    url: overlays/twelvedata-reference-data-api-overlay.yaml
  - type: Documentation
    url: https://twelvedata.com/docs#time-series
  - type: PostmanCollection
    url: collections/twelvedata.postman_collection.json
  - type: OpenCollection
    url: collections/twelvedata.opencollection.json
  - type: Documentation
    url: https://twelvedata.com/docs#core-data
  - type: Documentation
    url: https://twelvedata.com/docs#technical-indicators
  - type: Documentation
    url: https://twelvedata.com/docs#reference-data
  - type: Documentation
    url: https://twelvedata.com/docs#fundamentals
- aid: twelvedata:twelvedata-technical-indicators-api
  name: Twelve Data Technical Indicators API
  description: 100+ technical analysis indicators computed over time series.
  humanURL: https://twelvedata.com/docs#time-series
  baseURL: https://api.twelvedata.com
  tags:
  - Technical Indicators
  properties:
  - type: OpenAPI
    url: openapi/twelvedata-technical-indicators-api-openapi.yml
  - type: Overlay
    url: overlays/twelvedata-technical-indicators-api-overlay.yaml
  - type: Documentation
    url: https://twelvedata.com/docs#time-series
  - type: PostmanCollection
    url: collections/twelvedata.postman_collection.json
  - type: OpenCollection
    url: collections/twelvedata.opencollection.json
  - type: Documentation
    url: https://twelvedata.com/docs#core-data
  - type: Documentation
    url: https://twelvedata.com/docs#technical-indicators
  - type: Documentation
    url: https://twelvedata.com/docs#reference-data
  - type: Documentation
    url: https://twelvedata.com/docs#fundamentals
- aid: twelvedata:twelvedata-time-series-api
  name: Twelve Data Time Series API
  description: Historical and real-time OHLCV time series.
  humanURL: https://twelvedata.com/docs#time-series
  baseURL: https://api.twelvedata.com
  tags:
  - Time Series
  properties:
  - type: OpenAPI
    url: openapi/twelvedata-time-series-api-openapi.yml
  - type: Overlay
    url: overlays/twelvedata-time-series-api-overlay.yaml
  - type: Documentation
    url: https://twelvedata.com/docs#time-series
  - type: PostmanCollection
    url: collections/twelvedata.postman_collection.json
  - type: OpenCollection
    url: collections/twelvedata.opencollection.json
  - type: Documentation
    url: https://twelvedata.com/docs#core-data
  - type: Documentation
    url: https://twelvedata.com/docs#technical-indicators
  - type: Documentation
    url: https://twelvedata.com/docs#reference-data
  - type: Documentation
    url: https://twelvedata.com/docs#fundamentals
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/twelve-data/overview
- type: TrustCenter
  url: security/twelvedata-trust-center.yml
- type: DomainSecurity
  url: security/twelvedata-domain-security.yml
- type: AgenticAccess
  url: agentic-access/twelvedata-agentic-access.yml
- type: Authentication
  url: authentication/twelvedata-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/twelve-data
- type: Website
  url: https://twelvedata.com
- type: Documentation
  url: https://twelvedata.com/docs
- type: Plans
  url: plans/twelvedata-plans-pricing.yml
- type: RateLimits
  url: rate-limits/twelvedata-rate-limits.yml
- type: FinOps
  url: finops/twelvedata-finops.yml
- url: https://support.twelvedata.com
  type: Support
- url: https://twelvedata.com/blog
  type: Blog
- type: Packages
  url: packages/twelvedata-packages.yml
- type: SDKs
  url: packages/twelvedata-packages.yml
- type: CLI
  url: cli/twelvedata-cli.yml
- type: WellKnown
  url: well-known/twelvedata-well-known.yml
- type: MCPServer
  url: mcp/twelvedata-mcp.yml
- type: ToolCrosswalk
  url: mcp/twelvedata-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/twelvedata-llms.txt
- type: Conformance
  url: conformance/twelvedata-conformance.yml
- type: Compliance
  url: https://security.twelvedata.com/
- type: ErrorCatalog
  url: errors/twelvedata-problem-types.yml
- type: Lifecycle
  url: lifecycle/twelvedata-lifecycle.yml
- type: StatusPage
  url: https://twelvedata.isitup.cloud
- type: Roadmap
  url: https://roadmap.twelvedata.com/
- type: ChangeLog
  url: changelog/twelvedata-changelog.yml
- type: Conventions
  url: conventions/twelvedata-conventions.yml
- type: Sandbox
  url: sandbox/twelvedata-sandbox.yml
- type: Components
  url: components/twelvedata-components.yml
- type: DataModel
  url: data-model/twelvedata-data-model.yml
- type: AgentSkill
  url: skills/_index.yml
- type: DeveloperPortal
  url: https://twelvedata.com/account
- type: APIReference
  url: https://twelvedata.com/docs
- type: GettingStarted
  url: https://twelvedata.com/docs
- type: Pricing
  url: https://twelvedata.com/pricing
- type: SignUp
  url: https://twelvedata.com/register
- type: TermsOfService
  url: https://twelvedata.com/terms
- type: PrivacyPolicy
  url: https://twelvedata.com/privacy
- type: GitHubOrganization
  url: https://github.com/twelvedata
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com