5分钟接入指南：从注册到第一次API调用

第一步：注册账号

访问 /register，使用邮箱注册。注册后立即获得一个 免费 API Key，每日 100 次调用，永久免费，无需信用卡。

第二步：获取 API Key

登录后进入 控制台。API Key 显示在页面顶部，形如 sk_xxxxxxxxxxxxxxxx。点击复制即可。

API Key 是敏感凭证，请勿提交到 Git 仓库或公开分享。建议使用环境变量管理。

第三步：首次 curl 调用

先试试无需鉴权的公开端点（用来验证网络与 DNS 是否畅通）：

curl https://api.fusionintel.net/v1/public/feargreed/latest

然后试试带鉴权的端点：

export FUSIONINTEL_API_KEY="sk_your_key"
curl -H "X-API-Key: $FUSIONINTEL_API_KEY" \
  "https://api.fusionintel.net/v1/stock/000001.SZ"

正常返回应该是一个 JSON 对象，包含 metadata 和 data 两个字段。

第四步：Python 调用

import os, requests

API_KEY = os.environ["FUSIONINTEL_API_KEY"]
r = requests.get(
    "https://api.fusionintel.net/v1/feargreed/a_stock_macro/shi_feargreedindex",
    headers={"X-API-Key": API_KEY},
    params={"period": "30d"},
    timeout=10,
)
r.raise_for_status()
print(r.json())

第五步：解读响应

标准响应结构：

{
  "metadata": {
    "category": "a_stock_macro",
    "code": "shi_feargreedindex",
    "period": "30d",
    "latest_date": "2026-05-15",
    "columns": ["date", "price", "feargreed_index"]
  },
  "data": [
    ["2026-05-15", 3368.21, 42.5],
    ...
  ]
}

关键字段：

• metadata.columns：行数据每一列的含义。
• metadata.latest_date：最新交易日。
• data：二维数组，每一行对应一个交易日。

常见坑点

• 403 / 401 错误：检查 Header 名是否为 X-API-Key（注意横线）。
• 429 错误：当日调用超过限额。免费版每天 0:00 重置（UTC+8）。
• 响应是空数组：检查 period 参数是否符合套餐限制（免费版固定 30d）。
• 非交易日返回旧数据：请核对实际数据日期；不同来源的日频更新进度可能不同。

继续阅读：Claude MCP 集成完整教程 · 完整 API 文档