双十一机构版年付 ¥1,699/年查看年付
付费端点 · 付费

板块估值(含历史百分位) API

申万板块 PE/PB/PS/PCF + 股息率 + 历史百分位。code 形如 pt01801780。用户问『某板块贵不贵/估值分位』时用。

付费GET /v1/sector-valuation
接口签名
GET /v1/sector-valuation?code=sh600667
一行可跑
curl "https://api.ashareapi.com/v1/sector-valuation?code=sh600667&key=YOUR_KEY"
参数:code *带 * 为必填

快速开始

把下面的代码里的 Key 换成你的(免费端点无需 Key,直接调):

curl
# 推荐:Authorization 头(密钥不进日志)
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/sector-valuation?code=sh600667"

# 快速测试:直接浏览器打开(?key= 会留在日志/历史里,别用于生产)
curl "https://api.ashareapi.com/v1/sector-valuation?code=sh600667&key=YOUR_KEY"
Python
import requests

r = requests.get(
    "https://api.ashareapi.com/v1/sector-valuation",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())
JavaScript
const r = await fetch("https://api.ashareapi.com/v1/sector-valuation?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

参数

codestring是
申万板块代码:pt01801780

返回字段

下表由线上真实调用采集(非文档推断):每行是响应里的字段名、类型和一条真实样例值,用来对齐解析代码。

所在位置: structured统一信封: ok / endpoint / tier / elapsed_ms / source取样日: 2026-10-20
字段类型真实样例值
codestrpt01801780
namestr银行
EndDatestr20261019
DivTTMstr3.8655
DivTTMPctstr95.74
DivTTMPrevMstr4.0759
DivTTMPrevQstr4.3684
DivTTMPrevWstr3.9685
DivTTMPrevYstr4.2292
PbLFstr0.7335
PbLFPctstr1.53
PbLFPrevMstr0.6966
PbLFPrevQstr0.6573
PbLFPrevWstr0.72
PbLFPrevYstr0.6641
PcfTTMstr1.3934
PcfTTMPctstr9.21
PcfTTMPrevMstr1.3247
PcfTTMPrevQstr0.9935
PcfTTMPrevWstr1.3679
PcfTTMPrevYstr1.8631
PeTTMstr7.8146
PeTTMPctstr13.68
PeTTMPrevMstr7.429
PeTTMPrevQstr6.8992
PeTTMPrevWstr7.6713
PeTTMPrevYstr6.8073
PsTTMstr2.8775
PsTTMPctstr60.51
PsTTMPrevMstr2.7356
PsTTMPrevQstr2.5684
PsTTMPrevWstr2.8248
PsTTMPrevYstr2.572
返回

统一返回信封: { ok, endpoint, tier, elapsed_ms, source, data }

数据在 data 字段;数据源为空时 ok:false 且不扣次数。

限流与额度

免费端点无需 Key(匿名 5 次/分,解一次 PoW 可到 15 次/分;每次最多 250 根 K 线、每天最多 10 万条)。付费端点按档位限流:体验 30 · 标准 120 · 专业 300 · 机构版 600 次/分;买断档按总量计(不用完不过期)。

看错误码对照表 →

常见问题

通用问题(所有端点通用)

这些端点需要 API Key 吗?

免费端点不需要:health、challenge、quote、kline、hot、market-overview、changedist 匿名即可调用。付费端点需要:在请求头带 Authorization: Bearer <你的 Key>。⚠️ 匿名额度按调用者类型分级:浏览器(真人)5 次/分;脚本 / SDK / AI Agent(curl、requests、axios、openai 等 UA)2 次/分 —— 自动化流量更易被滥用。解一次 PoW 挑战(GET /v1/challenge,再带 X-PoW 头)可提到 15 次/分,与类型无关。⚠️ 另外,匿名调用单次最多取 250 根 K 线、每天最多 10 万条 —— 要一次拿满 1212 根或不限日量,请用 API Key。

返回为空或数据源报错时,会扣我的调用次数吗?

不会。数据源失败或空结果时返回 ok:false,并自动退回本次计费(total_calls / usage_log / ep_log 三处同时回滚)。只有真正取到数据的请求才计入用量。

数据多久更新一次?

行情类(quote / kline / orderbook / changedist)为实时或当日;财务、股东、分红、事件等为数据源披露后 T+1 内。每份响应都自带数据时点字段 —— 分时看 time(HHMM),行情看 date(交易日),据此可核对这份数据对应的是哪一刻。

一次请求能批量拿多只股票吗?

不能。code 是单值参数,一次一只;批量请并发调用(注意各自档位的每分钟限流)。

怎么在 Claude / Cursor / ChatGPT 里直接调用?

配一次 MCP 即可,之后直接问 AI「查一下……」它会自己调。MCP 暴露 92 个工具,覆盖行情 / 财务 / 选股 / 板块 / 宏观。

要把它接进 AI Agent?

配一次 MCP,之后问 AI「查一下……」它自己调。

← 返回完整端点清单