API 文档

智能体金融工坊完整接入参考——REST API · MCP · Skills · and more

Base URL

https://api.fusionintel.net/v1

认证方式

除标为「无需认证」的公开端点外，数据 API 请求均需在 HTTP Header 中携带 API Key：

Auth Examplebash

curl -L -H "X-API-Key: sk_your_api_key_here" \
  "https://api.fusionintel.net/v1/stock/000001.SZ?period=30d"

注册后即获免费 API Key。请妥善保管，不要在客户端代码中暴露。

API 直接以 JSON 形式返回响应体（Content-Type: application/json），无需跟随重定向。返回结构通常为 { metadata, data: [[...rows]] } 表格格式。响应头 Cache-Control 为 private, no-store。

公开端点

GET/v1/public/feargreed/latest免认证

公开端点（无需 API Key）：获取最新 A 股宏观恐贪指数快照，可直接用于网页/小程序展示

请求示例

Public Endpoint — No Auth Requiredbash

# 公开端点 — 无需 API Key（用于试用 / 引流 / 网站首页展示）
curl https://api.fusionintel.net/v1/public/feargreed/latest

响应示例

Public Snapshot Responsejson

{
  "category": "a_stock_macro",
  "code": "shi_feargreedindex",
  "latest_date": "2026-05-09",
  "sh_index": 3245.68,
  "feargreed_index": 42.5,
  "sentiment_label": "中性",
  "source": "latest_json",
  "fetched_at": "2026-05-12T09:30:00+00:00",
  "stale_seconds": 12,
  "is_stale": false
}

A股基本数据

GET/v1/stock/{code}

获取A股价格数据，免费版固定 period=30d；实际行数和复权方式以响应元数据为准。

参数: period: latest / 7d / 30d / 180d / 1y / 3y / all；Free仅30d，Pro最长1y，Pro+最长3y，Pro+ Max全历史

请求示例

A-Share Basic Data API Examplebash

# 免费版：获取平安银行最近30个交易日价格（固定30d）
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/stock/000001.SZ

# Pro版：获取最近1年价格数据
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/stock/000001.SZ?period=1y"

响应示例

Response (inline JSON)json

{
  "metadata": {
    "symbol": "000001.SZ",
    "name": "平安银行",
    "period": "1y",
    "latest_date": "2026-04-24",
    "columns": ["date", "open", "close", "low", "high", "high_limit", "low_limit"]
  },
  "data": [
    ["2026-04-23", 11.20, 11.35, 11.10, 11.40, 12.49, 10.22],
    ["2026-04-24", 11.35, 11.28, 11.20, 11.42, 12.49, 10.22]
  ]
}

A股宏观恐贪指数

GET/v1/feargreed/a_stock_macro/shi_feargreedindex

获取A股宏观恐贪指数时间序列（code=shi_feargreedindex）

参数: period受套餐限制：Free最长30d，Pro最长1y，Pro+最长3y，Pro+ Max全历史

请求示例

A-Share Macro Fear & Greed API Examplebash

# A 股宏观恐贪只有一个 code:shi_feargreedindex(上证恐贪指数)
# (单 code 类别没有 /list 端点,代码固定)

# 获取最近 30 个交易日的恐贪走势
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/a_stock_macro/shi_feargreedindex?period=30d"

响应示例

响应（按 metadata.columns 解析二维数组）json

{
  "metadata": {
    "category": "a_stock_macro",
    "category_name": "A股宏观恐贪指数",
    "code": "shi_feargreedindex",
    "name": "上证恐贪指数",
    "period": "30d",
    "latest_date": "2026-05-13",
    "columns": ["date", "price", "feargreed_index"]
  },
  "data": [
    ["2026-04-14", 4128.31, 72.45],
    ["2026-04-15", 4156.02, 78.12],
    ["...", 0, 0],
    ["2026-05-13", 4242.572, 95.11]
  ]
}

A股板块恐贪指数

GET/v1/feargreed/a_stock_sectors/list Pro

获取A股板块恐贪指数板块列表

参数: 返回当前板块目录；代码如sector0001

GET/v1/feargreed/a_stock_sectors/{sector_code} Pro

获取指定A股板块恐贪指数时间序列

参数: sector_code从列表获取；Pro最长1y，Pro+最长3y，Pro+ Max全历史

请求示例

