Eastmoney us stock list

查询东财美股列表

接口说明

项目	说明
接口名称	查询东财美股列表
外部接口	/api/v1/market/data/eastmoney-us-stock-list
请求方式	GET
适用场景	获取东财美股全量列表（~5700+ 只），含代码、名称、市值、最新价、涨跌幅、市盈率等字段，支持服务端分页

请求参数

参数名	类型	是否必填	描述	取值示例	备注
--page	int	否	页码	1	从 1 开始，默认 1
--page_size	int	否	每页条数	50	默认 50
--all	flag	否	返回全量	—	返回全量数据（不分页）

说明：--page/--page_size 为全量拉取后在客户端切片的分页参数。

执行方式

通过根目录的 run.py 调用：

python <RUN_PY> eastmoney-us-stock-list
python <RUN_PY> eastmoney-us-stock-list --page 1 --page_size 50
python <RUN_PY> eastmoney-us-stock-list --all

<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径，参见主 SKILL.md 的「调用方式」说明。

响应结构

顶层为分页包装对象（客户端包装）：

字段名	类型	描述
code	int	业务状态码，成功为 0
message	string	业务消息
data	object/null	分页数据体；无数据时可能为 null
data.pageNum	int	当前页码
data.pageSize	int	每页条数
data.total	int	总记录数
data.pages	int	总页数
data.records	array	当前页记录列表

data.records[] 单条记录字段（全部字段按字符串返回）：

字段名	类型	描述	列表接口	latest-ohlc fallback
secid	string	证券 ID，如 105.AAL	✅	✅
market	string	市场编号，如 105	✅	✅
code	string	股票代码，如 AAL	✅	✅
name	string	股票名称	✅	✅
market_value_usd	string	市值（美元）	✅	空
latest_price	string	最新价	✅	取自 close
change_pct	string	涨跌幅（%）	✅	空
volume	string	成交量	✅	✅
amount	string	成交额	✅	✅
pe_ttm	string	市盈率 TTM	✅	空

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 50,
    "total": 5722,
    "pages": 115,
    "records": [
      {
        "secid": "105.AAL",
        "market": "105",
        "code": "AAL",
        "name": "美国航空",
        "market_value_usd": "1234567890",
        "latest_price": "13.444",
        "change_pct": "-4.59",
        "volume": "64552347",
        "amount": "874794464.0000",
        "pe_ttm": "15.6"
      }
    ]
  }
}

注意事项

• 所有数值字段均为字符串格式
• code 为东财美股代码（如 AAL），非 A 股 600000.SH 格式
• data 在错误或无数据时可能为 null
• 服务端分页，--all 时内部以 500 条/页全量拉取后合并
• 不覆盖苹果等美股大盘蓝筹，以东财中小盘和中概股为主