twelvedata

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Twelve Data

Twelve Data provides stocks and forex market data including real-time quotes, historical time series, and reference data. Use for traditional markets (stocks, forex) instead of crypto.

Twelve Data提供股票和外汇市场数据，包括实时报价、历史时间序列以及参考数据。适用于传统市场（股票、外汇），而非加密货币。

When to Use Twelve Data

何时使用Twelve Data

Use Twelve Data for:

Stock prices - Real-time and historical stock quotes
Forex prices - Currency pair quotes and time series
Time series data - OHLCV historical data
Reference data - Stock lists, forex pairs, exchanges
Search - Find stock symbols and company names

Important: Use Twelve Data for stocks and forex only. For crypto, use CoinGecko.

使用Twelve Data可用于：

股票价格 - 实时及历史股票报价
外汇价格 - 货币对报价与时间序列
时间序列数据 - OHLCV历史数据
参考数据 - 股票列表、外汇货币对、交易所信息
搜索功能 - 查找股票代码与公司名称

重要提示：Twelve Data仅适用于股票和外汇数据。加密货币数据请使用CoinGecko。

Common Workflows

常见工作流

Get Stock Price

获取股票价格

twelvedata_quote(symbol="AAPL")  # Apple real-time quote
twelvedata_price(symbol="MSFT")  # Microsoft current price
twelvedata_quote(symbol="TSLA")  # Tesla quote with full details

twelvedata_quote(symbol="AAPL")  # 苹果公司实时报价
twelvedata_price(symbol="MSFT")  # 微软当前价格
twelvedata_quote(symbol="TSLA")  # 特斯拉完整详情报价

Get Forex Price

获取外汇价格

twelvedata_quote(symbol="EUR/USD")  # Euro to USD
twelvedata_quote(symbol="GBP/JPY")  # British Pound to Japanese Yen

twelvedata_quote(symbol="EUR/USD")  # 欧元兑美元
twelvedata_quote(symbol="GBP/JPY")  # 英镑兑日元

Historical Data

历史数据

twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="compact")  # Last 30 days
twelvedata_time_series(symbol="MSFT", interval="1h", outputsize="full")  # 5000 hourly candles
twelvedata_eod(symbol="GOOGL")  # End of day price

twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="compact")  # 最近30天数据
twelvedata_time_series(symbol="MSFT", interval="1h", outputsize="full")  # 5000条小时级K线数据
twelvedata_eod(symbol="GOOGL")  # 当日收盘价

Batch Queries (Efficient)

批量查询（高效）

twelvedata_quote_batch(symbols=["AAPL", "MSFT", "GOOGL", "TSLA"])  # Up to 120 symbols
twelvedata_price_batch(symbols=["AAPL", "MSFT"])  # Just prices

twelvedata_quote_batch(symbols=["AAPL", "MSFT", "GOOGL", "TSLA"])  # 最多支持120个代码
twelvedata_price_batch(symbols=["AAPL", "MSFT"])  # 仅获取价格

Search for Symbols

搜索代码

twelvedata_search(query="Apple")  # Find AAPL
twelvedata_search(query="Microsoft")  # Find MSFT
twelvedata_search(query="EUR")  # Find EUR forex pairs

twelvedata_search(query="Apple")  # 查找AAPL
twelvedata_search(query="Microsoft")  # 查找MSFT
twelvedata_search(query="EUR")  # 查找欧元相关外汇货币对

Reference Data

参考数据

twelvedata_stocks(exchange="NASDAQ")  # All NASDAQ stocks
twelvedata_forex_pairs()  # All forex pairs
twelvedata_exchanges(type="stock")  # All stock exchanges

twelvedata_stocks(exchange="NASDAQ")  # 纳斯达克所有股票
twelvedata_forex_pairs()  # 所有外汇货币对
twelvedata_exchanges(type="stock")  # 所有股票交易所

Symbol Format

代码格式

Stocks

股票

Use standard ticker symbols:

```
AAPL
```
- Apple
```
MSFT
```
- Microsoft
```
TSLA
```
- Tesla
```
GOOGL
```
- Google
```
AMZN
```
- Amazon

使用标准股票代码：

```
AAPL
```
- 苹果公司
```
MSFT
```
- 微软公司
```
TSLA
```
- 特斯拉公司
```
GOOGL
```
- 谷歌公司
```
AMZN
```
- 亚马逊公司

Forex Pairs

外汇货币对

Use slash format:

```
EUR/USD
```
- Euro to US Dollar
```
GBP/JPY
```
- British Pound to Japanese Yen
```
USD/CHF
```
- US Dollar to Swiss Franc

使用斜杠格式：

