Available Countries可用国家清单
该接口返回平台有证券数据覆盖的全部国家与地区两字母标准代码(ISO 二位国别码)清单。作为地域维度的权威枚举字典,它用于按企业总部所在地或上市市场归属国筛选全球股票,支撑跨国市场比较与地缘风险敞口管理。
https://quote-fmp.com/stable/available-countries数据更新周期
该接口暂无固定更新周期(多为按需更新的参考或静态数据)。
接口说明
- 全球股票筛选器国别参数标准枚举:在调用股票筛选器按国家过滤标的(如筛选在美上市的中概股、以色列科技股或巴西资源股)时,必须传入标准的两位国家简写代码。该接口提供全量受支持的国别代码枚举,确保跨区域选股参数准确无误。
- 中概股与跨国上市企业属地识别:许多在纽交所或纳斯达克挂牌的上市公司,其实际经营总部位于中国、英国、日本或拉美地区。结合该国别字典对全市场公司档案进行地域切分,可快速剥离出特定国家背景的海外上市股票群组。
- 全球组合地缘风险敞口与白名单管控:面对汇率剧烈波动、贸易摩擦或跨境监管政策变化,机构风控系统可依据该国家编码体系汇总投资组合的地域持仓权重,对特定国家或地区的资产敞口实施限额监控与压力测试。
- 关联数据线接口:Stock Screener(条件选股) · Company Profile Data(公司概况) · Company Profile Bulk(公司概况批量) · Eod Bulk(日线行情批量)
调用代码示例
Python 关键代码请求 可用国家清单(/stable/available-countries,仅 apikey),解析后可得 country(国家/地区) 共 1 项数据。
resp = requests.get(
"https://quote-fmp.com/stable/available-countries",
params={"apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量可用国家清单初始化本地主表 | GET /stable/available-countries(免参数) | /stable/available-countries 为一次性全量输出(1 列,含 country);首次建库与周期性覆盖都走它。 |
| 以 country 为唯一键覆盖写入,避免全表重复 | GET /stable/available-countries → upsert on country | country 在全表内唯一(样本 FK),1 列按该键 upsert 即可幂等;无法按单条重取,补数须重跑全量。 |
| 落库后自检:country 唯一性对账 | GET /stable/available-countries → count(distinct country) | 本表仅 1 列(country 为唯一标识)。落库后比对 count(distinct country) 与接口实际返回条数,两者一致即无重复写入。 |
拉取可用国家清单(/stable/available-countries,免业务参数)时,返回的 country(如 FK)可直接缓存在本地内存或 Redis 字典中,减少重复网络请求。
可用国家清单(/stable/available-countries)全部 1 列均为文本或日期属性,按 (country) 建主键并将 country(国家/地区)设为 TEXT 类型最为稳妥。
返回数据
1 个字段本接口示例响应共包含 1 个字段(数值型 0 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
country | string | "FK" | 国家/地区 |
查看响应数据示例(原始 JSON)
[
{
"country": "FK"
}
]常见问题解答(FAQ)
2 个问题可用国家清单(共 1 列)与 全部股票代码清单(共 2 列)在工程调用中怎么配合?
在参数上,可用国家清单(/stable/available-countries)为免业务参数,输出 country(FK)等 1 列;Company Symbols List(全部股票代码清单)为无必填参数,输出 2 列,可按需串联调用。
在多资产或长周期策略中使用可用国家清单(/stable/available-countries),请求参数该如何编排?
调用 /stable/available-countries 时宜免过滤参数访问 /stable/available-countries 一次性导出完整截面;冷启动全量回填可分批执行,日常盘后则只拉最新一期 country(国家/地区)。
同模块相关接口对比
Directory本接口路径 /stable/available-countries,无必填参数。 同一模块「Directory」下共 11 个接口,下表列出其余 10 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 全部股票代码清单Company Symbols List | /stable/stock-list | 平台覆盖的全球各大交易所全部股票、ETF 及可交易金融工具的完整代码总表 |
| 报表公司清单Financial Statement Symbols List | /stable/financial-statement-symbol-list | 全市场所有具备标准化财务三表数据的上市公司代码清单 |
| CIK 编号清单CIK List | /stable/cik-list | 全市场 SEC 注册实体的中央索引键(CIK)与机构/公司标准名称的分页目录 |
| 股票代码变更清单Symbol Changes List | /stable/symbol-change | 汇总全市场因公司更名、并购重组、借壳上市或拆合股而发生的股票代码变更历史台账 |
| ETF代码检索ETF Symbol Search | /stable/etf-list | 全球主要交易所挂牌的全部交易所交易基金(ETF)代码与基金名称完整目录 |
| 在市活跃交易清单Actively Trading List | /stable/actively-trading-list | 当前在全球公开交易所处于正常挂牌交易状态的全部股票与金融工具代码清单 |
| 业绩电话会纪要代码清单Earnings Transcript List | /stable/earnings-transcript-list | 全市场所有已收录业绩电话会文字纪要的上市公司代码清单及每家公司可查的历史纪要总篇数 |
| 可用交易所清单Available Exchanges | /stable/available-exchanges | 平台支持的所有全球证券交易所标准字典 |
| 可用板块清单Available Sectors | /stable/available-sectors | 平台采用的一级行业板块标准分类清单 |
| 可用细分行业清单Available Industries | /stable/available-industries | 平台采用的二级细分行业标准分类全量清单 |