CN Security Code Resolver#

Overview#

Resolve Chinese security names into exchange-tradable codes with a deterministic first pass and a verifiable fallback. Use the bundled script to query Eastmoney's public suggest API, then return the best match with enough metadata for confirmation.

When to use#

Use this skill when the task involves any of the following:

• Find the code for a Chinese stock, ETF, LOF, REIT, or fund from its Chinese name
• Convert a portfolio/watchlist from names into tradable codes
• Confirm whether an instrument is A-share, ETF/fund, or another mainland market type
• Add exchange-aware identifiers such as 600938.SH, 510880.SH, or Eastmoney QuoteID

Do not use this skill for:

• Real-time pricing or chart analysis
• Hong Kong, US, futures, or crypto symbols unless the user explicitly wants cross-market results
• Fundamental analysis beyond basic instrument identification

Workflow#

1) Prefer the script first#

Run the bundled resolver script:

bash

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "中国海油"

Batch mode:

bash

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "红利ETF华泰柏瑞" "苏美达" "中国海油" "海油发展" "中海油服"

2) Read the best match carefully#

Prefer rows where:

• Name exactly matches the queried Chinese name
• SecurityTypeName matches user intent ( 沪A, 深A, 基金, etc.)
• MarketType / QuoteID indicate mainland trading venue

For mainland cash equities and ETFs, map exchange suffixes as:

• codes starting with 6, 5, or 9 → usually SH
• codes starting with 0, 1, 2, or 3 → usually SZ

If the returned result is ambiguous, show the top 3 candidates and ask for confirmation instead of guessing.

3) Return a concise confirmation#

Use this output shape when replying:

text

标的：中海油服
A股代码：601808
交易所：上交所
类型：沪A
标准代码：601808.SH
QuoteID：1.601808

4) When updating files#

When writing portfolio JSON or other structured files, prefer storing both:

• code: raw numeric code, e.g. 601808
• exchangeSuffix: SH or SZ when it can be derived confidently

Optional enriched fields:

• quoteId
• securityTypeName
• marketType
• source: "eastmoney_suggest"

Verification guidance#

If the first result looks suspicious:

• Re-run with the exact full Chinese name from the broker/app
• Inspect the top candidate list from the script
• Cross-check with a browser search only when necessary

Good verification signals:

• Exact Chinese name match
• Expected category (for example ETF vs stock)
• Price range and portfolio context are consistent with the instrument type

Bundled resources#

Script#

• scripts/resolve_cn_security.py
  • Queries Eastmoney suggest API
  • Supports one or many names
  • Returns ranked JSON results with exchange hints

Reference#

• references/eastmoney-api.md
  • Documents the API endpoint, returned fields, and matching heuristics

Examples#

bash

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "苏美达"

Expected top result:

• 600710 / 苏美达 / 沪A

bash

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "红利ETF华泰柏瑞"

Expected top result:

• 510880 / 红利ETF华泰柏瑞 / 基金

bash

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "中海油服"

Expected top result:

• 601808 / 中海油服 / 沪A
• If other markets also appear elsewhere, prefer A-share unless the user asks otherwise