做跨市场投研不想对接五套行情接口?基于 FMP 一套 API 同时接入美股、港股(.HK)、A 股(.SS/.SZ)与全球股市数据(Global Stock API)

做全球资产配置、中概股“美股 ADR + 港股双重上市”价差监控,或把半导体与新能源产业链从美股延伸到港股、A 股、台股、日股与欧股做横截面估值对比时,研发团队最头疼的往往是底层数据源碎片化:美股接 REST 接口、港股挂本地网关进程、A 股调开源爬虫库,不仅鉴权与限流各异,连“营业收入”和“稀释每股收益”都要维护多套字段映射表。

本文基于 FMP数据源中文站 对 FMP 旗下 Directory(基础目录接口)、Search(证券搜索接口)、Quote(实时行情接口)、Chart(股票行情接口)、Statements(财务报表接口)与 MarketHours(交易时间接口)六大模块的实盘抽样(数据快照截至 2026-11-13 08:59 UTC),梳理出一套基于单一 /stable/ 架构同时接入美、港、A 及全球股市的工程方案。


做“美股 + 港股 + A 股”跨市场投研,为什么分别对接多套区域行情接口会让数据清洗苦不堪言?

拼装多套区域行情与财报数据源进入日常运维时,通常会暴露出四类隐性工程成本:鉴权连接形态与频控各自为政、不同区域三大财务报表会计科目命名割裂、缺少原生的跨市场同源证券(ADR / A+H)关联主键,以及欧美连续交易(含冬夏令时)与亚太市场午间休市时段硬编码极易出错。

下表对比了传统多源拼装方案与基于 FMP /stable/ 统一接口方案的工程实现差异:

对比维度传统多套区域接口拼装方案FMP 全球多市场统一接入方案核心支撑端点与关键字段
市场覆盖范围需分别对接 3~5 家区域数据源一套 /stable/ 协议覆盖全球 63 家交易所(国家目录 118 项)/stable/available-exchanges、/stable/available-countries
实时与批量报价各平台字段异构,难以单次混查单次请求可同时混传美、港、A、台、日、欧代码批量拉取快照/stable/batch-quote、/stable/quote、/stable/batch-exchange-quote
历史日线与分时复权与字段名不统一统一 OHLCV 字段结构,全市场日线 changePercent 统一为日内涨跌幅百分数 100 × (close - open) / open/stable/historical-price-eod/full、/stable/historical-chart/1min
全球标准化三表会计科目命名割裂,无法直接横评全球市场统一映射为标准报表字段名,明确区分交易币种 currency 与财报币种 reportedCurrency/stable/income-statement、/stable/balance-sheet-statement、/stable/cash-flow-statement
同源多地上市检索需手工维护 ADR / A+H 映射表传入任一挂牌代码即可一键返回全球同源 ADR、港股、A 股及双柜台代码/stable/search-exchange-variants
全球交易时段日历午间休市与夏冬令时需手动硬编码原生返回全球交易所时区、开闭市状态及亚洲市场午休分段(openingAdditional)/stable/all-exchange-market-hours、/stable/holidays-by-exchange

一套接口能覆盖全球哪些交易所?盘点港股(.HK)、上证(.SS)、深证(.SZ)、伦敦(.L)与东京(.T)代码后缀规则

开发者可通过 Available Exchanges(可用交易所清单接口,/stable/available-exchanges)、Available Countries(可用国家清单接口,/stable/available-countries)、All Exchange Market Hours(交易所交易时段接口,/stable/all-exchange-market-hours)、Global Exchange Market Hours(全球交易所交易时段接口,/stable/exchange-market-hours)及 Holidays By Exchange(交易所休市日查询接口,/stable/holidays-by-exchange)动态获取全球市场元数据。

实盘调用 /stable/available-exchanges 共返回 63 家全球交易所。除美股市场(NASDAQ、NYSE、AMEX、OTC)无后缀外,其它市场均通过 本地代码 + symbolSuffix 唯一寻址。核心跨市场后缀与交易时段汇总如下:

