Twelvedata

live FinanceMarkets

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

17 tools
0ms auth
free tier 50 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");