A-Share Sector Fear & Greed API Examplebash

# 获取 A 股板块列表(407 个,代码格式 sectorXXXX 全小写)
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/feargreed/a_stock_sectors/list

# 获取指定板块恐贪指数(示例:sector0001 = 参股保险)
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/a_stock_sectors/sector0001?period=1y"

响应示例

响应：列表为对象数组，时间序列为二维数组json

// 1. /list 响应:对象数组
{
  "metadata": {
    "category": "a_stock_sectors",
    "category_name": "A股板块恐贪指数",
    "count": 407
  },
  "data": [
    {"code": "sector0001", "name": "参股保险"},
    {"code": "sector0002", "name": "天津自贸区"}
  ]
}

// 2. 单板块时间序列响应:TablePayload(data 是二维数组)
{
  "metadata": {
    "category": "a_stock_sectors",
    "code": "sector0001",
    "name": "参股保险",
    "period": "latest",
    "latest_date": "2026-05-13",
    "columns": ["date", "price", "feargreed_index"]
  },
  "data": [["2026-05-13", 1465.97, 9.76]]
}

A股个股恐贪指数

GET/v1/feargreed/a_stock_individual/list Pro+ Max

获取A股个股恐贪指数标的列表 · Max全历史

参数: 仅Pro+ Max；代码如000001.SZ / 600519.SH

GET/v1/feargreed/a_stock_individual/{code} Pro+ Max

获取指定A股个股恐贪指数时间序列（code 形如 000001.SZ） · Max全历史

参数: 仅Pro+ Max；period可选latest / 7d / 30d / 180d / 1y / 3y / all

请求示例

A-Share Individual Stock Fear & Greed API Examplebash

# 获取 A 股个股列表(2000+ 只,代码格式 000001.SZ / 600519.SH)
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/feargreed/a_stock_individual/list

# 获取指定个股恐贪指数(示例:000001.SZ 平安银行)
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/a_stock_individual/000001.SZ?period=180d"

响应示例

Response (TablePayload)json

{
  "metadata": {
    "category": "a_stock_individual",
    "code": "000001.SZ",
    "name": "平安银行",
    "period": "7d",
    "latest_date": "2026-05-12",
    "columns": ["date", "price", "feargreed_index"]
  },
  "data": [
    ["2026-04-29", 11.52, 84.73],
    ["2026-04-30", 11.49, 86.26],
    ["2026-05-06", 11.36, 83.70],
    ["2026-05-07", 11.37, 82.41],
    ["2026-05-08", 11.30, 78.63]
  ]
}

ETF恐贪

GET/v1/feargreed/a_stock_etf/list Pro+

ETF恐贪列表

参数: Pro+ / Max · 159601.ETF

GET/v1/feargreed/a_stock_etf/{code} Pro+

ETF恐贪时间序列

参数: Pro+ ≤ 3y; Max all · latest, 7d, 30d, 180d, 1y, 3y, all

ETF Fear & Greed · Pro+ 3y / Max allbash

curl -H "X-API-Key: sk_your_key" "https://api.fusionintel.net/v1/feargreed/a_stock_etf/list"
curl -H "X-API-Key: sk_your_key" "https://api.fusionintel.net/v1/feargreed/a_stock_etf/159601.ETF?period=3y"

板块衍生数据

旧版板块概览、情绪分布及热门板块统计暂不可用。当前板块目录和单个板块恐贪数据，请使用上方的A股板块恐贪接口。

大宗商品恐贪指数

GET/v1/feargreed/commodity/list Pro+

商品恐贪：Pro+最近3年，Max全历史

参数: Pro+ / Pro+ Max；以当前列表为准，代码如AU / SC / CU

GET/v1/feargreed/commodity/{code} Pro+

商品恐贪：Pro+最近3年，Max全历史

参数: code如AU（黄金）/ SC（原油）；Pro+最长3y，Pro+ Max全历史

请求示例

Commodity Fear & Greed API Examplebash

# 获取商品列表(56 个,代码格式纯字母:AU/SC/CU/AG/...)
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/feargreed/commodity/list

# 获取指定商品恐贪指数(示例:AU = 黄金,SC = 原油,CU = 沪铜)
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/commodity/AU?period=180d"

响应示例

响应：列表为对象数组，时间序列为二维数组json

