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(V) time series for a stock, forex pair, crypto, ETF, or index. Returns open/high/low/close/volume bars at the requested interval. Use for price history, charting, and technical analys

No parameters required.

▶Try it
quote

Twelve Data quote snapshot for a symbol: latest price, day open/high/low, previous close, change, percent change, and volume.

No parameters required.

▶Try it
price

Twelve Data latest real-time price for a symbol (just the current price).

No parameters required.

▶Try it
eod

Twelve Data latest end-of-day (close) price for a symbol, with its date.

No parameters required.

▶Try it
exchange_rate

Twelve Data real-time forex/crypto exchange rate for a pair (symbol like "USD/JPY" or "BTC/USD").

No parameters required.

▶Try it
currency_conversion

Twelve Data currency conversion: converts an amount from one currency to another at the live rate (symbol like "USD/EUR").

No parameters required.

▶Try it
stocks

Twelve Data list of supported stock symbols, optionally filtered. Use to discover/verify available tickers and their exchange.

No parameters required.

▶Try it
forex_pairs

Twelve Data list of supported forex pairs, optionally filtered by base/quote currency.

No parameters required.

▶Try it
cryptocurrencies

Twelve Data list of supported cryptocurrency pairs, optionally filtered.

No parameters required.

▶Try it
etfs

Twelve Data list of supported ETF symbols, optionally filtered.

No parameters required.

▶Try it
indices

Twelve Data list of supported market indices, optionally filtered.

No parameters required.

▶Try it
earnings

Twelve Data earnings history for a specific symbol: report dates, EPS estimate vs actual, and surprise. Use for per-company earnings analysis.

No parameters required.

▶Try it
earnings_calendar

Twelve Data broad earnings calendar across companies for a date range — upcoming/recent earnings report dates with EPS estimates. Use for "which companies report earnings this week".

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, exchange, sector, industry, employees, website, and description.

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");