公司资料

查询上市公司基本资料。

GET/api/v1/fundamentals/profile
数据域
公司基本面
解析层级
上市公司实体
MCP 工具
fundamentals_query (task=profile)

可查询数据

返回数据
上市公司基本资料
市场覆盖
美股、港股
查询粒度
每次查询一家公司

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

公司定位

建议填写 query、symbol 或 ticker;留空时接口返回 no_data。

querystringquery示例AAPL可选

查询关键词、代码或名称。

symbolstringquery示例AAPL可选

资产代码。

tickerstringquery示例AAPL可选

资产代码。

查询选项

均为可选。

marketMarketquery示例us_equity可选

标准市场代码。

limitintegerquery示例20可选

返回条数。

响应

dataobject
profileobject

公司资料:company_name、description、management、profile_items 等

entity_idstring示例entity_sec_cik_0000320193

主体标识,标识公司、项目方或协议等主体

company_namestring示例苹果

公司名称

descriptionstring | null示例苹果公司从事智能手机、个人电脑、平板电脑、可穿戴设备和配件的设计、制造和销售,以…

公司简介

websitestring | null示例http://www.apple.com

公司网站

industrystring | null

行业

sectorstring | null

板块

business_scopestring | null

业务范围

headquarters_countrystring | null示例US

总部国家

reporting_currencystring | null

报告货币

employee_countnumber | null示例166000

员工人数

profile_as_ofstring | null示例2026-07-22T18:37:17.000+0000

资料快照日

data_statusDataStatus示例partial

资料就绪状态

empty_reasonstring | null示例profile_classification_incomplete

资料空原因

management[]object[]

管理层名单

management_namestring示例Mr. Timothy D. Cook

姓名

management_positionstring示例CEO

职位

profile_items[]object[]

扩展资料键值

profile_keystring示例founded_date

资料键

profile_namestring示例成立日期

资料展示名

profile_valuestring示例1976

资料值

field_typestring示例0

字段类型

empty_fields[]object[]

缺失字段及 empty_reason(partial 时)

fieldstring示例sector

缺失字段名

empty_reasonstring示例profile_classification_missing

缺失原因码

data_statusDataStatus示例partial

ok / partial / no_data / not_ready / stale

empty_reasonstring | null示例profile_classification_incomplete

空结果或部分缺失原因码

errorobject | null

错误对象(code / message)。

metadataobject
actual_taskstring示例profile

实际路由任务:profile / statements / metrics / …

data_statusDataStatus示例partial

ok / partial / no_data / not_ready / stale

limitations[]string[]示例serving_mvp

覆盖 / MVP 限制标记

route_reasonstring示例explicit_task

路由原因(如 explicit_task)

updated_atdatetime | string示例2026-08-17T08:24:43Z

响应更新时间(UTC)

partialboolean示例true

载荷故意不完整时为 true(有则返回)

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例entity

对象引用类型

idstring示例entity_sec_cik_0000320193

对象标识,标识 type 指定的具体对象

entity_idstring示例entity_sec_cik_0000320193

主体标识,标识公司、项目方或协议等主体

asset_idstring示例asset_aapl_common_stock

资产标识,标识股票、加密资产等资产对象

listing_idstring示例listing_aapl_xnas

交易场所挂牌标识,标识某个交易品种在特定交易场所的挂牌记录

instrument_idstring示例instrument_aapl_common_stock

交易工具标识,标识股票、现货交易对或合约等具体交易产品

venue_idstring示例venue_xnas

交易场所标识,标识交易所或交易平台

external_refs[]object[]

外部引用(如 SEC EDGAR filings)

lineage_refs[]object[]

血缘引用(公开体通常为空数组)

source_refs[]object[]

数据来源引用(公开体通常为空数组)

错误与降级

200
assets_resolve 名称多命中;从 data[] 候选确认。
200
对象已解析但无可用数据;empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效,或行情 listing 多命中;歧义响应含 required_params + candidates。
401
缺少 API Key,或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在;数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限;body 返回 retry_after,响应头同步返回 Retry-After。