Us basic

查询美股基础信息列表（native）

接口说明

项目	说明
接口名称	对外接口-查询美股列表
匹配键	us-basic
外部接口	GET /api/v1/market/data/us/us-basic
请求方式	GET
适用场景	查询美股基础信息（代码、中英文名称、上市/退市日期），支持全量分页或精确查单只。数据来源 ClickHouse basedata.usstk_securityinfo，约 5315 只。

请求参数

参数名	类型	是否必填	描述	取值示例	备注
stock_code	string	否	美股代码（纯代码，不带交易所后缀）	NVDA	不传返回全部（分页）；传则精确查单只（≤1 条）
page	int	否	页码	1	默认 1，从 1 开始
page_size	int	否	每页条数	50	默认 50，最大 500

模式	必填参数	说明
全量分页	无	返回全部美股（约 5315 只），按 security_code 升序
精确查单股	stock_code	返回指定股票基础信息（最多 1 条）

执行方式

# 精确查英伟达
python scripts/handler.py --stock_code NVDA
# 分页查询美股列表
python scripts/handler.py --page 1 --page_size 50
# 全量自动翻页
python scripts/handler.py --all

响应结构

{
  "items": [
    {
      "stock_code": "NVDA",
      "name": "英伟达",
      "enname": "Nvidia Corporation",
      "classify": "",
      "list_date": "1999-01-22",
      "delist_date": ""
    }
  ],
  "total_pages": 1,
  "total_items": 1
}

字段说明（UsBasicItem）

字段名	类型	说明
stock_code	string	美股代码（纯代码），如 NVDA、AAPL
name	string	中文名称，如 英伟达
enname	string	英文名称，如 Nvidia Corporation
classify	string	分类（ADR/GDR/EQ），底表无此信息，固定空字符串
list_date	string	上市日期 YYYY-MM-DD
delist_date	string	退市日期 YYYY-MM-DD，未退市为空字符串

注意事项

• 股票代码用纯代码（NVDA），不带交易所后缀（.O=纳斯达克、.N=纽交所）。
• classify（ADR/GDR/EQ）底表无来源，固定返回空字符串（中概股 ADR 与普通美股结构一致，无法区分）。
• stock_code 不存在不报错，返回 200 + items: []、total_items: 0。
• 与 eastmoney-us-stock-list 区别：本接口返回基础信息（名称/上市日期），后者返回东财行情（最新价/市值/涨跌幅/PE）。查"美股有哪些/代码/名称/上市日期"用本接口；查"美股最新价/市值/PE"用 eastmoney-us-stock-list。
• 财务三表查询用同样的纯代码 stock_code。