交易所代码交易所名称与国家/地区代码后缀报价时效 (delay)当地交易时段(含亚洲市场午间休市分段)典型标的代码示例
NASDAQ / NYSE纳斯达克 / 纽交所(US)无后缀 (N/A)Real-time09:30 AM ~ 04:00 PM (America/New_York)AAPL、NVDA、BABA、TSM
HKSE香港交易所(HK).HK15 min09:30~12:00 · 13:00~16:00 (Asia/Hong_Kong)0700.HK、9988.HK、0005.HK、80700.HK
SHH / SHZ上交所 / 深交所(CN).SS / .SZ15 min09:30~11:30 · 13:00~15:00 (Asia/Shanghai)600519.SS、300750.SZ、002594.SZ
TAI台湾证券交易所(TW).TW20 min09:00 AM ~ 01:30 PM (Asia/Taipei,无午休)2330.TW、2317.TW
JPX东京证券交易所(JP).T20 min09:00~11:30 · 12:30~15:30 (Asia/Tokyo)7203.T、6758.T
LSE伦敦证券交易所(UK).L15 min08:00 AM ~ 04:30 PM (Europe/London)AZN.L、SHEL.L、TYT.L

接入多市场代码时,须在代码层做好三项防呆:

  1. 港股(.HK)代码位宽铁律:4 位定长补零 vs 5 位前导零查空 vs 8xxxx.HK 人民币双柜台:
  1. 亚洲市场的午间休市分段字段(openingAdditional / closingAdditional):欧美交易所与台交所(TAI)仅含 openingHour 与 closingHour;而港交所(HKSE)、沪深(SHH/SHZ)、东交所(JPX,已反映 2024 年 11 月延后至 15:30 收盘的新规)将早盘放在 openingHour ~ closingHour、午盘放在 openingAdditional ~ closingAdditional。
  2. 全球 63 家交易所时效分层:美股、加股等 16 家核心市场为 Real-time 实时报价,港、沪、深、伦等 34 家主流市场为 15 min,台、日、韩等 10 家为 20 min,可直接读取 delay 字段识别延迟梯度。

阿里、拼多多、台积电在多地双重上市或发行 ADR,如何用多交易所上市检索(Exchange Variants)一键找齐同源标的?

在 Search 模块下,若用 Company Name Search(公司名称检索接口,/stable/search-name)按名称搜索容易混入同名 ETF;专门用于归并跨国同源证券的工具是 Exchange Variants(多交易所上市检索接口,/stable/search-exchange-variants)。

我们抽取美港双重上市(BABA / 9988.HK)、美台 ADR(TSM / 2330.TW)、A+H 双重上市(002594.SZ / 1211.HK)以及单市场标的(PDD / 600519.SS)4 组代表性样本实测如下(快照截至 2026-11-13 08:59 UTC):

查询传入代码命中同源记录数美股主场或 OTC 代码(报价 / 币种)亚太原股代码(报价 / 币种)港股人民币双柜台(报价 / 币种)其他欧洲或海外挂牌代码双向对称性与实测特征
BABA 或 9988.HK8 条BABA(94.36 USD,NYSE,ADR)· BABAF(11.683 USD,OTC)9988.HK(90.55 HKD,HKSE)89988.HK(76.80 CNY,HKSE)AHLA.DE / AHLA.F / 2RR.F(EUR)· BABA.SW(CHF)传 BABA 与传 9988.HK 对称返回相同 8 个代码;1 BABA ADS = 8 股 9988.HK
TSM 或 2330.TW4 条TSM(405.49 USD,NYSE,ADR)· TSMWF(17.2402 USD,OTC)2330.TW(2350 TWD,TAI)无TSFA.F(367.50 EUR,FSX)传 TSM 与传 2330.TW 对称返回相同 4 个代码;1 TSM ADR = 5 股 2330.TW
002594.SZ 或 1211.HK7 条BYDDY(8.50 USD,OTC,ADR)· BYDDF(8.55 USD,OTC)002594.SZ(79.99 CNY,SHZ)· 1211.HK(65.00 HKD,HKSE)81211.HK(55.30 CNY,HKSE)BY6.F(7.538 EUR)· BY6.VI(7.509 EUR)传深股 002594.SZ 与传港股 1211.HK 对称返回 A 股、H 股、人民币柜台与 OTC
PDD / 600519.SS0 条 ([])PDD 主上市地为 NASDAQ600519.SS 主上市地为上交所 SHH无无库内未收录跨市场变体时返回空数组 [],须回退查 /stable/profile

