Double 11 annual ¥1,699/yrView
Pro endpoint · Pro

Sector valuation (percentile) API

Shenwan sector PE/PB/PS/PCF + dividend yield + historical percentile. code like pt01801780.

ProGET /v1/sector-valuation
Signature
GET /v1/sector-valuation?code=sh600667
One-liner
curl "https://api.ashareapi.com/v1/sector-valuation?code=sh600667&key=YOUR_KEY"
Parameters: code ** = required

Quick start

Replace the key below with yours (free endpoints need no 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());

Parameters

codestringYes
Stock code with market prefix: sh600667 (SH), sz000001 (SZ), hk00700 (HK), usAAPL (US)

Response fields

The table below is captured from real API calls (not inferred): each row gives the field name, its type and one real sample value, so you can align your parser.

Located in: structuredEnvelope: ok / endpoint / tier / elapsed_ms / sourceProbed: 2026-10-20
FieldTypeReal sample value
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
Response

Unified envelope: { ok, endpoint, tier, elapsed_ms, source, data }

Rows live in data; when upstream returns nothing you get ok:false and the call is not counted.

Rate limits & quota

Free endpoints need no key (anonymous 5/min — 250 bars per request, 100k rows per day; solve one PoW challenge for 15/min). Paid tiers: Trial 30 · Standard 120 · Pro 300 · Unlimited 600 per minute; buyout packs are capped by total calls and never expire.

See the error code table →

FAQ

General (applies to every endpoint)

Do these endpoints need an API key?

Free endpoints do not: health, challenge, quote, kline, hot, market-overview and changedist work anonymously. Paid endpoints do: send Authorization: Bearer <your key>. ⚠️ The anonymous allowance is tiered by caller type: browsers (humans) get 5/min; scripts, SDKs and AI Agents (curl, requests, axios, openai user-agent strings) get 2/min — automated traffic is easier to abuse. Solving one PoW challenge (GET /v1/challenge, then send the X-PoW header) raises it to 15/min regardless of type. ⚠️ Also, anonymous calls are capped at 250 bars per request and 100k rows per day — use an API key for the full 1212 bars or unlimited daily volume.

Am I charged when the upstream returns nothing or errors?

No. When the upstream fails or returns nothing you get ok:false and the charge for that call is refunded (total_calls / usage_log / ep_log are rolled back together). Only calls that actually returned data count.

How fresh is the data?

Quotes (quote / kline / orderbook / changedist) are real-time or current session; financials, shareholders, dividends and events are within T+1 of source disclosure. Every response carries its own data timestamp — time (HHMM) on intraday bars, date (trading day) on quotes — so you can check exactly which moment a payload reflects.

Can I request several stocks in one call?

No. code is a single-value parameter — one stock per call. For batches, issue concurrent calls and respect your tier per-minute limit.

How do I use this from Claude / Cursor / ChatGPT?

Set up MCP once, then just ask the AI — it calls the endpoint itself. MCP exposes 92 tools covering quotes, financials, screening, sectors and macro.

Use it from an AI Agent?

Set up MCP once, then just ask the AI — it calls the endpoint itself.

← Back to the full endpoint reference