By market
| Market | Format | Examples | Source |
|---|---|---|---|
| US | Alphabetic (1-5 letters), uppercase | AAPL · MSFT · NVDA · BRK.B |
SEC EDGAR |
| Japan | 4-digit numeric (Tokyo Stock Exchange code) | 7203 (Toyota) · 6758 (Sony) · 9984 (SoftBank) |
EDINET |
| Korea | 6-digit numeric. Excludes leading 0 (warrant) and 3 (preferred) codes. |
005930 (Samsung) · 000660 (SK Hynix) · 035420 (NAVER) |
DART OPENDART |
Optional exchange suffix
On the v3 endpoints (homepage examples) we accept the Yahoo/Bloomberg-style
suffix as a convenience: 005930.KS, 7203.T. The v1
endpoints documented here prefer the bare regulator format.
Cross-market searches
/v1/companies/search accepts tickers from
any market in one call — no need to scope by region. The response includes
the market field on every record so you can group client-side.
Resolving by CIK
On US endpoints, you can substitute cik=0000320193 for
ticker=AAPL wherever a ticker is accepted — useful when you
have the CIK from another source or want to match an entity whose
primary ticker has changed.
9XXXXX (e.g. 950130) are foreign issuer SPACs and ADRs — not part of v1 coverage. They will return 404 ticker_not_found.
When a ticker disagrees
Companies occasionally re-ticker (Facebook → Meta → META). We pin records
to the issuer's CIK / EDINET code / DART corp code so historical data
follows the entity, not the symbol. If you query the old ticker after a
change, you'll get the current ticker back in the ticker
field with the same underlying data.