股票列表查询

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Basics.md

所属接口集：股票基础数据

请求 URL

GET /v1/api/basics

认证方式

Bearer Token（详见 认证与签名）

接口概述

分页查询股票基础信息列表，支持按代码、名称、市场、行业、板块、地区、状态等多维度筛选。

请求参数

参数	类型	必填	说明
code	string	否	股票代码，多个以逗号分隔，支持6位纯数字或带后缀（如 600000、600000.SH、sh600000）
q	string	否	名称模糊搜索（等同于 name 参数）
name	string	否	名称模糊搜索（按名称子串匹配）
market	string	否	市场，如 SH、SZ
industry	string	否	行业，精确匹配
board	string	否	板块，如 主板、创业板、科创板
region	string	否	地区，精确匹配
status	string	否	状态，如 A（正常交易）
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 50，最大 200

接口说明

• code 参数支持多种格式输入，内部会统一规范化为6位纯数字代码进行查询。
• q 与 name 均为名称模糊搜索，效果相同，使用 icontains 匹配（不区分大小写）。
• market、industry、board、region、status 为精确匹配。
• 结果按 code 升序排列。
• 分页参数 page 最小为 1，page_size 范围为 1~200。

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "page": 1,
    "page_size": 50,
    "total": 123,
    "items": [
      {
        "code": "600000",
        "ts_code": "600000.SH",
        "name": "浦发银行",
        "market": "SH",
        "board": "主板",
        "industry": "银行",
        "industry_lv2": "银行",
        "region": "上海",
        "list_date": "1999-11-10",
        "delist_date": null,
        "status": "A",
        "lot_size": 100,
        "total_shares": 29384000000,
        "float_shares": 24000000000,
        "free_float_shares": 23000000000,
        "total_mv": 3.50e+11,
        "circ_mv": 2.70e+11,
        "pe_ttm": 5.12,
        "pb": 0.55,
        "eps": 1.23,
        "dps": 0.30,
        "roe": 10.50,
        "company_name": "上海浦东发展银行股份有限公司",
        "website": "https://www.spdb.com.cn",
        "province": "上海",
        "city": "上海",
        "source": "tencent",
        "source_at": "2025-08-12T10:00:00+08:00",
        "updated_at": "2025-08-12T10:00:00+08:00"
      }
    ]
  }
}

返回状态

状态码	说明
200	成功
400	参数错误
401	未认证
403	无权限
404	资源不存在

---