结合上表,生产中使用 /stable/search-exchange-variants 需把握三项要点:

  1. 利用港股人民币双柜台(8xxxx.HK)免汇率直算 A/H 溢价率:比亚迪同源簇同时返回 A 股 002594.SZ(79.99 元人民币)、港币柜台 1211.HK(65.00 港元)与人民币柜台 81211.HK(55.30 元人民币)。因 1 股 A 股与 1 股 H 股同权且同以 CNY 计价,直接计算 79.99 ÷ 55.30 − 1 = +44.65% 即可得出人民币口径 A/H 溢价率(与港币柜台按即期汇率 USDCNY = 6.6699、USDHKD = 7.8453 折算的 +44.75% 高度吻合)。
  2. 区分美股存托凭证(isAdr: true)与 OTC 原股(isAdr: false),警惕冷门柜台滞后价:阿里同源簇中,纽交所 BABA(isAdr: true,报价 94.36 美元)与 OTC 市场 BABAF(isAdr: false,ISIN 与 9988.HK 同为开曼原股 KYG017191142,报价 11.683 美元)相差约 8 倍,对应 1 ADS = 8 股普通股。同时,变体簇内低流动性柜台(如台积电 OTC 代码 TSMWF 停留在 17.2402 美元、阿里瑞士柜台 BABA.SW 停留在 166 瑞郎)存在明显历史滞后价,故该接口仅作同源证券代码发现,实盘估值取价须回主挂牌地调 /stable/quote 并校验 timestamp。
  3. 单市场标的返回空数组 [] 的兜底防崩:如拼多多(PDD)与贵州茅台(600519.SS)调用该接口均返回 [],代码中切勿直接取 variants[0],为空时应自动回退至 Company Profile Data(公司概况接口,/stable/profile)。

跨市场拉取港股腾讯(0700.HK)、A 股茅台(600519.SS)与台积电(TSM / 2330.TW)财报时,怎么避开计价币种(reportedCurrency)暗坑?

在调用 Income Statement(利润表接口,/stable/income-statement)、Balance Sheet Statement(资产负债表接口,/stable/balance-sheet-statement)、Cash Flow Statement(现金流量表接口,/stable/cash-flow-statement)、Financial Ratios TTM(TTM 财务比率接口,/stable/ratios-ttm)与 Key Metrics TTM(TTM 关键指标接口,/stable/key-metrics-ttm)时,最隐蔽的事故是“行情交易币种(currency)与财报记账币种(reportedCurrency)错配”。

下表抽取横跨美、港、A、台、英的 7 只代表性标的(涵盖美港双重上市对、美台 ADR 对、港股中资股、A 股本币基准及伦交所便士股),对实时报价(currency、price)、最新财年利润表(reportedCurrency、revenue、netIncome、epsDiluted、weightedAverageShsOutDil)与 TTM 市盈率(priceToEarningsRatioTTM)进行交叉对账(快照截至 2026-11-13 08:59 UTC):

股票代码市场与公司简称报价币种与最新价财报币种与最新财年营业收入 / 净利润(按财报币种计,单位:十亿)稀释 EPS / 稀释加权股数(亿股)未换算直接相除 (price / epsDiluted)汇率对齐后静态 FY PE / 接口 TTM PE
BABA美股 · 阿里 ADRUSD / 94.36CNY / 2026-03-311,023.67 / 103.5944.00 / 24.042.14 倍(错)14.30 倍 / 19.88 倍
9988.HK港股 · 阿里巴巴HKD / 90.55CNY / 2026-03-311,023.67 / 103.595.50 / 192.3516.46 倍(错)14.00 倍 / 19.88 倍
0700.HK港股 · 腾讯控股HKD / 386.60CNY / 2025-12-31751.77 / 224.8423.52 / 92.4416.44 倍(错)13.97 倍 / 12.71 倍
600519.SS上证 · 贵州茅台CNY / 1435.26CNY / 2025-12-31145.18 / 82.3265.66 / 12.5421.86 倍21.86 倍 / 21.86 倍
TSM美股 · 台积电 ADRUSD / 405.49TWD / 2025-12-313,809.05 / 1,697.60331.25 / 51.861.22 倍(错)40.24 倍 / 23.92 倍
2330.TW台股 · 台积电TWD / 2350.00TWD / 2025-12-313,809.05 / 1,717.8866.25 / 259.3135.47 倍35.47 倍 / 23.92 倍
AZN.L英股 · 阿斯利康GBp / 13974.00USD / 2025-12-3158.74 / 10.236.54 / 15.622136.70 倍(错)28.28 倍 / 25.97 倍

