美股 全部标的代码 · REST 接口
获取 Massive 上游支持的全部标的代码清单,覆盖股票、指数、外汇、加密货币等多个资产类别。每个条目给出代码、名称、市场、币种与是否仍在交易等关键信息。
GET /v3/reference/tickers上游时效说明
每日更新
上游历史范围
数据可追溯至 2003 年 9 月 10 日
适用场景
- 标的发现、数据集成、筛选与选股、应用开发。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ticker | string | No | 指定标的代码。留空则查询全部标的。 |
type | string | No | 指定标的类型,支持的类型见「标的类型」接口。留空则查询全部类型。 |
market | string | No | 按市场类型筛选。默认包含全部市场。 |
exchange | string | No | 按 ISO 10383 指定资产主交易所的市场识别码(MIC)。留空则查询全部交易所。 |
cusip | string | No | 指定要查询的资产 CUSIP 代码。留空则查询全部。注意:虽然支持按 CUSIP 查询,但出于法律原因,响应中不会返回 CUSIP。 |
cik | string | No | 指定要查询的资产 CIK。留空则查询全部。 |
date | string | No | 指定一个时点,获取该日期可用的标的。默认为最近可用日期。 |
search | string | No | 在标的代码与公司名称中搜索关键词。 |
active | boolean | No | 指定返回的标的是否需在查询日期处于活跃交易状态,默认 true。 |
ticker.gte | string | No | 按 ticker 范围筛选。 |
ticker.gt | string | No | 按 ticker 范围筛选。 |
ticker.lte | string | No | 按 ticker 范围筛选。 |
ticker.lt | string | No | 按 ticker 范围筛选。 |
order | string | No | 按 sort 字段对结果排序。 |
limit | integer | No | 限制返回结果数量,默认 100,最大 1000。 |
sort | string | No | 用于排序的字段。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
count | integer | 本次请求的结果总数。 |
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 符合查询条件的标的数组。注意:虽然支持按 CUSIP 查询,但出于法律原因,响应中不会返回 CUSIP。 |
results[].active | boolean | 该资产是否仍在活跃交易。false 表示已退市。 |
results[].base_currency_name | string | 该资产的计价货币名称。 |
results[].base_currency_symbol | string | 该资产计价货币的 ISO 4217 代码。 |
results[].cik | string | 该标的的 CIK 编号。 |
results[].composite_figi | string | 该标的的综合 OpenFIGI 编号。 |
results[].currency_name | string | 该资产的计价货币。 |
results[].currency_symbol | string | 该资产交易货币的 ISO 4217 代码。 |
results[].delisted_utc | string | 该资产最后交易的日期。 |
results[].last_updated_utc | string | 该信息截至此时间准确。 |
results[].locale | enum: us, global | 该资产的地域代码。 |
results[].market | enum: stocks, crypto, fx, otc, indices | 该资产的市场类型。 |
results[].name | string | 资产名称。股票类资产为公司的注册名称;加密货币与外汇则为币种或货币对的名称。 |
results[].primary_exchange | string | 该资产主上市交易所的 ISO 代码。 |
results[].share_class_figi | string | 该标的的股份类别 OpenFIGI 编号。 |
results[].ticker | string | 该标的在交易所使用的交易代码。 |
results[].type | string | 资产类型,可在「标的类型」接口中查看支持的全部类型。 |
status | string | 本次请求响应的状态。 |
响应示例
{
"count": 1,
"next_url": "https://api.massive.com/v3/reference/tickers?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
"request_id": "e70013d92930de90e089dc8fa098888e",
"results": [
{
"active": true,
"cik": "0001090872",
"composite_figi": "BBG000BWQYZ5",
"currency_name": "usd",
"last_updated_utc": "2021-04-25T00:00:00Z",
"locale": "us",
"market": "stocks",
"name": "Agilent Technologies Inc.",
"primary_exchange": "XNYS",
"share_class_figi": "BBG001SCTQY4",
"ticker": "A",
"type": "CS"
}
],
"status": "OK"
}原文:Massive 文档 ↗