公司资料
查询上市公司基本资料。
GET/api/v1/fundamentals/profile
可查询数据
- 返回数据
- 上市公司基本资料
- 市场覆盖
- 美股、港股
- 查询粒度
- 每次查询一家公司
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
公司定位
建议填写 query、symbol 或 ticker;留空时接口返回 no_data。
querystringquery示例AAPL可选查询关键词、代码或名称。
symbolstringquery示例AAPL可选资产代码。
tickerstringquery示例AAPL可选资产代码。
响应
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资料快照日
资料就绪状态
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缺失原因码
ok / partial / no_data / not_ready / stale
empty_reasonstring | null示例profile_classification_incomplete空结果或部分缺失原因码
errorobject | null错误对象(code / message)。
metadataobject
actual_taskstring示例profile实际路由任务:profile / statements / metrics / …
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[]
统一对象引用数组
对象引用类型
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。