Twelvedata

liveFinanceMarkets

Twelve Data — real-time and historical OHLC, quotes, forex rates, earnings calendars, dividends, and company profiles for stocks/ETFs/crypto/indices.

17tools
0msauth
free tier50 calls/day

Tools

time_series

Twelve Data OHLC time series for a stock, forex, crypto, or ETF symbol. Requires symbol and interval (e.g. '1min', '1h', '1day'). Returns timestamped open/high/low/close + volume.

No parameters required.

▶Try it
quote

Twelve Data real-time quote snapshot for a symbol: open, high, low, close, volume, 52-week range, exchange, currency. Use for a full current-day market snapshot.

No parameters required.

▶Try it
price

Twelve Data latest trade price for a single symbol (stock, forex, crypto, ETF). Returns a single numeric price field. Lightest endpoint for current-price lookups.

No parameters required.

▶Try it
eod

Twelve Data end-of-day closing quote for a symbol. Returns the last closing price, volume, and date. Use for daily settlement prices rather than intraday data.

No parameters required.

▶Try it
exchange_rate

Twelve Data live forex exchange rate for a currency pair symbol (e.g. 'EUR/USD'). Optional dp (decimal places) and timezone. Returns rate, timestamp, and pair identifiers.

No parameters required.

▶Try it
currency_conversion

Twelve Data real-time currency conversion: pass a forex pair symbol (e.g. 'EUR/USD') and an amount to get the converted value at the current exchange rate.

No parameters required.

▶Try it
stocks

Twelve Data reference list of all supported stock symbols with exchange and country metadata. Use to discover or validate tickers before querying price endpoints.

No parameters required.

▶Try it
forex_pairs

Twelve Data reference list of all supported forex currency pairs (e.g. EUR/USD). Use to enumerate or validate pair symbols before querying exchange_rate or time_series.

No parameters required.

▶Try it
cryptocurrencies

Twelve Data reference list of all supported cryptocurrency symbols with exchange metadata. Use to discover or validate crypto tickers before querying price endpoints.

No parameters required.

▶Try it
etfs

Twelve Data reference list of supported ETF symbols (64,000+ listings worldwide) with exchange and country metadata — paged, default 200 rows, `count` is the total matched. Filter by symbol (e.g. "SPY

No parameters required.

▶Try it
indices

Twelve Data reference list of supported market index symbols with exchange metadata — about 1,300 NON-US indices (e.g. N225 Nikkei 225, 000001 SSE Composite, NSEI Nifty 50), paged, default 200 rows. F

No parameters required.

▶Try it
earnings

Twelve Data earnings history and upcoming earnings dates for a stock symbol: EPS estimate, EPS actual, surprise percentage, and report date per quarter.

No parameters required.

▶Try it
earnings_calendar

Twelve Data broad earnings calendar — upcoming and recent earnings announcements across all covered symbols. Returns symbol, date, EPS estimate, and time of day (before/after market).

No parameters required.

▶Try it
dividends

Twelve Data historical dividends for a stock / ETF symbol: ex-date, amount, frequency. Use for income analysis and dividend-capture strategies on Twelve-Data-covered symbols.

No parameters required.

▶Try it
splits

Twelve Data historical stock splits for a symbol: ratio, date. Use to adjust historical Twelve Data prices across split events.

No parameters required.

▶Try it
profile

Twelve Data company profile for a stock symbol: name, sector, industry, employees, CEO, description, website, address, and exchange listing details.

No parameters required.

▶Try it
technical_indicator

Compute a technical indicator time series for a stock/forex/crypto symbol via Twelve Data — RSI, SMA, EMA, MACD, Bollinger Bands (bbands), ADX, ATR, Stochastic, CCI, and more. PREFER for "RSI(14) of A

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/twelvedata/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/twelvedata/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"time_series","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("time_series", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("twelve data — real-time and historical ohlc, quotes, forex rates, earnings calendars, dividends, and company profiles for stocks/etfs/crypto/indices");