# Stock Security Info

> Stock Security Info

- Skill: `dvcrn/stock-security-info` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/stock-security-info`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/stock-security-info/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/dvcrn/stock-security-info

---

# 查询单只股票/基金/指数信息

## 接口说明

| 项目 | 说明 |
|---|---|
| 接口名称 | 查询单只股票/基金/指数信息 |
| 外部接口 | `https://ftai.chat/api/v1/market/security/{symbol}/info` |
| 请求方式 | GET |
| 适用场景 | 按标的代码查询单只股票、基金或指数的实时行情、多周期涨跌幅及估值指标（市盈率、市净率、每股净资产等） |

> 注意：本接口域名为 `https://ftai.chat`，与其他子 skill 的 `https://market.ft.tech` 不同。

## 请求参数

说明：标的代码通过路径参数 `{symbol}` 传入，无需 Query 参数。

| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| symbol | string | 是 | 标的代码（路径参数） | 600519.SH | 带市场后缀，如 600519.SH、000001.SZ |

## 执行方式

通过根目录的 `run.py` 调用（推荐）：

```bash
python <RUN_PY> stock-security-info --symbol 600519.SH
```

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

## 响应说明

返回值为单只股票/基金/指数信息对象，包含实时行情、多周期涨跌幅及估值指标。数据模型如下：

```json
{
    "type": "stock",
    "symbol": "600519.SH",
    "symbol_id": "600519",
    "symbol_name": "贵州茅台",
    "board": "sh",
    "open": "1402.99",
    "high": "1405.99",
    "low": "1398.02",
    "close": "1400.97",
    "prev_close": "1401.88",
    "change": "-0.91",
    "change_rate": -0.000649128313407709,
    "avg": 1401.147216194,
    "amplitude": 0.00568522270094447,
    "volume": 1116784,
    "turnover": "1564778792.69",
    "turnover_rate": 0.000891807524145258,
    "ts_nanos": 1773197525000000000,
    "limit_up": "1542.07",
    "limit_down": "1261.69",
    "change_rate_day5": -0.0176834783584235,
    "change_rate_day10": -0.0448800109080993,
    "change_rate_day20": -0.0182410651716889,
    "change_rate_day60": 0.000676417458856033,
    "change_rate_ytd": -0.0175525946704067,
    "shares": 1252270215,
    "float_a_shares": 1252270215,
    "market_cap": "1754393003108.55",
    "float_a_market_cap": "1754393003108.55",
    "bvps": "181.3261",
    "eps_ttm": "71.8913",
    "pe_ttm": 19.4873371325877,
    "pb": 7.72624569766846,
    "ps_ttm": 9.82430926018285,
    "roe_ttm": 0.350206,
    "bid_ask_ratio": -0.735294117647059,
    "introduction": ""
}
```

### 响应结构（字段说明）

| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| type | String | 否 | 标的类型。取值：stock（股票）、index（指数）、etf（基金） | - |
| symbol | String | 否 | 标的代码，带市场后缀 | - |
| symbol_id | String | 否 | 标的 ID，不含市场后缀的数字代码 | - |
| symbol_name | String | 否 | 标的名称（股票/基金/指数名称） | - |
| board | String | 是 | 股票板块。取值：sh（上交所主板）、sz（深交所主板）、sz_chi_next（深交所创业板）、sh_star（上交所科创板）、bj（北交所）、hk（港股） | - |
| open | String | 是 | 开盘价 | 元 |
| high | String | 是 | 最高价 | 元 |
| low | String | 是 | 最低价 | 元 |
| close | String | 是 | 收盘价或最新价；公式 = 收盘价.or(最新价).or(前收盘价) | 元 |
| prev_close | String | 是 | 前收盘价。上市首日为发行价；除权(息)日为除权(息)参考价 | 元 |
| change | String | 否 | 涨跌额；公式 = 最新价 - 前收盘价 | 元 |
| change_rate | float | 否 | 涨跌幅；公式 = 涨跌额 / 前收盘价 | 小数 |
| avg | float | 是 | 均价；公式 = 成交额 / 成交量 | 元 |
| amplitude | float | 否 | 振幅；公式 = (最高价 - 最低价) / 前收盘价 | 小数 |
| volume | int | 否 | 成交量 | 股 |
| turnover | String | 否 | 成交额 | 元 |
| turnover_rate | float | 是 | 换手率；公式 = 成交量 / 流通股本 | 小数 |
| ts_nanos | number | 否 | 交易所时间戳，单位纳秒 | - |
| limit_up | String | 是 | 涨停价 | 元 |
| limit_down | String | 是 | 跌停价 | 元 |
| change_rate_day5 | float | 是 | 5 日涨跌幅 | 小数 |
| change_rate_day10 | float | 是 | 10 日涨跌幅 | 小数 |
| change_rate_day20 | float | 是 | 20 日涨跌幅 | 小数 |
| change_rate_day60 | float | 是 | 60 日涨跌幅 | 小数 |
| change_rate_ytd | float | 是 | 年初至今涨跌幅 | 小数 |
| shares | int | 是 | 股本（总股本） | 股 |
| float_a_shares | int | 是 | 流通 A 股股本 | 股 |
| market_cap | String | 是 | 市值；公式 = 股本 × 最新价 | 元 |
| float_a_market_cap | String | 是 | 流通 A 股市值；公式 = 流通 A 股股本 × 最新价 | 元 |
| bvps | String | 是 | 每股净资产 | 元/股 |
| eps_ttm | String | 是 | 每股收益（TTM） | 元/股 |
| pe_ttm | float | 是 | 市盈率（TTM） | - |
| pb | float | 是 | 市净率 | - |
| ps_ttm | float | 是 | 市销率（TTM） | - |
| roe_ttm | float | 是 | 净资产收益率（TTM） | 小数 |
| bid_ask_ratio | float | 是 | 委比；公式 = (买盘量 - 卖盘量) / (买盘量 + 卖盘量) | 小数 |
| introduction | String | 是 | 公司中文简介 | - |

## 注意事项

- 涨跌幅、换手率、振幅等比率字段均为小数形式，展示时乘以 100 转为百分比
- `market_cap`、`turnover` 等大数字为字符串，展示时可按需转换为亿元（除以 1e8）
- `introduction` 可为空字符串 `""`，展示时做空值判断