Twelve Data

此技能基于官方文档，提供 Twelve Data 的实用请求模式。

官方文档：

• - https://twelvedata.com/docs
• https://support.twelvedata.com/en/articles/5620512-how-to-create-a-request
• https://support.twelvedata.com/en/articles/5335783-trial

基础 URL

• - REST API：https://api.twelvedata.com
• WebSocket：wss://ws.twelvedata.com

身份验证

Twelve Data 支持两种身份验证方式：

1. 1. 查询参数

bash
curl https://api.twelvedata.com/price?symbol=AAPL&apikey=${TWELVEDATAAPIKEY}

1. 2. HTTP 标头（文档推荐）

bash
curl -H Authorization: apikey ${TWELVEDATAAPIKEY} \
https://api.twelvedata.com/price?symbol=AAPL

注意：

• - apikey=demo 可用于有限的试用/演示请求。
• 高级端点需要更高等级的套餐。

快速设置

在 OpenClaw 中配置：

json5
{
skills: {
entries: {
twelve-data: {
enabled: true,
apiKey: your-twelvedata-api-key,
env: {
TWELVEDATAAPIKEY: your-twelvedata-api-key
}
}
}
}
}

或者在 ~/.openclaw/.env 中：

bash
TWELVEDATAAPIKEY=your-api-key-here

核心端点（实用）

1) 最新价格（/price，每个代码 1 积分）

bash
curl https://api.twelvedata.com/price?symbol=AAPL&apikey=${TWELVEDATAAPIKEY}

2) 实时报价（/quote，每个代码 1 积分）

bash
curl https://api.twelvedata.com/quote?symbol=AAPL&apikey=${TWELVEDATAAPIKEY}

3) 历史 OHLCV（/time_series，每个代码 1 积分）

bash
curl https://api.twelvedata.com/timeseries?symbol=AAPL&interval=1day&outputsize=100&apikey=${TWELVEDATAAPI_KEY}

常用 interval 值：1min、5min、15min、30min、1h、2h、4h、1day、1week、1month

有用参数：

• - outputsize=1..5000
• startdate=YYYY-MM-DD 或日期时间
• enddate=YYYY-MM-DD 或日期时间
• timezone=Exchange|UTC|IANA_TZ
• format=JSON|CSV

4) 代码搜索（/symbol_search，每次请求 1 积分）

bash
curl https://api.twelvedata.com/symbolsearch?symbol=apple&apikey=${TWELVEDATAAPI_KEY}

5) 技术指标（通常每个代码 1 积分）

RSI：

bash
curl https://api.twelvedata.com/rsi?symbol=AAPL&interval=1day&timeperiod=14&seriestype=close&apikey=${TWELVEDATAAPIKEY}

MACD：

bash
curl https://api.twelvedata.com/macd?symbol=AAPL&interval=1day&seriestype=close&apikey=${TWELVEDATAAPI_KEY}

6) 基本面数据（受套餐限制，更高积分消耗）

收益（/earnings，Grow+ 套餐）：

bash
curl https://api.twelvedata.com/earnings?symbol=AAPL&apikey=${TWELVEDATAAPIKEY}

统计（/statistics，Pro+ 套餐）：

bash
curl https://api.twelvedata.com/statistics?symbol=AAPL&apikey=${TWELVEDATAAPIKEY}

利润表（/income_statement，Pro+ 套餐）：

bash
curl https://api.twelvedata.com/incomestatement?symbol=AAPL&apikey=${TWELVEDATAAPI_KEY}

资产负债表（/balance_sheet，Pro+ 套餐）：

bash
curl https://api.twelvedata.com/balancesheet?symbol=AAPL&apikey=${TWELVEDATAAPI_KEY}

现金流量表（/cash_flow，Pro+ 套餐）：

bash
curl https://api.twelvedata.com/cashflow?symbol=AAPL&apikey=${TWELVEDATAAPI_KEY}

股息：

bash
curl https://api.twelvedata.com/dividends?symbol=AAPL&startdate=1970-01-01&apikey=${TWELVEDATAAPI_KEY}

批量和多资产示例

在支持的端点上批量查询代码：

bash
curl https://api.twelvedata.com/timeseries?symbol=AAPL,EUR/USD,ETH/BTC:Huobi&interval=1min&apikey=${TWELVEDATAAPI_KEY}

资产代码模式：

• - 股票：AAPL
• 外汇：EUR/USD
• 加密货币：BTC/USD 或交易所限定交易对如 ETH/BTC:Huobi

WebSocket（流式传输）

连接：

text
wss://ws.twelvedata.com/v1/quotes/price?apikey=YOURAPIKEY

订阅消息：

json
{
action: subscribe,
params: {
symbols: AAPL,MSFT
}
}

可靠性指南

• - 始终处理响应中的 null 值。
• 对临时故障和 429 速率限制实施重试/退避策略。
• 缓存频繁读取以减少积分消耗。
• 在 Twelve Data 控制面板中检查当前的积分/速率限制（取决于套餐）。

技能使用工作流程

当用户请求市场数据分析时：

1. 1. 如果代码不明确，使用 /symbolsearch 解析代码。
2. 使用 /price 或 /quote 拉取最新上下文。
3. 使用 /timeseries 拉取选定间隔/日期范围的历史数据。
4. 如果请求技术分析，添加指标（/rsi、/macd 等）。
5. 仅当用户询问财务报表或估值背景时，才添加基本面端点。
6. 在输出中清晰报告端点、参数和套餐限制。