```
EUR/USD
```
- 欧元兑美元
```
GBP/JPY
```
- 英镑兑日元
```
USD/CHF
```
- 美元兑瑞郎

Intervals

时间间隔

Intraday

日内

```
1min
```
,
```
5min
```
,
```
15min
```
,
```
30min
```
```
1h
```
,
```
2h
```
,
```
4h
```
,
```
8h
```

```
1min
```
,
```
5min
```
,
```
15min
```
,
```
30min
```
```
1h
```
,
```
2h
```
,
```
4h
```
,
```
8h
```

Daily and Above

日线及以上

```
1day
```
- Daily candles
```
1week
```
- Weekly candles
```
1month
```
- Monthly candles

```
1day
```
- 日K线
```
1week
```
- 周K线
```
1month
```
- 月K线

Output Sizes

输出规模

```
compact
```
- Last 30 data points (default, faster)
```
full
```
- Up to 5000 data points (for deep analysis)

```
compact
```
- 最近30条数据（默认，速度更快）
```
full
```
- 最多5000条数据（用于深度分析）

Response Fields

响应字段

Quote Response

报价响应

```
symbol
```
- Ticker symbol
```
name
```
- Company/pair name
```
price
```
- Current price
```
open
```
,
```
high
```
,
```
low
```
,
```
close
```
- OHLC data
```
volume
```
- Trading volume
```
change
```
- Price change
```
percent_change
```
- Percentage change
```
timestamp
```
- Last update time

```
symbol
```
- 股票/货币对代码
```
name
```
- 公司/货币对名称
```
price
```
- 当前价格
```
open
```
,
```
high
```
,
```
low
```
,
```
close
```
- OHLC数据
```
volume
```
- 交易量
```
change
```
- 价格变动额
```
percent_change
```
- 价格变动百分比
```
timestamp
```
- 最后更新时间

Time Series Response

时间序列响应

```
datetime
```
- Timestamp
```
open
```
,
```
high
```
,
```
low
```
,
```
close
```
- OHLC
```
volume
```
- Trading volume

```
datetime
```
- 时间戳
```
open
```
,
```
high
```
,
```
low
```
,
```
close
```
- OHLC数据
```
volume
```
- 交易量

Important Notes

重要注意事项

API Key: Requires TWELVEDATA_API_KEY environment variable (Pro subscription)
Crypto: DO NOT use Twelve Data for crypto. Use CoinGecko instead.
Fundamental data: Fundamental data tools (income_statement, balance_sheet, etc.) require Grow/Pro+/Ultra/Enterprise tiers and are not included in this skill
Rate limits: Be mindful of API rate limits. Use batch endpoints for multiple symbols.
Real-time: Quotes are near real-time (typically 15-minute delay for free tier, real-time for Pro)

API密钥：需要设置TWELVEDATA_API_KEY环境变量（专业订阅版）
加密货币：请勿使用Twelve Data获取加密货币数据，请改用CoinGecko。
基本面数据：基本面数据工具（income_statement、balance_sheet等）需要Grow/Pro+/Ultra/Enterprise套餐，本技能不包含这些功能
速率限制：请注意API速率限制。批量查询接口适用于多代码查询。
实时性：报价为准实时数据（免费版通常有15分钟延迟，专业版为实时数据）

Workflow Examples

工作流示例

Stock Analysis

股票分析

Search for symbol:
```
twelvedata_search(query="Apple")
```
Get current quote:
```
twelvedata_quote(symbol="AAPL")
```

Get historical data:

twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="compact")

搜索代码：
```
twelvedata_search(query="Apple")
```
获取当前报价：
```
twelvedata_quote(symbol="AAPL")
```

获取历史数据：

twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="compact")

Forex Analysis

外汇分析

Get forex pair:
```
twelvedata_quote(symbol="EUR/USD")
```

Get historical:

twelvedata_time_series(symbol="EUR/USD", interval="1h", outputsize="compact")

获取外汇货币对报价：
```
twelvedata_quote(symbol="EUR/USD")
```

获取历史数据：

twelvedata_time_series(symbol="EUR/USD", interval="1h", outputsize="compact")

Portfolio Check

投资组合检查

Batch quote:

twelvedata_quote_batch(symbols=["AAPL", "MSFT", "GOOGL", "TSLA"])

Analyze each stock individually if needed

批量查询报价：

twelvedata_quote_batch(symbols=["AAPL", "MSFT", "GOOGL", "TSLA"])

如有需要，对单只股票进行单独分析

Market Scan

市场扫描

List all stocks:
```
twelvedata_stocks(exchange="NASDAQ")
```
Filter and analyze specific symbols

列出所有股票：
```
twelvedata_stocks(exchange="NASDAQ")
```
筛选并分析特定代码