对拍上表可提炼出跨市场财报与估值计算的四条核心法则:

  1. FMP 利润表已将美股 ADR 的股数与 EPS 折算为“每份 ADR”口径,只需换算汇率、严禁二次乘除 ADR 比例:

核对上表第 6 列可见:港股 9988.HK 的稀释股数为 192.35 亿股普通股、epsDiluted 为 5.50 元人民币,而美股 BABA 已被自动折算为 24.04 亿份 ADS(192.35 ÷ 8)、epsDiluted 为 44.00 元人民币/ADS(5.50 × 8);台股 2330.TW 的 epsDiluted 为 66.25 新台币/普通股,而美股 TSM 已被自动折算为 331.25 新台币/ADR(66.25 × 5)。因此计算 TSM 静态市盈率时,只需将美元股价 405.49 乘以即期汇率 USDTWD = 32.871 折为 13,328.86 新台币,再除以 331.25 即得 405.49 × 32.871 ÷ 331.25 ≈ 40.24 倍。

  1. 港股中资股(HKD 报价 vs CNY 财报)与伦交所(GBp 便士 vs JPY 多币种报价)换算:
  1. 区分“公司级统一 TTM 比率(ratios-ttm)”与“挂牌地独立估值”:

表中 BABA 与 9988.HK 的 priceToEarningsRatioTTM 均为 19.88 倍(key-metrics-ttm 中 marketCap 均为 15,312.63 亿元人民币),TSM 与 2330.TW 均为 23.92 倍。这是因为 /stable/ratios-ttm 返回的是公司级单一数值;若要捕捉同一公司在不同交易所的估值折溢价(如 TSM 静态 PE 40.24 倍 vs 台股 2330.TW 35.47 倍),则必须用各挂牌地自身的 quote.price 经汇率对齐后除以同口径 epsDiluted 独立计算。

  1. 跨挂牌地会计准则差异与非美标的 cik 占位符:同一发行人在不同挂牌地受会计准则(IFRS vs CAS/US GAAP)影响,部分利润表科目存在细微差异(如 TSM 与 2330.TW),基本面横评建议固定取主挂牌地报表。此外,非美挂牌代码在 /stable/profile 中 cik 为 null,在 /stable/income-statement 中部分填充为 cik == "0000000000"(如 0700.HK),切勿将 cik 当作跨市场唯一主键。

如何用一套 Python 代码同时拉取美股、港股与 A 股的最新日线与核心财务估值指标?

以下零第三方依赖 Python 脚本封装了港股代码 04d 归一化、/stable/search-exchange-variants 同源检索与 [] 兜底、即期汇率自动折算(含 GBp 便士除 100),以及 Stock Price and Volume Data(日线完整行情接口,/stable/historical-price-eod/full)最新日线与静态 FY PE / 接口 TTM PE 对账:

import datetime, json, os, urllib.parse, urllib.request
BASE_URL, API_KEY = "https://quote-fmp.com/stable", os.environ["FMP_KEY"]

def fmp_get(path, params):
    q = urllib.parse.urlencode({**params, "apikey": API_KEY})
    req = urllib.request.Request(f"{BASE_URL}/{path}?{q}", headers={"User-Agent": "Mozilla/5.0"})
    with urllib.request.urlopen(req, timeout=20) as resp:
        return json.loads(resp.read().decode("utf-8"))

def normalize_ticker(raw_sym):
    s = raw_sym.strip().upper()
    return f"{int(s[:-3]):04d}.HK" if (s.endswith(".HK") and s[:-3].isdigit()) else s

def load_usd_fx_map():
    rows = fmp_get("batch-quote", {"symbols": "USDCNY,USDHKD,USDTWD,USDJPY,EURUSD,GBPUSD"})
    q = {r["symbol"]: r["price"] for r in rows if r.get("price")}
    return {"USD": 1.0, "CNY": q["USDCNY"], "HKD": q["USDHKD"], "TWD": q["USDTWD"],
            "JPY": q["USDJPY"], "EUR": 1.0 / q["EURUSD"], "GBP": 1.0 / q["GBPUSD"]}

