Get free API key

Use case · Corporates and advisers

IR, corporate planning and consulting teams benchmarking peers

Get peer metrics, sector medians, cross-shareholdings, director compensation and changes in major holders without reading each annual securities report.

Key points

  • check_circlepeers lines up same-sector companies of similar market cap and the sector median in one call.
  • check_circleCross-shareholdings, director compensation and major shareholders come per company, extracted from annual reports.
  • check_circleSharing within a team or putting the data in client materials requires Business or higher.

Before, and with ZENITH Code

Before

  • removeOpening each peer's annual report and typing cross-shareholdings and director pay into tables.
  • removeChoosing companies and computing sector averages yourself.
  • removeNoticing changes in major holders only when the next annual report came out.

With ZENITH Code

  • check_circlePeer metrics and sector medians come back as a computed comparison table.
  • check_circleCross-shareholdings and director compensation can be fetched by company and fiscal period.
  • check_circleLarge shareholding reports arrive with each filing, so you can follow holding ratios by date.

Endpoints to use

A set for benchmark decks, shareholder analysis and governance comparisons.

Plan fit and what you may show

One person analyzing for themselves is Basic Use on Free or Pro. Sharing within a department or team requires Business.

PlanMonthlyMonthly tokensShowing to third parties (excluding exchange data)
Free$05,000Not allowed (your own research and analysis, or internal use for a company)
ProFits this use$89100,000Not allowed (your own research and analysis, or internal use for a company)
BusinessFits this use$4991,000,000Allowed (display in your service, providing processed results, sharing within your organization)
EnterpriseCustomCustomAllowed (display in your service, providing processed results, sharing within your organization)
warning

Putting the data or results derived from it into materials for clients or other third parties presupposes Business or higher. Exchange data such as stock prices may not be included. Contact us about specific arrangements.

The Terms are the authoritative source on what you may show or provide. If your use is unclear, contact us before you start. Terms, Article 8 · Pricing

Code example

Build a peer table and count each peer's cross-shareholdings (Python).

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

Things to note

  • errorprice and changePctYtd in peers are exchange data. Leave them out of your materials.
  • errorCross-shareholdings and director compensation come from the once-a-year annual report.
  • errorLarge shareholding reports from every filer are included from mid-October 2021 onward (the period EDINET keeps available); the coverage field in the response is all.

FAQ for investors and developers

Can I build a table comparing us with peers?expand_more

Pass your securities code to peers to get same-sector companies of similar market cap plus a sector-median row. limit changes the number of peers (up to 30).

Can I change the peer group?expand_more

peers uses the TSE 33 sectors. For a custom peer group, fetch key-metrics and other data for each company and line them up yourself.

Can several departments use it?expand_more

Sharing among multiple employees within an organization is licensed on Business or higher.

FAQ for AI builders and researchers

Can an AI draft a peer comparison deck?expand_more

With the MCP tools get_peers and get_industry_benchmarks, an AI can refer to the same data. For materials shared internally, plan on Business or higher.

Where does cross-shareholding data come from?expand_more

From annual securities reports filed on EDINET. Responses include the document information.

How are outliers handled in sector medians?expand_more

Multiples of 0 or below, ROE and ROA above 100%, and dividend yields of 0 or below or above 100% are excluded.

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