Financial AI Agent

查询金融行情数据（股票、ETF、虚拟货币等），直接调用 API 获取。

🚀 快速开始

1. 查询行情

直接告诉我股票代码或名称即可查询：

| 用户说 | 我执行 | |--------|--------| | 查询茅台 | curl .../quotes/SH600519 | | 查腾讯 | curl .../quotes/0700.HK | | 英伟达最近一周 | curl .../quotes/NVDA?days=7 | | 上证指数 | curl .../quotes/SH000001 |

2. 配置自己的 Key

⚠️ 提醒：安装本 skill 后，建议配置自己的 key（默认 key 有并发限制）。

获取 key：访问 https://api.financialagent.cc 注册后获取

用户只需告诉我：

• 「我的faa的key是 XXX」
• 或「帮我把faa的key换成 XXX」

我帮您存到 OpenClaw 配置文件中（推荐）：

# 读取现有配置
config=$(cat ~/.openclaw/openclaw.json)

# 添加或更新 faa key（使用 jq）
jq '. + {"custom": {"financial_agent_key": "XXX"}}' ~/.openclaw/openclaw.json > temp.json && mv temp.json ~/.openclaw/openclaw.json

存好后，调用时读取：

# 从 OpenClaw 配置读取 key
FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)

# 调用 API
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/SH600519"

---

API Key 说明

默认 Key

K6lncNNrMAahJccarH63P1ImRMIPCqq7

（免费体验，有并发限制）

自定义 Key

获取方式： 访问 https://api.financialagent.cc 注册后获取

配置后调用方式：

# 从 OpenClaw 配置读取 key
FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/SH600519"

---

完整调用示例

获取日线数据（默认最近30天）

FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/SH600519"

获取指定日期范围

FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/0700.HK?start_date=2026-03-01&end_date=2026-03-20"

获取最近N天

FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/AAPL?days=10"

---

常用股票代码

| 名称 | 代码 | |------|------| | 贵州茅台 | SH600519 | | 腾讯控股 | 0700.HK | | 阿里巴巴 | 9988.HK | | 美团 | 3690.HK | | 苹果 | AAPL | | 微软 | MSFT | | 英伟达 | NVDA | | 特斯拉 | TSLA | | 上证指数 | SH000001 | | 深证成指 | SZ399001 |

---

API 地址

https://api.financialagent.cc/api/v1/quotes/{symbol}

参数说明

| 参数 | 说明 | 示例 | |------|------|------| | symbol | 股票代码 | SH600519, 0700.HK, AAPL | | days | 最近N天 | days=10 | | start_date | 开始日期 | start_date=2026-03-01 | | end_date | 结束日期 | end_date=2026-03-20 |

返回字段说明

| 字段 | 说明 | 示例 | |------|------|------| | composite_score | 综合得分 (0-100)，整体评估，非单日 | 56 | | composite_level | 评级 (S/A/B/C/D)，股票整体评级 | S |

评级对应关系

| 等级 | 得分范围 | 说明 | |------|----------|------| | S | 90-100 | 极强 | | A | 70-89 | 强 | | B | 50-69 | 中等 | | C | 30-49 | 弱 | | D | 0-29 | 极弱 |

返回数据解析示例

API 返回的 meta 字段包含综合评分（整体评估，非单日数据）：

{
  "meta": {
    "symbol": "00700",
    "name": "腾讯控股",
    "count": 10,
    "composite_score": 49,
    "composite_level": "B"
  }
}

解读：

• 综合得分 49 分（整体评估）
• 评级 B（中等），说明该股票整体表现中等