def audit_global_stock(raw_sym, usd_fx, as_of=None):
    sym, end = normalize_ticker(raw_sym), datetime.date.fromisoformat(as_of) if as_of else datetime.date.today()
    prof = (fmp_get("profile", {"symbol": sym}) or [{}])[0]
    if not prof.get("symbol"): return {"input": raw_sym, "symbol": sym, "error": "NOT_FOUND"}
    variants = fmp_get("search-exchange-variants", {"symbol": sym}) or []
    var_syms = [v["symbol"] for v in variants if v.get("symbol")] or [sym]
    inc = (fmp_get("income-statement", {"symbol": sym, "period": "FY", "limit": 1}) or [{}])[0]
    rat = (fmp_get("ratios-ttm", {"symbol": sym}) or [{}])[0]
    eod = (fmp_get("historical-price-eod/full", {"symbol": sym, "from": str(end - datetime.timedelta(days=10)), "to": str(end)}) or [{}])[0]
    q_ccy, r_ccy, raw_p, eps = prof.get("currency"), inc.get("reportedCurrency"), prof.get("price"), inc.get("epsDiluted")
    p_norm, ccy_norm = (raw_p / 100.0, "GBP") if q_ccy == "GBp" else (raw_p, q_ccy)
    fx_rate = (usd_fx[r_ccy] / usd_fx[ccy_norm]) if (ccy_norm in usd_fx and r_ccy in usd_fx) else None
    p_in_rep = round(p_norm * fx_rate, 2) if (p_norm is not None and fx_rate is not None) else None
    pe_ttm = rat.get("priceToEarningsRatioTTM")
    return {
        "input": raw_sym, "symbol": sym, "exchange": prof.get("exchange"), "variants_count": len(variants),
        "sample_variants": var_syms[:4], "quote_ccy": q_ccy, "price": raw_p, "report_ccy": r_ccy,
        "fy_date": inc.get("date"), "eps_diluted": eps, "price_in_report_ccy": p_in_rep,
        "naive_pe": round(raw_p / eps, 2) if (raw_p and eps) else None,
        "fx_adj_fy_pe": round(p_in_rep / eps, 2) if (p_in_rep and eps) else None,
        "fmp_pe_ttm": round(pe_ttm, 2) if pe_ttm is not None else None,
        "latest_eod_date": eod.get("date"), "latest_close": eod.get("close"), "latest_vwap": eod.get("vwap")
    }

if __name__ == "__main__":
    usd_fx = load_usd_fx_map()
    for s in ["00700.HK", "BABA", "600519.SS", "TSM", "AZN.L"]:
        try: print(json.dumps(audit_global_stock(s, usd_fx, as_of="2026-11-13"), ensure_ascii=False))
        except Exception as e: print(json.dumps({"input": s, "error": str(e)}, ensure_ascii=False))

向脚本传入 5 位前导零港股代码(00700.HK)、美股中概 ADR(BABA)、A 股单市场龙头(600519.SS)、台积电 ADR(TSM)与伦交所便士股(AZN.L),实盘输出的 5 条代表性 JSON 结果如下(若需查询全部可用外汇对可调用 Forex(外汇数据接口)下的 /stable/forex-list):

