Twelvedata

A comprehensive financial data interface that pulls real-time quotes, historical time series, and market data from TwelveData's API. Handles stocks, forex pairs, and commodities with proper symbol formatting and batch processing for multi-asset queries. The skill documentation is notably thorough, with clear boundaries between TwelveData and CoinGecko usage (traditional markets vs crypto), common mistake prevention, and specific symbol references for commodities like gold (XAU/USD) and oil (WTI/USD). Smart tool routing based on query type, from single quotes to batch comparisons to historical charts. Solid choice for building financial dashboards or market analysis features without dealing with API quirks directly.

skills.sh installs: 7.7K
GitHub stars: 32
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add starchild-ai-agent/official-skills --skill twelvedata --agent claude-code

Installs into .claude/skills of the current project.

Files

Twelve Data

Stocks, forex, and commodities price data. Traditional markets only — not for crypto.

Script Usage

This skill ships a single exports.py with all functions. Call it from a bash block:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/twelvedata")
from exports import twelvedata_price, twelvedata_quote, twelvedata_time_series

# Single quote
print(twelvedata_quote(symbol="AAPL"))

# Time series (last 30 daily candles)
series = twelvedata_time_series(symbol="AAPL", interval="1day", outputsize=30)
print(json.dumps(series.get("values", [])[:3], indent=2))
EOF

Available functions in exports.py: twelvedata_price, twelvedata_quote, twelvedata_time_series, twelvedata_eod, twelvedata_quote_batch, twelvedata_price_batch, twelvedata_search, twelvedata_stocks, twelvedata_forex_pairs, twelvedata_exchanges. Read exports.py directly when you need exact signatures.

Function Reference (signatures)

All functions are in exports.py. Symbols use TwelveData format (e.g. AAPL, EUR/USD, XAU/USD). Use prepost=True for pre/post-market data on US stocks.

SKILL.md on GitHub