// 1. /list 响应:
{
  "metadata": { "category": "commodity", "count": 56 },
  "data": [
    {"code": "AU", "name": "黄金"},
    {"code": "SC", "name": "原油"},
    {"code": "CU", "name": "沪铜"}
    // ... 53 more
  ]
}

// 2. 单品种时间序列:TablePayload
{
  "metadata": {
    "category": "commodity",
    "code": "AU",
    "name": "黄金",
    "period": "latest",
    "latest_date": "2026-05-13",
    "columns": ["date", "price", "feargreed_index"]
  },
  "data": [["2026-05-13", 1030.56, 76.87]]
}

A股估值数据

GET/v1/valuation/list Pro

获取有估值数据的 A 股代码列表（含名称）

参数: 返回有估值数据的A股代码列表

GET/v1/valuation/columns Pro

获取 17 个估值字段的 schema 说明（label / unit / description），包括 PE / PB / 市值 / 换手率 / 股息率等

参数: 返回估值字段的label / unit / description

GET/v1/valuation/{code} Pro

获取指定 A 股估值指标时间序列（PE/PB/市值/换手率/股息率等 17 字段）。Pro最长1y，Pro+最长3y，Max可查询all全历史

参数: period (latest, 7d, 30d, 180d, 1y, 3y, all) · Pro ≤ 1y; Pro+ ≤ 3y; Max all · 000001.SZ

请求示例

A-Share Valuation API Examplebash

# 列出有估值数据的 A 股
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/valuation/list

# 字段 schema(17 个估值字段:PE / PB / 市值 / 换手率 / 股息率 ...)
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/valuation/columns

# 单股估值时间序列：Pro 1y / Pro+ 3y / Max all
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/valuation/000001.SZ?period=180d"

响应示例

Response — list / columns / TablePayloadjson

// 1. /list 响应:
{
  "metadata": { "category": "valuation", "sub_category": "a_stock", "count": 5000 },
  "data": [
    {"code": "000001.SZ", "name": "平安银行"},
    {"code": "600519.SH", "name": "贵州茅台"}
  ]
}

// 2. /columns 响应(节选):
{
  "metadata": { "category": "valuation", "sub_category": "a_stock", "count": 17 },
  "data": [
    {"field": "pe_ttm",        "label": "市盈率(TTM)",   "unit": "",     "description": "总市值/归母净利润TTM"},
    {"field": "pb",            "label": "市净率",         "unit": "",     "description": "总市值/(归母净资产-其他权益工具)MRQ"},
    {"field": "total_mktcap",  "label": "总市值",         "unit": "亿元", "description": "收盘价×总股本(含A+B+H)"},
    {"field": "turnover_rate", "label": "换手率",         "unit": "%",    "description": "成交量/流通股本×100%"},
    {"field": "div_yield_ttm", "label": "股息率(TTM)",   "unit": "%",    "description": "近12个月派现合计/总市值"}
  ]
}

// 3. 单股时间序列响应(TablePayload,data 是二维数组,按 columns 顺序解析):
{
  "metadata": {
    "symbol": "000001.SZ",
    "name": "平安银行",
    "period": "30d",
    "latest_date": "2026-05-13",
    "columns": ["date", "total_shares", "a_float_shares", "total_mktcap", "a_float_mktcap",
                "turnover_rate", "pe_ttm", "pe_lyr", "pb", "ps_ttm", "pcf_ncf_ttm",
                "pcf_ocf_ttm", "div_yield_ttm", "free_float_shares", "free_float_mktcap",
                "a_total_shares", "a_total_mktcap"]
  },
  "data": [
    ["2026-05-13", 19405760.0, 19405760.0, 2200.65, 2200.65, 0.45, 5.21, 5.18, 0.62, 1.48, 8.32, 7.65, 4.83, 16500000.0, 1870.42, 19405760.0, 2200.65]
  ]
}

港股宏观恐贪指数

GET/v1/feargreed/hk_stock_macro/hsi_feargreedindex Pro

获取港股宏观恐贪指数时间序列（code=hsi_feargreedindex）

参数: 固定code=hsi_feargreedindex；Pro最长1y，Pro+最长3y，Pro+ Max全历史

请求示例

HK Macro Fear & Greed API Examplebash

# 港股宏观恐贪只有一个 code:hsi_feargreedindex(恒指恐贪指数)
# (单 code 类别没有 /list 端点,代码固定)

