跳到主要内容

资产与上市品种 API 参考

Fonrex 将金融工具（一个 ISIN，对应 assets 表中的一行）与其上市品种（listing）（每个代码、交易所和货币组合对应 asset_listings 表中的一行）区分开来。同一只 ETF 分别以 EUR 和 USD 报价时，是一个金融工具加两个上市品种，每个上市品种都有各自的价格序列。

本页所有路由都需要 API 密钥（X-API-KEY 或 Authorization: Bearer）。

GET /assets/by-isin/{isin}​

返回某个 ISIN 对应的金融工具，包含其首选上市品种以及其所有上市品种。

curl -s -H "X-API-KEY: $FONREX_API_KEY" "http://localhost:5000/assets/by-isin/NL0000235190"
{
  "asset_id": 1,
  "name": "Airbus SE",
  "ticker": "AIR.PA",
  "exchange": "XPAR",
  "currency": "EUR",
  "sector": "Industrials",
  "industry": "Aerospace & Defense",
  "quote_type": "EQUITY",
  "isin": "NL0000235190",
  "listing_id": 1,
  "listings": [
    {
      "id": 1, "asset_id": 1, "ticker": "AIR.PA", "exchange": "XPAR", "currency": "EUR",
      "isin": "NL0000235190", "name": "Airbus SE", "source": "csv_import",
      "is_primary": true, "is_active": true
    },
    {
      "id": 2, "asset_id": 1, "ticker": "AIR.DE", "exchange": "XETR", "currency": "EUR",
      "isin": "NL0000235190", "name": "Airbus SE", "source": "csv_import",
      "is_primary": false, "is_active": true
    }
  ]
}

已知时，响应中还会包含 display_name、official_symbol、logo_path、ir_website 和 long_business_summary。未知的 ISIN 返回 404。

GET /listings​

返回符合筛选条件的活跃上市品种。至少需要一个筛选条件（否则返回 400）。

参数类型说明
tickerstring上市品种的代码（例如 AIR.PA）
isinstring金融工具的 ISIN
exchangestring目录中存储的交易所代码
currencystring上市品种的货币（例如 EUR）
{
  "count": 2,
  "listings": [
    { "id": 1, "asset_id": 1, "ticker": "AIR.PA", "exchange": "XPAR", "currency": "EUR", "isin": "NL0000235190", "name": "Airbus SE", "source": "csv_import", "is_primary": true, "is_active": true }
  ]
}

GET /eod/{ticker}​

以 JSON 或 CSV 返回某个上市品种的日终价格。如果请求的数据尚未存储，会先对该上市品种进行采集（使用为该上市品种验证过的代码从 Yahoo Finance 获取，TradingView 作为后备）。

参数类型默认值说明
tickerstring—代码（最多 10 个字符：字母、数字、. 和 -）
periodstring—1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max、daily、weekly、monthly。除非同时提供 from 和 to，否则必填
from, todate—时间窗口 YYYY-MM-DD，需同时提供
fmtstringjsonjson 或 csv
orderstringaa（最早的在前）或 d（最新的在前）
currencystring—上市品种的货币，用于多个上市品种共用同一代码时
exchangestring—上市品种的交易所，用于多个上市品种共用同一代码时
isinstring—金融工具的 ISIN，用于多个金融工具共用同一代码时（12 个字符，不区分大小写）

weekly 返回周线，monthly 返回月线；其他所有周期都返回日线。

选择上市品种​

仅凭代码并不总能确定唯一的金融工具：在默认目录中，NEM 既是以 USD 计价的 Newmont、其以 AUD 计价的澳大利亚上市线，也是以 EUR 计价的 Nemetschek——共三个 ISIN。Fonrex 在带有该代码的上市品种中，优先选择主上市品种，然后按货币和交易所的字母顺序选择：对于 NEM，选中的是以 AUD 计价的澳大利亚上市线。

  • isin 只保留同一个金融工具的上市品种。即使带后缀的代码不在目录中，也绝不会返回其他金融工具的上市品种（MRK.DE 仅在指定的金融工具内回退到 MRK）。
  • currency 和 exchange 在该金融工具的上市品种之间进行选择。

isin 与 currency 一起使用即可无歧义地指定一个上市品种：GET /eod/NEM?period=1y&isin=US6516391066&currency=USD。不是 12 个字符（两个字母，后跟十个字母或数字）的 ISIN 会被拒绝，返回 400。

curl -s -H "X-API-KEY: $FONREX_API_KEY" "http://localhost:5000/eod/AIR.PA?period=5d"
{
  "ticker": "AIR.PA",
  "listing": { "ticker": "AIR.PA", "isin": "NL0000235190", "currency": "EUR", "exchange": "XPAR" },
  "period": "5d",
  "format": "json",
  "count": 3,
  "retrieved_at": "2026-10-08T16:34:42.404598+00:00",
  "data_source": "database",
  "data": [
    { "Date": "2026-10-06", "Open": 153.44, "High": 155.44, "Low": 151.44, "Close": 154.44, "Adj Close": 154.44, "Volume": 1399000 },
    { "Date": "2026-10-07", "Open": 154.46, "High": 156.46, "Low": 152.46, "Close": 155.46, "Adj Close": 155.46, "Volume": 1400000 }
  ]
}

Open、High、Low 和 Close 是成交价格，已针对拆股调整；Adj Close 是针对拆股和分红调整后的收盘价（来源未提供时即为收盘价）。listing 是实际读取的上市品种：请将其 isin 与您预期的金融工具进行核对。目录中不知道其交易所时（没有后缀的代码，例如美国股票），其 exchange 为 null。Date 是交易日的日期。价格已存储时 data_source 为 database，否则为采集来源（yfinance 或 tradingview）。响应在 Redis 中缓存 24 小时。

使用 fmt=csv 时：

Date,Open,High,Low,Close,Adj Close,Volume
2026-10-06,153.44,155.44,151.44,154.44,154.44,1399000
2026-10-07,154.46,156.46,152.46,155.46,155.46,1400000

错误​

状态码响应体触发条件
400{"error": "Invalid request", "message": "..."}代码、周期、格式、排序、日期或 ISIN 无效
404{"error": "No data found", "message": "...", "reason": "..."}没有已存储的数据，也无法采集到任何数据。reason 说明原因，例如该代码没有对应该 ISIN 和货币的上市品种（No listing found for ticker NEM (ISIN DE0006452907, currency USD)），或 Yahoo 上没有以该上市品种货币报价的代码

关于如何为上市品种选择数据源代码，请参阅采集历史数据。