# Eastmoney Us Stock List

> 查询东财美股列表。当用户需要获取东财美股全量列表（~5700+ 只），含代码、名称、市值、最新价、涨跌幅、市盈率等字段，支持服务端分页，或了解东财美股列表时使用。

- **Type:** Skill
- **Install:** `agentstack add skill-ftshare-lab-ftshare-skills-eastmoney-us-stock-list`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [FTShare-Lab](https://agentstack.voostack.com/s/ftshare-lab-2)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [FTShare-Lab](https://github.com/FTShare-Lab)
- **Source:** https://github.com/FTShare-Lab/FTShare-skills/tree/main/ftshare-market-data/sub-skills/eastmoney-us-stock-list
- **Website:** https://github.com/ftshare-lab/FTShare-skills

## Install

```sh
agentstack add skill-ftshare-lab-ftshare-skills-eastmoney-us-stock-list
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 查询东财美股列表

## 接口说明

| 项目 | 说明 |
|---|---|
| 接口名称 | 查询东财美股列表 |
| 外部接口 | `/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` 调用：

```bash
python  eastmoney-us-stock-list
python  eastmoney-us-stock-list --page 1 --page_size 50
python  eastmoney-us-stock-list --all
```

> `` 为主 `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 | ✅ | 空 |

### 响应示例

```json
{
  "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 条/页全量拉取后合并
- 不覆盖苹果等美股大盘蓝筹，以东财中小盘和中概股为主

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [FTShare-Lab](https://github.com/FTShare-Lab)
- **Source:** [FTShare-Lab/FTShare-skills](https://github.com/FTShare-Lab/FTShare-skills)
- **License:** MIT
- **Homepage:** https://github.com/ftshare-lab/FTShare-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ftshare-lab-ftshare-skills-eastmoney-us-stock-list
- Seller: https://agentstack.voostack.com/s/ftshare-lab-2
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.