Reference

Code format reference

A code is always written as market prefix plus code, and the prefix must be lowercase. A-shares use sh/sz/bj, Hong Kong hk, US us; ETFs, convertible bonds and sectors each have their own number ranges. A bare code without a prefix comes back empty on the quote endpoints.

The format: prefix + code

sh600519     Shanghai Stock Exchange
sz000001     Shenzhen Stock Exchange
bj920002     Beijing Stock Exchange
hk00700      Hong Kong
usAAPL       United States

The prefix must be lowercase. Measured: /v1/quote?code=sh600519 returns data, /v1/quote?code=SH600519 returns empty.

Number ranges by market

Market	Prefix	Ranges	Examples
Shanghai	`sh`	6 (main board / 688 STAR) · 9 (900 B-shares) · 5 (funds, ETFs/LOFs) · 11 / 13 (convertible and exchangeable bonds)	`sh600519` `sh688111` `sh510300` `sh113052`
Shenzhen	`sz`	0 (main board) · 2 (200 B-shares) · 3 (ChiNext) · 15 / 16 / 18 (funds, ETFs/LOFs) · 12 (convertible bonds)	`sz000001` `sz300750` `sz159915`
Beijing	`bj`	92 (new 920 range) · 4 · 8	`bj920002`
Hong Kong	`hk`	5 digits	`hk00700`
United States	`us`	letter ticker	`usAAPL` `usBABA`

Special code types

Type	Format	Example
ETF	same as a stock, with `sh` / `sz`	`sh510300`
Convertible bond	`sh11x` in Shanghai · `sz12x` in Shenzhen	`sh113052`
Shenwan sector	`pt` + digits	`pt01801780`
Index	prefix written out explicitly	`sh000001` (SSE Composite)

⚠️ 000001 is ambiguous — it is both the SSE Composite index and Ping An Bank. Six digits alone cannot tell them apart, so write the index as sh000001.

What a bare code does

Measured: the quote endpoints return empty. All of these come back as ok:false with an empty array:

/v1/quote?code=600519 — no prefix
/v1/quote?code=000001 — no prefix
/v1/quote?code=600519.SH — the dot notation used by other vendors
/v1/quote?code=sh60051 — wrong number of digits

⇒ Always include the prefix. It is the least surprising option. If you are unsure of a code, look it up with /v1/search and call with the canonical form.

Common misuses

Leaving off the prefix — returns empty, which looks like “no such instrument”.
Uppercase prefix — SH600519 returns empty; it must be lowercase.
Dot notation — 600519.SH is not our format; we only accept sh600519.
Index without a prefix — endpoints that auto-fill a prefix turn 000001 into Ping An Bank, so write the index as sh000001.

Last updated: 2026-10-05

Prefixes and number ranges taken from the code-resolution rules and the endpoint parameter descriptions; bare codes, prefix casing and digit-count boundaries all measured live on 2026-10-05.