{"input": "00700.HK", "symbol": "0700.HK", "exchange": "HKSE", "variants_count": 7, "sample_variants": ["0700.HK", "TCEHY", "80700.HK", "NNN1.VI"], "quote_ccy": "HKD", "price": 386.6, "report_ccy": "CNY", "fy_date": "2025-12-31", "eps_diluted": 23.52, "price_in_report_ccy": 328.68, "naive_pe": 16.44, "fx_adj_fy_pe": 13.97, "fmp_pe_ttm": 12.71, "latest_eod_date": "2026-11-13", "latest_close": 386.6, "latest_vwap": 390.1}
{"input": "BABA", "symbol": "BABA", "exchange": "NYSE", "variants_count": 8, "sample_variants": ["BABA", "2RR.F", "89988.HK", "9988.HK"], "quote_ccy": "USD", "price": 94.36, "report_ccy": "CNY", "fy_date": "2026-03-31", "eps_diluted": 44, "price_in_report_ccy": 629.37, "naive_pe": 2.14, "fx_adj_fy_pe": 14.3, "fmp_pe_ttm": 19.88, "latest_eod_date": "2026-11-12", "latest_close": 94.36, "latest_vwap": 94.57}
{"input": "600519.SS", "symbol": "600519.SS", "exchange": "SHH", "variants_count": 0, "sample_variants": ["600519.SS"], "quote_ccy": "CNY", "price": 1435.26, "report_ccy": "CNY", "fy_date": "2025-12-31", "eps_diluted": 65.66, "price_in_report_ccy": 1435.26, "naive_pe": 21.86, "fx_adj_fy_pe": 21.86, "fmp_pe_ttm": 21.86, "latest_eod_date": "2026-11-13", "latest_close": 1435.26, "latest_vwap": 1417.7375}
{"input": "TSM", "symbol": "TSM", "exchange": "NYSE", "variants_count": 4, "sample_variants": ["TSM", "2330.TW", "TSFA.F", "TSMWF"], "quote_ccy": "USD", "price": 405.49, "report_ccy": "TWD", "fy_date": "2025-12-31", "eps_diluted": 331.25, "price_in_report_ccy": 13328.86, "naive_pe": 1.22, "fx_adj_fy_pe": 40.24, "fmp_pe_ttm": 23.92, "latest_eod_date": "2026-11-12", "latest_close": 405.49, "latest_vwap": 403.72}
{"input": "AZN.L", "symbol": "AZN.L", "exchange": "LSE", "variants_count": 5, "sample_variants": ["AZN", "AZN.L", "ZEG.DE", "AZN.ST"], "quote_ccy": "GBp", "price": 13974, "report_ccy": "USD", "fy_date": "2025-12-31", "eps_diluted": 6.54, "price_in_report_ccy": 184.94, "naive_pe": 2136.7, "fx_adj_fy_pe": 28.28, "fmp_pe_ttm": 25.97, "latest_eod_date": "2026-11-13", "latest_close": 13964, "latest_vwap": 13947.33}

此外,拉取跨市场历史日线(/stable/historical-price-eod/full)回测时需注意:全市场日线 changePercent 统一定义为当日日内涨跌幅百分数 100 × (close - open) / open,计算含隔夜跳空的跨日收益率须使用相邻交易日收盘价 close[t] / close[t-1] - 1。


常见问题(FAQ):跨市场接入全球股票行情与财报时还有哪些高频细节?

Q1:监控跨市场自选股池时,能否在 1 次请求里同时混传美股、港股、A 股与欧股代码批量拉取报价?

完全可以。调用 Stock Batch Quote(股票批量报价接口,/stable/batch-quote?symbols=AAPL,0700.HK,600519.SS,2330.TW,AZN.L)时,单次传入逗号分隔的跨市场代码列表即可一次性返回全部标的的最新价、涨跌幅、成交量、市值与秒级时间戳 timestamp。若需一次性拉取整个单一交易所(如 exchange=HKSE 或 exchange=SHH)的全市场快照,可直接调用 Exchange Stock Quotes(交易所全量报价接口,/stable/batch-exchange-quote)。

Q2:FMP 官方不同套餐档位对港股(.HK)、A 股(.SS/.SZ)等非美股全球市场的权限边界是怎么划分的?

按 FMP 官方定价页划分,免费 Basic 档仅开放少量美股基础示例端点用于连通测试;付费档位中,Starter 档标准行情与财报仅覆盖美股,Premium 档覆盖美股、英股(.L)与加股(.TO),而批量拉取港股(.HK)、A 股(.SS/.SZ)、台股(.TW)、日股(.T)及欧洲大陆等全球市场的完整行情与财务报表均需 Ultimate 档位解锁。如果希望结合中文文档、阅读友好的中文解析与微信支付(约官方 2 折)接入全球全市场接口,可前往 快速接入指南 免费申领 Ultimate 全接口试用密钥,或查阅 定价与会员套餐。

登录后可领取FMP Ultimate档15天试用 Key,覆盖全量接口。免费试用 15 天 →