DataBull

美股股票列表

公开接口

美股 US Stock · 美股股票列表

分页返回美股股票列表，每条含股票代码、名称与所属市场标识，可用作关联美股行情、财务数据时的主键映射表。

接口地址

GET /us/stocks
完整地址：https://api.databull.cn/us/stocks

接口说明

分页返回美股股票列表，每条含 symbol、name、market。响应为 {"code": 0, "data": {...}} 信封。

美股清单每日自动同步，覆盖全市场普通股票（不含指数/ETF/基金/权证），约 2 万只，**必须分页**（默认 100/页，最大 500）；结果按 symbol 升序，翻页稳定不重复、不遗漏。

支持可选搜索：
- q：关键词，模糊匹配股票代码或名称（英文），大小写不敏感；
- exchange：交易所过滤（NYSE / NASDAQ / AMEX 等），按代码后缀匹配。
两者可叠加，留空则返回全量分页。

请求参数

参数位置类型必填默认说明
q查询string否搜索关键词，模糊匹配代码或名称；留空返回全量
exchange查询string否交易所过滤：NYSE / NASDAQ / AMEX；留空不过滤
page查询integer否1页码，从 1 开始；不小于 1
page_size查询integer否100每页条数，1~500；取值 1~500

返回字段

字段类型说明
codenumber业务状态码，0 表示成功
dataobject分页结果对象
data.itemsarray股票记录数组，按 symbol 升序
data.items[].symbolstring美股代码，如 AAPL
data.items[].namestring股票名称（英文原名）
data.items[].marketstring市场标识，如 us
data.totalnumber满足筛选条件的总条数
data.page / data.page_sizenumber当前页码 / 每页条数
data.has_moreboolean是否还有下一页
empty_reasonstring仅当 items 为空时出现，标注为空的原因（见下）

接口示例

cURL
curl "https://api.databull.cn/us/stocks" \
  -H "Authorization: Bearer $DATABULL_API_KEY"
Python
from databull import DataBull

client = DataBull(api_key="YOUR_API_KEY")
result = client.get_us_stock_list(page=1, page_size=100)
print(result)

响应示例

JSON
{
  "code": 0,
  "data": {
    "items": [
      {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "market": "us"
      }
    ],
    "total": 20281,
    "page": 1,
    "page_size": 100,
    "has_more": true
  }
}

错误码

状态码触发条件
403当前套餐不包含该市场数据，升级套餐后可用

说明

  • 响应为 {"code": 0, "data": {...}} 信封结构。
  • 美股清单每日自动同步，覆盖 NYSE / NASDAQ / AMEX / BATS / OTC 等全市场普通股票（不含指数 / ETF / 基金 / 权证等），全量约 2 万只，随上市退市动态增减。
  • 必须分页（默认 100/页，最大 500）；结果按 symbol 升序，翻页稳定不重复、不遗漏。
  • q 同时匹配代码与名称，大小写不敏感（如 aapl / apple 都能命中 AAPL / Apple Inc）。
  • exchange 按代码后缀过滤，如 NYSE / NASDAQ / AMEX；取值需与库中一致，传错返回空列表。
  • 清单为空时（尚未同步）返回 empty_reason: catalog_not_synced；页码越界返回 page_out_of_range。
  • 该接口属于「美股」数据域，需付费套餐（专业版及以上）方可调用；免费版仅覆盖 A 股。