API Documentation

Complete Agentic Finance Hub integration reference — REST API · MCP · Skills · and more

Base URL

https://api.fusionintel.net/v1

Authentication

Data API requests require an API key in the HTTP header, except endpoints marked “No Auth”:

Auth Examplebash

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

Responses are returned as inline JSON (Content-Type: application/json) — no redirect to follow. The body is typically shaped as { metadata, data: [[...rows]] }. Response Cache-Control is private, no-store.

Public Endpoints

GET/v1/public/feargreed/latestNo Auth

Public endpoint (no API key required): latest A-share macro fear & greed snapshot, suitable for web/mini-program display.

Request Example

Public Endpoint — No Auth Requiredbash

# Public snapshot — no API key required
curl https://api.fusionintel.net/v1/public/feargreed/latest

Response Example

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-Share Basic Data

GET/v1/stock/{code}

Retrieve A-share prices. Free uses period=30d only; check response metadata for the available rows and adjustment basis.

Parameters: period: latest / 7d / 30d / 180d / 1y / 3y / all; Free: 30d only; Pro: up to 1y; Pro+: up to 3y; Pro+ Max: all

Request Example

A-Share Basic Data API Examplebash

# Free: Ping An Bank prices (period=30d only)
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/stock/000001.SZ

# Pro: request up to 1 year of price data
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/stock/000001.SZ?period=1y"

Response Example

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-Share Macro Fear & Greed

GET/v1/feargreed/a_stock_macro/shi_feargreedindex

Get time series for A-share macro fear & greed (code=shi_feargreedindex)

Parameters: period depends on your plan: Free up to 30d; Pro up to 1y; Pro+ up to 3y; Pro+ Max all

Request Example

A-Share Macro Fear & Greed API Examplebash

# A-share macro fear & greed uses the fixed code shi_feargreedindex
# This single-instrument category uses a fixed code, not /list

# Request the 30d fear & greed window
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/a_stock_macro/shi_feargreedindex?period=30d"

Response Example

Response (parse the data array using 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-Share Sector Fear & Greed

GET/v1/feargreed/a_stock_sectors/list Pro

Get sector list for A-share sector fear & greed index

Parameters: Returns the current sector catalog; code example: sector0001

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

Get time series for a specific A-share sector fear & greed index

Parameters: Get sector_code from the catalog; Pro up to 1y; Pro+ up to 3y; Pro+ Max all

Request Example

A-Share Sector Fear & Greed API Examplebash

# Get the current A-share sector catalog; codes use lowercase sectorXXXX
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/feargreed/a_stock_sectors/list

# Get one sector fear & greed series; obtain its code from the catalog
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/a_stock_sectors/sector0001?period=1y"

Response Example

Response: list objects vs time-series arraysjson

// 1. /list response: data is an array of objects
{
  "metadata": {
    "category": "a_stock_sectors",
    "category_name": "A股板块恐贪指数",
    "count": 407
  },
  "data": [
    {"code": "sector0001", "name": "参股保险"},
    {"code": "sector0002", "name": "天津自贸区"}
  ]
}

// 2. Sector series: TablePayload (data is a two-dimensional array)
{
  "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-Share Individual Stock Fear & Greed

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

Get instrument list for A-share individual stock fear & greed index · Max only, all history

Parameters: Pro+ Max only; codes such as 000001.SZ / 600519.SH

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

Get time series for an individual A-share stock fear & greed index (code like 000001.SZ) · Max only, all history

Parameters: Pro+ Max only; period: latest / 7d / 30d / 180d / 1y / 3y / all

Request Example

A-Share Individual Stock Fear & Greed API Examplebash

# Get the A-share individual-stock catalog (Pro+ Max); codes use 000001.SZ / 600519.SH
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/feargreed/a_stock_individual/list

# Get individual-stock fear & greed (Pro+ Max), e.g. 000001.SZ
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/a_stock_individual/000001.SZ?period=180d"

Response Example

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 Fear & Greed

GET/v1/feargreed/a_stock_etf/list Pro+

ETF fear & greed catalog

Parameters: Pro+ / Max · 159601.ETF

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

ETF fear & greed series

Parameters: 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"

Sector Aggregates

Legacy sector overview, distribution and hot-sector statistics are temporarily unavailable. Use the A-share sector fear & greed endpoints above for the current catalog and individual sector series.

Commodity Fear & Greed

GET/v1/feargreed/commodity/list Pro+

Commodity fear & greed: Pro+ up to 3y; Max all

Parameters: Pro+ / Pro+ Max; use the current catalog; code examples: AU / SC / CU

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

Commodity fear & greed: Pro+ up to 3y; Max all

Parameters: code examples: AU (gold) / SC (crude oil); Pro+ up to 3y; Pro+ Max all

Request Example

Commodity Fear & Greed API Examplebash

# Get the commodity catalog (Pro+ or Pro+ Max); codes such as AU / SC / CU
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/feargreed/commodity/list

# Get commodity fear & greed, e.g. AU (gold), SC (crude oil), CU (copper)
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/commodity/AU?period=180d"

Response Example

Response: list objects vs time-series arraysjson

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

// 2. Instrument time series: 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-Share Valuation Data

GET/v1/valuation/list Pro

Get the list of A-share tickers (with names) for which valuation data is available

Parameters: Returns A-share codes with available valuation data

GET/v1/valuation/columns Pro

Get the schema for the 17 valuation fields (label / unit / description), including PE, PB, market cap, turnover rate, dividend yield, etc.

Parameters: Returns label / unit / description for valuation fields

GET/v1/valuation/{code} Pro

Get the valuation time series for a specific A-share ticker (PE / PB / market cap / turnover rate / dividend yield — 17 fields). Pro: up to 1y; Pro+: up to 3y; Max: all history.

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

Request Example

A-Share Valuation API Examplebash

# List A-shares with available valuation data
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/valuation/list

# Valuation field schema: PE / PB / market cap / turnover / dividend yield ...
curl -H "X-API-Key: sk_your_key" \
  https://api.fusionintel.net/v1/valuation/columns

# Stock valuation series: Pro up to 1y / Pro+ up to 3y / Pro+ Max all
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/valuation/000001.SZ?period=180d"

Response Example

Response — list / columns / TablePayloadjson

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

// 2. /columns response (excerpt):
{
  "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. Stock time series: parse the data array using metadata.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]
  ]
}

HK Macro Fear & Greed

GET/v1/feargreed/hk_stock_macro/hsi_feargreedindex Pro

Get time series for HK macro fear & greed (code=hsi_feargreedindex)

Parameters: Fixed code=hsi_feargreedindex; Pro up to 1y; Pro+ up to 3y; Pro+ Max all

Request Example

HK Macro Fear & Greed API Examplebash

# HK macro fear & greed uses the fixed code hsi_feargreedindex
# This single-instrument category uses a fixed code, not /list

# Get the 30d Hang Seng fear & greed window
curl -H "X-API-Key: sk_your_key" \
  "https://api.fusionintel.net/v1/feargreed/hk_stock_macro/hsi_feargreedindex?period=30d"

Response Example

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]]
}

