$npx -y skills add FTShare-Lab/FTShare-skills --skill eastmoney-us-stock-list查询东财美股列表。当用户需要获取东财美股全量列表(~5700+ 只),含代码、名称、市值、最新价、涨跌幅、市盈率等字段,支持服务端分页,或了解东财美股列表时使用。
| 1 | # 查询东财美股列表 |
| 2 | |
| 3 | ## 接口说明 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |---|---| |
| 7 | | 接口名称 | 查询东财美股列表 | |
| 8 | | 外部接口 | `/api/v1/market/data/eastmoney-us-stock-list` | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 获取东财美股全量列表(~5700+ 只),含代码、名称、市值、最新价、涨跌幅、市盈率等字段,支持服务端分页 | |
| 11 | |
| 12 | ## 请求参数 |
| 13 | |
| 14 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 15 | |--------|------|----------|------|----------|------| |
| 16 | | `--page` | int | 否 | 页码 | `1` | 从 1 开始,默认 1 | |
| 17 | | `--page_size` | int | 否 | 每页条数 | `50` | 默认 50 | |
| 18 | | `--all` | flag | 否 | 返回全量 | — | 返回全量数据(不分页) | |
| 19 | |
| 20 | **说明**:`--page`/`--page_size` 为全量拉取后在客户端切片的分页参数。 |
| 21 | |
| 22 | ## 执行方式 |
| 23 | |
| 24 | 通过根目录的 `run.py` 调用: |
| 25 | |
| 26 | ```bash |
| 27 | python <RUN_PY> eastmoney-us-stock-list |
| 28 | python <RUN_PY> eastmoney-us-stock-list --page 1 --page_size 50 |
| 29 | python <RUN_PY> eastmoney-us-stock-list --all |
| 30 | ``` |
| 31 | |
| 32 | > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径,参见主 SKILL.md 的「调用方式」说明。 |
| 33 | |
| 34 | ## 响应结构 |
| 35 | |
| 36 | 顶层为分页包装对象(客户端包装): |
| 37 | |
| 38 | | 字段名 | 类型 | 描述 | |
| 39 | |--------|------|------| |
| 40 | | `code` | int | 业务状态码,成功为 `0` | |
| 41 | | `message` | string | 业务消息 | |
| 42 | | `data` | object/null | 分页数据体;无数据时可能为 `null` | |
| 43 | | `data.pageNum` | int | 当前页码 | |
| 44 | | `data.pageSize` | int | 每页条数 | |
| 45 | | `data.total` | int | 总记录数 | |
| 46 | | `data.pages` | int | 总页数 | |
| 47 | | `data.records` | array | 当前页记录列表 | |
| 48 | |
| 49 | `data.records[]` 单条记录字段(**全部字段按字符串返回**): |
| 50 | |
| 51 | | 字段名 | 类型 | 描述 | 列表接口 | latest-ohlc fallback | |
| 52 | |--------|------|------|---------|---------------------| |
| 53 | | `secid` | string | 证券 ID,如 `105.AAL` | ✅ | ✅ | |
| 54 | | `market` | string | 市场编号,如 `105` | ✅ | ✅ | |
| 55 | | `code` | string | 股票代码,如 `AAL` | ✅ | ✅ | |
| 56 | | `name` | string | 股票名称 | ✅ | ✅ | |
| 57 | | `market_value_usd` | string | 市值(美元) | ✅ | 空 | |
| 58 | | `latest_price` | string | 最新价 | ✅ | 取自 `close` | |
| 59 | | `change_pct` | string | 涨跌幅(%) | ✅ | 空 | |
| 60 | | `volume` | string | 成交量 | ✅ | ✅ | |
| 61 | | `amount` | string | 成交额 | ✅ | ✅ | |
| 62 | | `pe_ttm` | string | 市盈率 TTM | ✅ | 空 | |
| 63 | |
| 64 | ### 响应示例 |
| 65 | |
| 66 | ```json |
| 67 | { |
| 68 | "code": 0, |
| 69 | "message": "success", |
| 70 | "data": { |
| 71 | "pageNum": 1, |
| 72 | "pageSize": 50, |
| 73 | "total": 5722, |
| 74 | "pages": 115, |
| 75 | "records": [ |
| 76 | { |
| 77 | "secid": "105.AAL", |
| 78 | "market": "105", |
| 79 | "code": "AAL", |
| 80 | "name": "美国航空", |
| 81 | "market_value_usd": "1234567890", |
| 82 | "latest_price": "13.444", |
| 83 | "change_pct": "-4.59", |
| 84 | "volume": "64552347", |
| 85 | "amount": "874794464.0000", |
| 86 | "pe_ttm": "15.6" |
| 87 | } |
| 88 | ] |
| 89 | } |
| 90 | } |
| 91 | ``` |
| 92 | |
| 93 | ## 注意事项 |
| 94 | |
| 95 | - 所有数值字段均为字符串格式 |
| 96 | - `code` 为东财美股代码(如 `AAL`),非 A 股 `600000.SH` 格式 |
| 97 | - `data` 在错误或无数据时可能为 `null` |
| 98 | - 服务端分页,`--all` 时内部以 500 条/页全量拉取后合并 |
| 99 | - 不覆盖苹果等美股大盘蓝筹,以东财中小盘和中概股为主 |