Twelve Data

股票、外匯與商品價格資料。僅限傳統市場 — 不適用於加密貨幣。

腳本使用方式

此技能提供單一 exports.py 檔案，包含所有函式。請透過 bash 區塊呼叫：

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

# 單一報價
print(twelvedata_quote(symbol="AAPL"))

# 時間序列（最近30根日K）
series = twelvedata_time_series(symbol="AAPL", interval="1day", outputsize=30)
print(json.dumps(series.get("values", [])[:3], indent=2))
EOF

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。需要確切簽名時請直接閱讀 exports.py。

函式參考（簽名）

所有函式皆位於 exports.py。代號使用 TwelveData 格式（例如 AAPL、EUR/USD、XAU/USD）。美股可使用 prepost=True 取得盤前/盤後資料。

函式	說明
`twelvedata_price(symbol, prepost=False)`	單一代號的當前價格。
`twelvedata_price_batch(symbols, prepost=False)`	多個代號的價格（`symbols` 為逗號分隔字串）。
`twelvedata_quote(symbol, prepost=False)`	詳細報價：價格、成交量、52週高低、漲跌幅%。
`twelvedata_quote_batch(symbols, prepost=False)`	多個代號的詳細報價。
`twelvedata_time_series(symbol, interval='1day', outputsize=30, start_date=None, end_date=None, prepost=False)`	OHLCV K線。`interval` 可為 `1min`/`5min`/`15min`/`30min`/`1h`/`2h`/`4h`/`1day`/`1week`/`1month`。
`twelvedata_eod(symbol, date=None, prepost=False)`	指定日期的收盤價（預設為最新）。
`twelvedata_search(query)`	依名稱或代號搜尋標的。
`twelvedata_stocks(exchange=None, country=None)`	列出支援的股票（可篩選）。
`twelvedata_forex_pairs()`	列出所有支援的外匯對。
`twelvedata_exchanges()`	列出支援的交易所。

關鍵字 → 工具對照

使用者詢問	工具	不要用這個
"AAPL 股價", "current price"（單一）	`twelvedata_quote`	不要用 `twelvedata_price`（資訊較少）
"只要價格數字"	`twelvedata_price`	—
"多隻股票對比"（2個以上代號）	`twelvedata_quote_batch`	不要多次呼叫 `twelvedata_quote`
"K線", "歷史資料", "time series"	`twelvedata_time_series`	—
"收盤價"	`twelvedata_eod`	—
"找股票代碼"	`twelvedata_search`	—
"NASDAQ 有哪些股票"	`twelvedata_stocks`	—
"匯率", "EUR/USD"	`twelvedata_quote(symbol="EUR/USD")`	—
"外匯對列表"	`twelvedata_forex_pairs`	—
"金價", "oil price"	`twelvedata_quote(symbol="XAU/USD")`	不要用 CoinGecko
"BTC 價格", 任何加密貨幣	CoinGecko `coin_price`	❌ 絕對不要用 twelvedata 查加密貨幣

TwelveData vs CoinGecko — 界線

資產類別	使用	原因
股票（AAPL, TSLA）	TwelveData	CoinGecko 沒有股票
外匯（EUR/USD）	TwelveData	CoinGecko 沒有外匯
商品（黃金、原油）	TwelveData	CoinGecko 沒有商品
加密貨幣（BTC, ETH, SOL）	CoinGecko	TwelveData 加密貨幣資料有限/不可靠

常見錯誤 — 呼叫前請閱讀

❌ 錯誤 1：用 TwelveData 查加密貨幣

使用者："BTC 價格"
❌ 錯誤：twelvedata_quote(symbol="BTC/USD")
✅ 正確：coin_price(ids="bitcoin")  ← CoinGecko

❌ 錯誤 2：多檔股票分別呼叫 quote

使用者："AAPL MSFT GOOGL 現在什麼價"
❌ 錯誤：twelvedata_quote("AAPL"), twelvedata_quote("MSFT"), twelvedata_quote("GOOGL")  ← 3次呼叫
✅ 正確：twelvedata_quote_batch(symbols=["AAPL", "MSFT", "GOOGL"])  ← 1次呼叫，最多120個代號

❌ 錯誤 3：外匯對缺少斜線

❌ 錯誤：twelvedata_quote(symbol="EURUSD")
✅ 正確：twelvedata_quote(symbol="EUR/USD")  ← 一律使用斜線格式

另外：USD/CNH 而非 USDCNH，GBP/JPY 而非 GBPJPY。

❌ 錯誤 4：期望 quote 提供買賣價

❌ 錯誤："EUR/USD 買價 1.0850，賣價 1.0852"  ← quote 只回傳收盤價
✅ 正確："EUR/USD 當前價格：1.0851（收盤/最後價格 — 無買賣價差）"

❌ 錯誤 5：錯誤的間隔格式

❌ 錯誤：twelvedata_time_series(interval="1D")  ← 大寫
✅ 正確：twelvedata_time_series(interval="1day")

有效值：1min, 5min, 15min, 30min, 1h, 2h, 4h, 8h, 1day, 1week, 1month

❌ 錯誤 6：compact 就夠用卻用了 full

使用者："AAPL 最近走勢"
❌ 錯誤：twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="full")  ← 5000根K線
✅ 正確：twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="compact")  ← 30根K線

只有在使用者明確需要深度歷史資料時才使用 full。

代號參考

商品（已驗證）

資產	代號
黃金	`XAU/USD`
白銀	`XAG/USD`
鉑金	`XPT/USD`
鈀金	`XPD/USD`
原油（WTI）	`WTI/USD`
天然氣	`NG/USD`

盤前/盤後資料

twelvedata_quote(symbol="AAPL", prepost=true)
twelvedata_time_series(symbol="AAPL", interval="1min", prepost=true)

當資料可用時，會回傳 premarket_change、premarket_change_percent、postmarket_change、postmarket_change_percent。

輸出大小

compact — 最近30筆資料（預設，速度較快）。適用於「最近走勢」。
full — 最多5000筆資料。適用於深度分析/繪圖。

Proxy 安全使用方式

Agent 工具呼叫：一律優先使用 twelvedata_* 工具（此技能）。
平台程式碼（skills/, tools/）：使用 core.http_client。
工作區腳本（bash）：請勿直接呼叫 TwelveData。請使用技能工具。

複合查詢

股票比較

1. twelvedata_quote_batch(symbols=["AAPL", "MSFT", "GOOGL", "TSLA"])
2. twelvedata_time_series(symbol="AAPL", interval="1day", outputsize="compact")  ← 僅針對使用者最關心的一檔

宏觀儀表板（股票 + 外匯 + 商品）

1. twelvedata_quote_batch(symbols=["SPY", "QQQ"])          → 美國指數
2. twelvedata_quote_batch(symbols=["EUR/USD", "USD/JPY"])   → 外匯
3. twelvedata_quote(symbol="XAU/USD")                       → 黃金

貨幣對	代號
歐元 / 美元	`EUR/USD`
英鎊 / 美元	`GBP/USD`
美元 / 日圓	`USD/JPY`
美元 / 離岸人民幣	`USD/CNH`

twelvedata

相關技能