HK Sector Fear & Greed

GET/v1/feargreed/hk_stock_sectors/list Pro

HK sector fear & greed: Pro up to 1y, Pro+ up to 3y, Max all

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

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

HK sector fear & greed: Pro up to 1y, Pro+ up to 3y, Max all

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

HK sectors: Pro up to 1y, Pro+ up to 3y, Max all. US sectors: Max only. Neither is available on Free.

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"

US Sector Fear & Greed

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

Get US sector names and canonical codes · Max only

Parameters: Max · usi_041a9194a617

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

Get US sector fear & greed · Max only, all history

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

HK sectors: Pro up to 1y, Pro+ up to 3y, Max all. US sectors: Max only. Neither is available on Free.

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"

US Macro Fear & Greed

GET/v1/feargreed/us_stock_macro/list Pro

List the Dow Jones, Nasdaq Composite and S&P 500 fear & greed indices

Parameters: dow_jones / nasdaq_composite / sp500; Pro / Pro+ / Pro+ Max

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

US macro fear & greed time series; separate from Max-only US sectors

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

Error Codes

HTTP Status	Error Code	Description
400	`INVALID_PERIOD`	Windows: latest, 7d, 30d, 180d, 1y, 3y, all, subject to plan access
401	`UNAUTHORIZED`	API key is invalid or revoked
422	`VALIDATION_ERROR`	Missing required header (such as X-API-Key) or invalid request parameters
403	`FORBIDDEN`	No permission to access this endpoint (upgrade required)
404	`NOT_FOUND`	Requested resource not found
429	`RATE_LIMIT_EXCEEDED`	Daily API call limit exceeded
500	`INTERNAL_ERROR`	Internal server error

Error Response Format

Error Responsejson

{
  "detail": "daily limit exceeded"
}

Rate Limits

Free Plan

- 100 API calls per day
- Includes A-share basic data (recent 30d)
- Includes A-share macro fear & greed index (recent 30d)
- Returns 429 status code when exceeded

Pro Plan

- 1,000 API calls/day
- Core datasets up to 1y; excludes commodity, ETF, US sectors and A-share individual fear & greed

Pro+ Plan

- 3,000 API calls/day
- Adds commodity and ETF fear & greed up to 3y; excludes US sectors and A-share individual fear & greed

Pro+ Max

- 10,000 API calls/day
- All dataset categories and all available history

View usage in the dashboard or call /keys/usage with your login token. Requests above the daily quota return 429. Production quotas reset at 00:00 Beijing time (UTC+8).

Account usagehttp

GET /keys/usage
Authorization: Bearer <login_token>

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