# 获取最近 30 天恒指恐贪
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/hk_stock_macro/hsi_feargreedindex?period=30d"

响应示例

Response (TablePayload)json

{
  "metadata": {
    "category": "hk_stock_macro",
    "category_name": "港股宏观恐贪指数",
    "code": "hsi_feargreedindex",
    "name": "恒指恐贪指数",
    "period": "latest",
    "latest_date": "2026-05-13",
    "columns": ["date", "price", "feargreed_index"]
  },
  "data": [["2026-05-13", 26388.44, 66.04]]
}

港股板块恐贪指数

GET/v1/feargreed/hk_stock_sectors/list Pro

港股板块恐贪：Pro最近1年，Pro+最近3年，Max全历史

参数: Pro / Pro+ / Max · HK.LIST1180 / EM.HK.039cddf0ea

GET/v1/feargreed/hk_stock_sectors/{code} Pro

港股板块恐贪：Pro最近1年，Pro+最近3年，Max全历史

参数: period (latest, 7d, 30d, 180d, 1y, 3y, all) · Pro ≤ 1y; Pro+ ≤ 3y; Max all

港股板块：Pro最近1年、Pro+最近3年、Max全历史；美股板块仅Max。免费版均不开放。

HK Sector Fear & Greedbash

curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/hk_stock_sectors/list"

curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/hk_stock_sectors/HK.LIST1180?period=1y"

美股板块恐贪指数

GET/v1/feargreed/us_stock_sectors/list Pro+ Max

获取美股板块列表及真实代码，仅Max

参数: Max · usi_041a9194a617

GET/v1/feargreed/us_stock_sectors/{code} Pro+ Max

获取美股板块恐贪，仅Max，全历史

参数: Max only · latest, 7d, 30d, 180d, 1y, 3y, all

港股板块：Pro最近1年、Pro+最近3年、Max全历史；美股板块仅Max。免费版均不开放。

US Sector Fear & Greedbash

curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/us_stock_sectors/list"

curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/us_stock_sectors/usi_041a9194a617?period=1y"

美股宏观恐贪指数

GET/v1/feargreed/us_stock_macro/list Pro

获取道琼斯、纳斯达克综合、标普500的宏观恐贪目录

参数: dow_jones / nasdaq_composite / sp500; Pro / Pro+ / Pro+ Max

GET/v1/feargreed/us_stock_macro/{code} Pro

获取美股宏观恐贪序列；与仅Max开放的美股板块不同

参数: dow_jones / nasdaq_composite / sp500; Pro ≤1y; Pro+ ≤3y; Max all; latest, 7d, 30d, 180d, 1y, 3y, all

错误码

HTTP Status	错误码	说明
400	`INVALID_PERIOD`	窗口允许值：latest、7d、30d、180d、1y、3y、all（受套餐权限限制）
401	`UNAUTHORIZED`	API Key 无效或已撤销
422	`VALIDATION_ERROR`	缺少必填请求头（如 X-API-Key）或参数校验失败
403	`FORBIDDEN`	无权访问该端点（需升级套餐）
404	`NOT_FOUND`	请求的资源不存在
429	`RATE_LIMIT_EXCEEDED`	超出每日调用限额
500	`INTERNAL_ERROR`	服务器内部错误

错误响应格式

Error Responsejson

{
  "detail": "daily limit exceeded"
}

限流说明

免费版

- 每日 100 次 API 调用
- 可访问A股基础数据（近30d）
- 可访问A股宏观恐贪指数（近30d）
- 超限返回 429 状态码

Pro

- 每日1,000次API调用
- 基础品种最近1年，不含商品、ETF、美股板块和A股个股恐贪

Pro+

- 每日3,000次API调用
- 增加商品及ETF恐贪，所有开放品种最近3年；不含美股板块及A股个股恐贪

Pro+ Max

- 每日10,000次API调用
- 包含全部品种，全部可用历史

可在控制台查看用量，或用登录令牌调用 /keys/usage。超过每日额度返回429；生产服务按北京时间每日0点重置。

Account usagehttp

GET /keys/usage
Authorization: Bearer <login_token>

[{ "key_prefix": "sk_...", "name": "", "count": 13, "month_count": 87, "limit": 100 }]