美股 标的概览 · REST 接口
单标的美股详情。获取指定标的（截至某日期仍处于交易状态）的完整资料，包括主交易所、标准化标识（CIK、综合 FIGI、股份类别 FIGI）、市值、行业分类与关键日期，并提供 Logo、图标等品牌素材。若需查询已退市标的，请在「全部标的」接口中使用 active=false。
GET /v3/reference/tickers/{ticker}上游时效说明
每日更新
上游历史范围
数据可追溯至 2003 年 9 月 10 日
适用场景
- 公司研究、数据集成、应用增强、尽职调查与合规。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ticker | string | Yes | 指定区分大小写的标的代码。例如 AAPL 代表苹果公司。 |
date | string | No | 指定一个时点，获取该日期可用的标的资料。处理 SEC 申报文件时，系统会把该日期与 SEC 申报文件中的报告期日期比对。例如某份 AAPL 的 SEC 申报文件于 2019-07-31 提交、报告期截至 2019-06-29，说明申报文件虽在 7 月 31 日提交，但内容基于 2019-06-29 的信息；此时查询 2019-06-29 的标的资料，就会包含该申报文件的信息。默认为最近可用日期。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
count | integer | 本次请求的结果总数。 |
request_id | string | 服务器分配的请求 ID。 |
results | object | 带详细资料的标的。 |
results.active | boolean | 该资产是否仍在活跃交易。false 表示已退市。 |
results.address | object | 公司总部地址信息。 |
results.branding | object | 提供用于视觉识别的图片地址（如 Logo）。 |
results.cik | string | 该标的的 CIK 编号。 |
results.composite_figi | string | 该标的的综合 OpenFIGI 编号。 |
results.currency_name | string | 该资产的计价货币。 |
results.delisted_utc | string | 该资产最后交易的日期。 |
results.description | string | 公司及其业务的说明。 |
results.homepage_url | string | 公司官网首页地址。 |
results.list_date | string | 该代码首次公开上市的日期，格式 YYYY-MM-DD。 |
results.locale | enum: us, global | 该资产的地域代码。 |
results.market | enum: stocks, crypto, fx, otc, indices | 该资产的市场类型。 |
results.market_cap | number | 该标的最新收盘价乘以加权流通在外股数，即总市值。 |
results.name | string | 资产名称。股票类资产为公司的注册名称；加密货币与外汇则为币种或货币对的名称。 |
results.phone_number | string | 该标的所属公司的联系电话。 |
results.primary_exchange | string | 该资产主上市交易所的 ISO 代码。 |
results.round_lot | number | 该证券的整手交易单位。 |
results.share_class_figi | string | 该标的的股份类别 OpenFIGI 编号。 |
results.share_class_shares_outstanding | number | 该股份类别登记的流通在外股数。 |
results.sic_code | string | 该标的的标准行业分类（SIC）代码。 |
results.sic_description | string | 该标的 SIC 代码的说明。 |
results.ticker | string | 该标的在交易所使用的交易代码。 |
results.ticker_root | string | 标的代码的词根。例如 BRK.A 的词根是 BRK。 |
results.ticker_suffix | string | 标的代码的后缀。例如 BRK.A 的后缀是 A。 |
results.total_employees | number | 公司约略的员工人数。 |
results.type | string | 资产类型，可在「标的类型」接口中查看支持的全部类型。 |
results.weighted_shares_outstanding | number | 假设其他股份类别全部转换为本类别后计算的流通在外股数。 |
status | string | 本次请求响应的状态。 |
响应示例
{
"request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
"results": {
"active": true,
"address": {
"address1": "One Apple Park Way",
"city": "Cupertino",
"postal_code": "95014",
"state": "CA"
},
"branding": {
"icon_url": "https://api.massive.com/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_icon.png",
"logo_url": "https://api.massive.com/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_logo.svg"
},
"cik": "0000320193",
"composite_figi": "BBG000B9XRY4",
"currency_name": "usd",
"description": "Apple designs a wide variety of consumer electronic devices, including smartphones (iPhone), tablets (iPad), PCs (Mac), smartwatches (Apple Watch), AirPods, and TV boxes (Apple TV), among others. The iPhone makes up the majority of Apple's total revenue. In addition, Apple offers its customers a variety of services such as Apple Music, iCloud, Apple Care, Apple TV+, Apple Arcade, Apple Card, and Apple Pay, among others. Apple's products run internally developed software and semiconductors, and the firm is well known for its integration of hardware, software and services. Apple's products are distributed online as well as through company-owned stores and third-party retailers. The company generates roughly 40% of its revenue from the Americas, with the remainder earned internationally.",
"homepage_url": "https://www.apple.com",
"list_date": "1980-12-12",
"locale": "us",
"market": "stocks",
"market_cap": 2771126040150,
"name": "Apple Inc.",
"phone_number": "(408) 996-1010",
"primary_exchange": "XNAS",
"round_lot": 100,
"share_class_figi": "BBG001S5N8V8",
"share_class_shares_outstanding": 16406400000,
"sic_code": "3571",
"sic_description": "ELECTRONIC COMPUTERS",
"ticker": "AAPL",
"ticker_root": "AAPL",
"total_employees": 154000,
"type": "CS",
"weighted_shares_outstanding": 16334371000
},
"status": "OK"
}原文：Massive 文档 ↗