美股标的详情
公开接口美股 US Stock · 美股标的详情
查询美股标的的完整档案信息。覆盖本地清单之外的标的，字段比 /us/stock/info 更全。
接口地址
GET /us/stock/details完整地址：
https://api.databull.cn/us/stock/details接口说明
查询美股标的的完整档案信息。
含 name（英文名）、primary_exchange（主交易所）、type（证券类型）、cik（SEC 代码）、market_cap（总市值）、sic_code / sic_description（行业分类）、total_employees、list_date（上市日）、homepage_url、address（注册地址）、description（业务简介）等。
相比 /us/stock/info 字段更全，且不依赖本地清单同步进度，因此也覆盖本地 stocks 表里没有的标的。
代码格式非法返回 400；无此标的返回 404。
结果缓存 1 小时，高频调用请自行控制节奏。
请求参数
参数位置类型必填默认说明
symbol查询string否AAPL美股代码，如 AAPL返回字段
字段类型说明
tickerstring美股代码namestring英文名称marketstring市场，如 stocks / crypto / forexlocalestring地区，如 usprimary_exchangestring主交易所代码，如 XNAS / XNYStypestring证券类型，如 CS 普通股 / ETFcikstringSEC 的 CIK 代码market_capnumber总市值（美元）sic_codestringSIC 行业代码sic_descriptionstringSIC 行业名称total_employeesinteger员工人数list_datestring上市日期homepage_urlstring官网地址descriptionstring业务简介接口示例
cURL
curl "https://api.databull.cn/us/stock/details?symbol=AAPL" \
-H "Authorization: Bearer $DATABULL_API_KEY"Python
import requests
url = "https://api.databull.cn/us/stock/details"
params = {
"symbol": "AAPL",
}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(url, params=params, headers=headers, timeout=10)
resp.raise_for_status()
print(resp.json())响应示例
JSON
{
"ticker": "AAPL",
"name": "Apple Inc.",
"market": "stocks",
"locale": "us",
"primary_exchange": "XNAS",
"type": "CS",
"cik": "0000320193",
"market_cap": 4820749537600.0,
"total_employees": 164000
}错误码
状态码触发条件
400证券代码格式非法
404无此标的
502服务暂时不可用，可稍后重试
403当前套餐不包含该市场数据，升级套餐后可用
说明
- 相比 `/us/stock/info` 字段更全，且不受本地清单同步进度限制；若只做代码/名称校验，用 `/us/stock/info` 即可。
- 响应为 `{"code": 0, "data": {...}}`。
- 该接口属于「美股」数据域，需付费套餐（专业版及以上）方可调用；免费版仅覆盖 A 股。
Esc