Get free API key
Docs menuexpand_more
travel_exploreTry in the API Viewer

Guides

Endpoints

search
appsAll APIs
functionHow metrics are calculated

Cookbook

Compare companies in the same sector

Pass a securities code to /stable/peers to get the company first, then same-sector companies closest in market cap, and finally a sector-median row.

Key points

  • check_circlerole is target, peer or sector-median.
  • check_circlePER, PBR, ROE, dividend yield and other metrics use the same outlier rules as the sector statistics (outliers are null).
  • check_circleEach call uses 10 tokens. The example is Toyota Motor (7203).

Endpoints to use

Code

Replace YOUR_API_KEY with a key issued in your dashboard. Switch languages with the tabs.

Code example
curl -sG "https://api.zenithcode.net/stable/peers" \
  --data-urlencode "symbol=7203" \
  --data-urlencode "limit=5" \
  -H "x-api-key: YOUR_API_KEY"

How the code works

  1. 1Call with symbol and limit (number of peers, up to 30).
  2. 2Keep only the columns you need (per, pbr, roe, dividendYield and so on).
  3. 3Compare each company with the final sector-median row.

Things to note

  • errorprice and changePctYtd in the response are exchange data. Leave them out when showing the table to others.
  • errorIt does not work for ETFs or REITs. Pass a common stock code.
  • errorRatios are 0–1 decimals. Multiply by 100 to show percentages.

FAQ for investors and developers

How many peers can I list?expand_more

Up to 30 with limit (excluding the target and the median row).

Does this tell me whether a stock is cheap?expand_more

Comparing with the sector median is one input. Make investment decisions yourself, using other information as well.

FAQ for AI builders and researchers

How are peers chosen?expand_more

Common stocks in the same TSE 33 sector, ordered by closeness in market cap.

How is the median row computed?expand_more

With the same rules as /stable/industry-benchmarks, from all common stocks in the sector.

gavel

Disclaimer

This page explains how to use a Japanese equity data API and how its data is defined. It is not a solicitation to invest or a recommendation to buy or sell any security. The content reflects information at the time of writing and is not guaranteed to be accurate or complete. Investment decisions are your own responsibility.

What you may show or provide to third parties depends on your plan and Article 8 of the Terms. Exchange data such as stock prices may not be shown to third parties on any plan. Terms, Article 8 · Data sources and terms of use