All APIsexpand_more
Latest key metrics
/stable/key-metrics-latest1 tokens per callNewReturns PER, PBR and dividend yield calculated with the latest close, plus the annual dividend, consecutive non-decrease years (including flat years) and 3-year and 5-year compound annual growth rates (CAGR) of dividends, revenue, net income and EPS in one call. Ratios are 0–1 decimals (0.03 = 3%) and amounts are in JPY. priceDate is the date of the price used in the calculation.
What you can do with this API
- check_circleShow the current PER, PBR and dividend yield on a stock page
- check_circleRecord the dividend yield and consecutive non-decrease years (including flat years) of your holdings every day
- check_circleCheck growth stocks by their revenue and EPS growth rates
Example URL
https://api.zenithcode.net/stable/key-metrics-latest?symbol=7203Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
symbolstring | Required | Securities code (4 characters, e.g. 7203 = Toyota Motor; alphanumeric codes such as 130A also work) | 7203 |
Try it
Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 1 tokens.
travel_exploreTry in the API ViewerResponse example (real data)
Response fields
symbol証券コード（4 桁。英字を含むコードもある） | string | 証券コード（4 桁。英字を含むコードもある） |
priceDatePER・PBR・配当利回りの計算に使った株価の日付（最新の取引日。YYYY-MM-DD） | string | PER・PBR・配当利回りの計算に使った株価の日付（最新の取引日。YYYY-MM-DD） |
perPrice divided by earnings per share (split-adjusted EPS). key-metrics-latest and similar endpoints use the latest close and the latest full-year EPS; key-metrics uses the price at each period end and that period’s EPS. | number | Price divided by earnings per share (split-adjusted EPS). key-metrics-latest and similar endpoints use the latest close and the latest full-year EPS; key-metrics uses the price at each period end and that period’s EPS.How it is calculated → |
pbrPrice divided by book value per share (split-adjusted BPS). | number | Price divided by book value per share (split-adjusted BPS).How it is calculated → |
dividendYieldThe annual dividend divided by the price: 0.0323 in the API is 3.23% on screen. | number | The annual dividend divided by the price: 0.0323 in the API is 3.23% on screen.How it is calculated → |
annualDividendannualDividend is the annual dividend for the latest fiscal year (company forecasts included). If there is no annual row, it is interim actual + year-end forecast. | number | annualDividend is the annual dividend for the latest fiscal year (company forecasts included). If there is no annual row, it is interim actual + year-end forecast.How it is calculated → |
progressiveDividendYearsHow many consecutive recent years the annual dividend was at least the prior year’s. Despite the name, years with an unchanged dividend count. | number | How many consecutive recent years the annual dividend was at least the prior year’s. Despite the name, years with an unchanged dividend count.How it is calculated → |
dividendCagr3yCompound annual growth rate (CAGR) of the annual dividend over 3 and 5 years, returned as a 0–1 decimal. | number | Compound annual growth rate (CAGR) of the annual dividend over 3 and 5 years, returned as a 0–1 decimal.How it is calculated → |
dividendCagr5yCompound annual growth rate (CAGR) of the annual dividend over 3 and 5 years, returned as a 0–1 decimal. | number | Compound annual growth rate (CAGR) of the annual dividend over 3 and 5 years, returned as a 0–1 decimal.How it is calculated → |
revenueCagr3yCompound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal. | number | Compound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal.How it is calculated → |
revenueCagr5yCompound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal. | number | Compound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal.How it is calculated → |
netIncomeCagr3yCompound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal. | number | Compound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal.How it is calculated → |
netIncomeCagr5yCompound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal. | number | Compound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal.How it is calculated → |
epsCagr3yCompound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal. | number | Compound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal.How it is calculated → |
epsCagr5yCompound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal. | number | Compound annual growth rate (CAGR) from the latest full year compared with the full year N years earlier, returned as a 0–1 decimal.How it is calculated → |
updatedAtこの行をデータ基盤が更新した日時 | string | この行をデータ基盤が更新した日時 |
Related APIs
FAQ
How does this differ from the per-period key metrics?expand_more
This returns one row of the latest values calculated with the current price. Use the per-period key metrics endpoint for values at each fiscal period end.
Does it include the price and price changes?expand_more
No. The price, price changes and market cap are in the latest stock price endpoint.
How many tokens does one call use?expand_more
1 tokens per call, regardless of how many rows come back. Your monthly allowance depends on your plan.
Do I need an account to try it?expand_more
Use the API Viewer to run it with your own parameters. Sign up for free and sign in (no credit card). Each run uses this API's tokens.
Can I get CSV instead of JSON?expand_more
Add format=csv to the URL to get CSV, ready for spreadsheets or pandas.
Can I get labels in English?expand_more
With neither lang nor Accept-Language, labels such as sector names are returned in English; add lang=ja or send Accept-Language: ja for Japanese. Company and sector names are always returned in both languages as nameJa / nameEn and sectorJa / sectorEn. Field names are the same in both languages.