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 32 more developer resources.

74.5/100 exemplar ▲ 26.5 Agent 82/100 agent native Full breakdown ↓
scored 2026-07-23 · rubric v0.5
AccessPaidSelf serve
6 APIs
Market DataFinancial DataStocksForexCryptoReal-Time DataTechnical IndicatorsFundamentals

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-23 · rubric v0.5
Composite quality — 74.5/100 · exemplar
Contract Quality 16.1 / 25
Developer Ergonomics 17.4 / 20
Commercial Clarity 20.0 / 20
Operational Transparency 9.6 / 13
Governance 6.3 / 12
Discoverability 6.8 / 10
Agent readiness — 82/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
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
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.

Open Collections 1

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

Twelve Data REST API

OPEN COLLECTION

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 5

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 ↑
opencollection: 1.0.0
info:
  name: Twelve Data REST API
  version: '1.0'
request:
  auth:
    type: apikey
    apikey:
      key: apikey
      value: '{{apikey}}'
      in: query
items:
- info:
    name: Time Series
    type: folder
  items:
  - info:
      name: Time series (OHLCV)
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/time_series
    docs: Returns meta and time series (open, high, low, close, volume) for the requested instrument at the requested interval.
      Core endpoint for historical and intraday market data.
  - info:
      name: Cross time series
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/time_series/cross
    docs: Computes a cross-rate time series between two instruments (for example, exotic currency pairs) that are not directly
      quoted.
- info:
    name: Core Data
    type: folder
  items:
  - info:
      name: End of day price
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/eod
    docs: Returns the latest end-of-day closing price and metadata for an instrument.
  - info:
      name: Quote
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/quote
    docs: Returns a real-time quote for the instrument including price, open, high, low, close, volume, 52-week range, and
      change metrics.
  - info:
      name: Real-time price
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/price
    docs: Returns the latest available real-time trading price for an instrument.
  - info:
      name: Market movers
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/market_movers/{market}
    docs: Returns the top gainers and losers by percentage change for a market.
  - info:
      name: Market state
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/market_state
    docs: Returns the real-time open/closed state of exchanges.
- info:
    name: Technical Indicators
    type: folder
  items:
  - info:
      name: Relative Strength Index (RSI)
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/rsi
    docs: Returns the RSI momentum indicator time series. Representative of the 100+ technical indicator endpoints (macd,
      bbands, ema, sma, adx, stoch, atr, and more) that share the same parameter conventions.
  - info:
      name: Moving Average Convergence Divergence (MACD)
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/macd
    docs: Returns the MACD indicator time series for an instrument.
  - info:
      name: Bollinger Bands
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/bbands
    docs: Returns the Bollinger Bands overlay time series for an instrument.
  - info:
      name: List technical indicators
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/technical_indicators
    docs: Returns the catalog of all available technical indicators and their parameters.
- info:
    name: Reference Data
    type: folder
  items:
  - info:
      name: List stocks
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/stocks
    docs: Returns the daily-updated catalog of available stock symbols across exchanges.
  - info:
      name: List forex pairs
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/forex_pairs
    docs: Returns the catalog of available foreign-exchange currency pairs.
  - info:
      name: List cryptocurrencies
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/cryptocurrencies
    docs: Returns the catalog of available cryptocurrency pairs across exchanges.
  - info:
      name: List ETFs
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/etfs
    docs: Returns the catalog of available exchange-traded fund symbols.
  - info:
      name: List indices
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/indices
    docs: Returns the catalog of available market indices.
  - info:
      name: List exchanges
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/exchanges
    docs: Returns the catalog of available equity exchanges.
  - info:
      name: Symbol search
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/symbol_search
    docs: Finds instruments by name, symbol, ISIN, or FIGI.
  - info:
      name: Earliest timestamp
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/earliest_timestamp
    docs: Returns the earliest date for which data is available for an instrument and interval.
- info:
    name: Fundamentals
    type: folder
  items:
  - info:
      name: Company profile
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/profile
    docs: Returns the company profile (sector, industry, description, employees, and more).
  - info:
      name: Dividends
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/dividends
    docs: Returns the dividend history for a company.
  - info:
      name: Earnings
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/earnings
    docs: Returns historical and upcoming earnings for a company.
  - info:
      name: Income statement
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/income_statement
    docs: Returns the income statement for a company.
  - info:
      name: Balance sheet
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/balance_sheet
    docs: Returns the balance sheet for a company.
  - info:
      name: Cash flow
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/cash_flow
    docs: Returns the cash flow statement for a company.
  - info:
      name: Statistics
      type: http
    http:
      method: GET
      url: https://api.twelvedata.com/statistics
    docs: Returns key valuation, profitability, and financial statistics for a company.