美股基本信息

公开接口

美股 US Stock · 美股基本信息

返回美股标的的基础信息与公司档案。

接口地址

GET /us/stock/info
完整地址:https://api.databull.cn/us/stock/info

接口说明

返回美股基础信息与公司档案(profile)。

profile 含公司简介、细分行业与一级板块、官网、币种、注册国家、员工人数、上市日期(ipo_date)与 ISIN。档案为静态信息、按日更新,**不含行情与估值字段** —— 最新价、市值、市盈率、52 周高低等请用 /us/stock/details。

代码格式非法返回 401,库中无此股票返回 404。响应为记录对象,无信封结构。

请求参数

参数位置类型必填默认说明
symbol查询string否AAPL美股代码,如 AAPL

返回字段

字段类型说明
symbolstring美股代码,如 AAPL
namestring标的名称为英文原名
marketstring市场标识,如 us
profileobject公司档案对象;无档案时为空对象
profile.company_namestring公司英文全称
profile.company_introductionstring业务简介
profile.industrystring细分行业
profile.sectorstring一级板块
profile.websitestring官网
profile.currencystring计价币种,如 USD
profile.countrystring注册国家/地区代码,如 US
profile.employeesinteger员工人数
profile.ipo_datestring上市日期(YYYY-MM-DD)
profile.isinstringISIN 国际证券识别码

接口示例

cURL
curl "https://api.databull.cn/us/stock/info?symbol=AAPL" \
  -H "Authorization: Bearer $DATABULL_API_KEY"
Python
import requests

url = "https://api.databull.cn/us/stock/info"
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
{
  "symbol": "AAPL",
  "name": "Apple Inc.",
  "market": "us",
  "profile": {
    "company_name": "Apple Inc",
    "company_introduction": "Apple, Inc. engages in the design, manufacture, and sale of smartphones...",
    "industry": "Technology Hardware, Storage & Peripherals",
    "sector": "Information Technology",
    "website": "https://www.apple.com/",
    "currency": "USD",
    "country": "US",
    "employees": 166000,
    "ipo_date": "1980-12-12",
    "isin": "US0378331005"
  }
}

错误码

状态码触发条件
401证券代码格式非法
404库中不存在该标的
403当前套餐不包含该市场数据,升级套餐后可用

说明

  • 响应为记录对象本身,无信封结构。
  • 档案为静态信息、按日更新,不含行情与估值字段;最新价、市值、市盈率、52 周高低等请用 美股标的详情。
  • 该接口属于「美股」数据域,需付费套餐(专业版及以上)方可调用;免费版仅覆盖 A 股。