用途:提供传统金融市场(股票、外汇、商品)的价格数据,包括实时报价与历史 K 线;不适用于加密货币。
主要能力:exports.py 中提供 twelvedata_price(单一当前价)、twelvedata_price_batch(多标的当前价)、twelvedata_quote(详细报价,含成交量、52 周高低、涨跌幅)、twelvedata_quote_batch(多标的详细报价,一次最多 120 个)、twelvedata_time_series(OHLCV K 线)、twelvedata_eod(收盘价)、twelvedata_search(按名称或代码搜索)、twelvedata_stocks(交易所/国家筛选股票列表)、twelvedata_forex_pairs、twelvedata_exchanges。
使用方式:在 bash 中运行 python3,将 /data/workspace/skills/twelvedata 加入 sys.path 后从 exports 导入函数;符号用 TwelveData 格式,如 AAPL、EUR/USD、XAU/USD。美股可用 prepost=True 获取盘前盘后数据。时间序列 interval 支持 1min、5min、15min、30min、1h、2h、4h、8h、1day、1week、1month;outputsize 用 compact(默认 30 个点)或 full(最多 5000 个点)。
适用场景:查询单只或多只股票报价、货币对与贵金属/原油报价、历史走势、收盘价、代码检索及交易所/外汇对列表。多标的比较应使用 batch 函数而非多次单独调用。
限制:加密货币应改用 CoinGecko,Twelve Data 的加密数据有限且不可靠;外汇符号必须带斜杠(EUR/USD),不能写成 EURUSD;报价只返回收盘/最新价,不提供买卖价差;interval 不能使用大写(1D 错误);非必要时避免 outputsize=full。工作区脚本不要直接调用 Twelve Data,应使用本技能工具;平台代码使用 core.http_client。未提供收费、限速与密钥配置的具体说明。