Twelve Data

Twelve Data Fundamentals API

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

GitHub OpenAPI

Operations 20

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /balance_sheet Get a company's balance sheet · Balance sheet #
Ask an LLM
“What are a company's total assets, liabilities and shareholders' equity?”
“Can I get quarterly instead of annual balance sheets?”
Tell an agent
Get the balance sheet for {symbol}.
Show {symbol}'s {period} balance sheets.
GET /balance_sheet/consolidated Get a company's raw consolidated balance sheet · Balance sheet consolidated #
Ask an LLM
“Where can I get the raw consolidated balance sheet as the company reported it?”
“Is there an unstandardized, consolidated version of the balance sheet data?”
Tell an agent
Get the raw consolidated balance sheet for {symbol}.
Pull {symbol}'s consolidated balance sheets between {start_date} and {end_date}.
GET /cash_flow Get a company's cash flow statement · Cash flow #
Ask an LLM
“How much cash did this company generate from operations last year?”
“What do a company's investing and financing cash flows look like by quarter?”
Tell an agent
Get the cash flow statement for {symbol}.
Show {symbol}'s {period} operating, investing and financing cash flows.
GET /cash_flow/consolidated Get a company's raw consolidated cash flow · Cash flow consolidated #
Ask an LLM
“Can I see the consolidated cash flow statement in its raw reported form?”
“Which call returns unstandardized consolidated cash flow data?”
Tell an agent
Get the raw consolidated cash flow statement for {symbol}.
Pull {symbol}'s consolidated cash flows from {start_date} to {end_date}.
GET /dividends Get a stock's dividend payment history · Dividends #
Ask an LLM
“How much has this stock paid in dividends over the last ten years?”
“When were the ex-dividend dates for a company's past payouts?”
Tell an agent
Show the dividend history for {symbol}.
List {symbol}'s dividends over the {range} range.
GET /dividends_calendar See upcoming and past dividends across companies · Dividends calendar #
Ask an LLM
“Which companies go ex-dividend next week?”
“Can I see every dividend event scheduled within a date range?”
Tell an agent
Show the dividends calendar from {start_date} to {end_date}.
List dividend events in {country} for the coming days.
GET /earnings Get a company's estimated vs actual EPS history · Earnings #
Ask an LLM
“Did this company beat or miss its EPS estimates in past quarters?”
“Where can I see a company's historical reported earnings per share?”
Tell an agent
Get the earnings history for {symbol}.
Show {symbol}'s estimated versus actual EPS for the last {outputsize} reports.
GET /earnings_calendar See which companies report earnings on given dates · Earnings calendar #
Ask an LLM
“Which companies are announcing earnings today?”
“Can I list all earnings announcements scheduled for next week?”
Tell an agent
Show the earnings calendar from {start_date} to {end_date}.
List today's earnings announcements on {exchange}.
GET /income_statement Get a company's income statement · Income statement #
Ask an LLM
“What were this company's revenue, expenses and net income last year?”
“Can I get quarterly income statements for a stock?”
Tell an agent
Get the income statement for {symbol}.
Show {symbol}'s {period} revenue and net income.
GET /income_statement/consolidated Get a company's raw consolidated income statement · Income statement consolidated #
Ask an LLM
“Is the consolidated income statement available in raw, as-reported form?”
“Which endpoint gives unstandardized consolidated revenue and net income?”
Tell an agent
Get the raw consolidated income statement for {symbol}.
Pull {symbol}'s consolidated income statements from {start_date} to {end_date}.
GET /ipo_calendar See past and upcoming IPOs · IPO calendar #
Ask an LLM
“Which companies are going public this month?”
“What IPOs happened on a given exchange recently?”
Tell an agent
Show the IPO calendar from {start_date} to {end_date}.
List upcoming IPOs in {country}.
GET /key_executives List a company's key executives · Key executives #
Ask an LLM
“Who are the top executives running this company?”
“What titles and roles do a company's leaders hold?”
Tell an agent
List the key executives of {symbol}.
Show names and titles of {symbol}'s leadership team.
GET /last_change/{endpoint} Check when a fundamentals dataset last changed · Last changes #
Ask an LLM
“How do I know whether fundamental data has changed before re-fetching it?”
“When was a company's statistics or profile data last updated?”
Tell an agent
Show the last change timestamps for the {endpoint} dataset.
Check when {endpoint} data for {symbol} was last updated.
GET /market_cap Get a company's market capitalization history · Market capitalization #
Ask an LLM
“What was this company's market cap a year ago?”
“Can I chart how a company's market value has changed over time?”
Tell an agent
Get the market capitalization history for {symbol}.
Show {symbol}'s market cap between {start_date} and {end_date}.
GET /press_releases Get a company's official press releases · Press releases #
Ask an LLM
“What press releases has this company published recently?”
“Can I filter corporate announcements by language and date?”
Tell an agent
List recent press releases from {symbol}.
Show {symbol}'s press releases in {language} since {start_date}.
GET /profile Get a company's business profile · Profile #
Ask an LLM
“What industry and sector is this company in, and who is the CEO?”
“Where is a company headquartered?”
Tell an agent
Get the company profile for {symbol}.
Show the sector, industry and headquarters of {symbol}.
GET /splits Get a stock's split history · Splits #
Ask an LLM
“Has this stock ever split, and by what factor?”
“When were a company's past stock splits?”
Tell an agent
Show the split history for {symbol}.
List {symbol}'s stock splits between {start_date} and {end_date}.
GET /splits_calendar See upcoming and past stock splits market-wide · Splits calendar #
Ask an LLM
“Which companies have stock splits scheduled this month?”
“Can I see all split events across the market within a date window?”
Tell an agent
Show the splits calendar from {start_date} to {end_date}.
List upcoming stock splits on {exchange}.
GET /statistics Get key valuation and financial statistics · Statistics #
Ask an LLM
“What is this stock's P/E ratio, profit margin and other key stats?”
“Where can I get a one-shot snapshot of a company's valuation metrics?”
Tell an agent
Get the key statistics for {symbol}.
Show valuation metrics and margins for {symbol}.

Documentation

📖
Documentation
https://twelvedata.com/docs#time-series
📖
Documentation
https://twelvedata.com/docs#core-data
📖
Documentation
https://twelvedata.com/docs#technical-indicators
📖
Documentation
https://twelvedata.com/docs#reference-data
📖
Documentation
https://twelvedata.com/docs#fundamentals

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/openapi/twelvedata-fundamentals-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/overlays/twelvedata-fundamentals-api-overlay.yaml
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/collections/twelvedata.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/collections/twelvedata.opencollection.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/twelvedata:twelvedata-fundamentals-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twelvedata-fundamentals-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Twelvedata Fundamentals API
  version: '1.0'
  description: 'Operations tagged fundamentals across 2 of this provider''s published API definitions: twelvedata-openapi-original.json, twelvedata-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.twelvedata.com/
- url: https://api.twelvedata.com
  description: Twelve Data REST base URL
tags:


# --- truncated at 32 KB (322 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/openapi/twelvedata-fundamentals-api-openapi.yml