Twelve Data: market-data APIs, streaming and spreadsheet tools

Twelve Data provides financial datasets through a unified REST API, streaming connections and spreadsheet tools. Coverage includes equities, foreign exchange, cryptocurrencies, ETFs and mutual funds, with corporate actions, financial statements, holdings and analyst estimates available by plan. Customers range from individual developers and researchers to businesses embedding data in financial applications. JSON and CSV support different integration and analysis workflows.[1]

The default real-time US equities feed includes the universe of listed shares but represents approximately 5% of total US trading activity, according to Twelve Data’s August 2026 guide. Symbol coverage therefore does not mean a consolidated view of every venue’s trades. The provider describes historical and end-of-day data as covering full US volume after midnight Eastern Time on the next trading day. OTC securities require separate licensing and are excluded from the default plans. Broader real-time coverage is arranged separately.[2]

Forex API v2 is a composite reference feed. Twelve Data describes a weighted average of more than 60 liquidity-provider, prime-broker and central-bank sources, covering over 1,500 fiat pairs and precious metals. The published delivery schedule is a mid-price update each minute through WebSocket and aggregated candles from one minute to one month through REST. These rates are not a particular broker’s executable bid and offer; the separate forex guide also requires a license for onward API redistribution.[3]

The January 2026 library catalogue labels Python’s twelvedata-python and R’s td package as official. Its JavaScript, C# and Go entries are marked third-party. This distinction matters when allocating maintenance and support responsibility; the availability of a client library does not make every package vendor-maintained.[6]

The WebSocket FAQ states that OHLC candles, technical-indicator values and bid/ask prices are not supplied through that price stream. Its 100-events-per-minute limit governs client control messages such as subscribing or resetting, rather than the number of incoming price updates. A system needing those other data types should define the appropriate REST requests and publication cadence.[8]

The following are published entry configurations in US dollars, checked on 21 October 2026. Credit selectors can raise the subscription price; the personal pricing page, for example, displays Grow at $79 monthly when 377 API credits are selected. This does not replace its lower entry configuration.[11]

REST credits reset each minute and depend on endpoint weight multiplied by symbols. Three time-series symbols cost three credits; three income statements cost 300. WebSocket credits separately measure subscribed streams: the price method uses one per successfully subscribed symbol. Exhausted REST quota produces HTTP 429; the Basic daily allowance resets at midnight UTC. Paid plans remove the daily cap, while retaining their per-minute limits.[9]

Data add-ons require an active subscription, consume the plan’s normal credits and may need exchange approval. Their price depends on personal or commercial use. Upgrades are prorated immediately; downgrades and cancellations normally take effect at the end of the paid period. Ordinary subscription payments are generally non-refundable.[11]

The terms provide for automatic renewal and require cancellation at least 24 hours beforehand. Fees exclude applicable taxes. Free-tier data cannot be used commercially.[13]

Full streaming starts at Pro for personal use or Venture for business use. Basic and Grow provide a restricted trial: one WebSocket connection and up to eight eligible trial symbols. A successful trial-symbol response does not establish entitlement to the full requested instrument universe.[10]

For multi-symbol REST queries, all symbols share the endpoint and parameters. JSON POST batching can combine different endpoints and intervals, returning an individual result for each item. Failed items do not necessarily invalidate successful ones, and attempted sub-requests still consume credits. Applications should inspect each result rather than treating a successful transport response as a complete batch.[14]

The streaming guide allows three concurrent connections for normal use and recommends a heartbeat every ten seconds. Opening connections beyond the limit can close earlier ones. A deployment spanning development, staging and production therefore needs deliberate connection ownership and reconnection handling, particularly when several processes share the same API key.[7]

The usage guide distinguishes live quota from dashboard statistics, which may be cached or show a previous maximum. The /api_usage endpoint reports the plan and remaining allowance but itself costs one API credit. Response headers api-credits-used and api-credits-left provide an additional way to monitor consumption within ordinary requests.[15]

Twelve Data estimates that completed REST candles appear 0.3–2 minutes after the interval closes, depending on the instrument. Its streaming latency estimate is approximately 170 milliseconds, also instrument-dependent. These are supplier descriptions, not measured results or a universal freshness guarantee; a strategy needs the publication behavior of its selected feed.[16]

The business pricing page advertises integration support and Slack Connect for Enterprise, and dedicated 24/7 support for Enterprise+. These are tier-specific offers.[12]

Public availability figures need reconciliation: Enterprise marketing advertises 99.99%, while the general terms’ conditional SLA states 99.9% and excludes third-party data availability. The applicable signed SLA should identify the commitment, exclusions and credit rules.[12][13]

The license defaults to internal use, with external display, redistribution and non-display rights governed by the purchased tier, add-ons or written agreement. Third-party data can require further contracts, reporting and fees.[13]

For US equities, the guide explicitly separates the included default feed from external distribution. Client access, brokerage redistribution and white-label delivery require the relevant add-on or agreed rights. Paying for more request capacity alone does not resolve that licensing scope.[2]

External display and redistribution normally require Twelve Data attribution and any exchange-specific notices. The guidance permits contractual exceptions, including qualifying white-label arrangements, and passes relevant requirements to downstream users. An unbranded interface therefore needs an express license provision rather than simply omitting the source label.[17]

The trust center lists security policies, audit logging, subprocessors and a data-processing agreement, with an access-request route for sensitive documentation. It displays a SOC 2 compliance label. The public overview is not the underlying audit report; report type, period, scope and exceptions require the applicable assurance materials.[19]

The January 2026 terms identify Twelve Data Pte. Ltd., UEN 202006058W. The published legal-notice address is 20A Tanjong Pagar Road, Singapore 088443.[13]

Twelve Data’s datasets and application tools support research, charting and product development. They do not themselves establish a brokerage account, custody arrangement or trade-execution service.[1]

Operator

Twelve Data Pte. Ltd., UEN 202006058W, Singapore.

Service scope

Financial market data, fundamentals and analytics through REST, WebSocket and spreadsheet add-ons.

Customer types

Developers; Researchers; Individual investors; Fintech companies; Financial institutions; Data distributors

Delivery

API; SaaS

Pricing publication

Public and quoted pricing

Platforms

Twelve Data API; Twelve Data WebSocket; Forex API v2; Excel Office Add-in; Excel Windows Add-in; Twelve Data Google Sheets Add-on

Integrations

REST; WebSocket; Python SDK; R library; Microsoft Excel; Google Sheets

Pricing scope

Free and priced credit-based plans; enterprise capacity, data add-ons and distribution rights can require additional charges or a quotation.

Implementation

Choose entitled datasets and identifiers, estimate endpoint weights, then configure REST requests or streaming subscriptions and quota monitoring.

Support

Help center, sales/customer forms and email; enhanced support and availability commitments depend on the selected business tier.

Permissions and regulatory scope

Data services; external display, onward distribution and exchange entitlements require rights appropriate to the selected use.

Provider metadata checked 21 Oct 2026Source 1Source 13Source 9Source 3Source 4Source 5Source 6Source 11Source 12Source 18Source 17

On termination, the terms require deletion within 30 days, with an exception for compliance audit trails.[13]

Counsel Jeff Nardinelli’s public biography reports that Nasdaq’s trade-secret lawsuit concerning alleged misuse of financial data was settled. The biography does not disclose the settlement date or terms. This is counsel’s account of the resolution; it is not a finding of liability, a description of present feed sourcing or an exchange license.[20]