All APIsexpand_more
Latest key metrics for multiple stocks (up to 50)
GET
/stable/batch-key-metrics-latest10 tokens per callNewReturns the latest PER, PBR, dividend yield, annual dividend, consecutive non-decrease years (including flat years) and 3-year and 5-year CAGRs for up to 50 stocks in one call, with the same fields as the latest key metrics endpoint. Pass symbols=7203,6758,9984. Results follow the order you gave, duplicates are merged, and symbols that are not found come back with found=false and null values.
What you can do with this API
- check_circleFetch PER and dividend yield for a handful of stocks you want to compare
- check_circleList the dividend yield and dividend-increase streak of all your holdings
- check_circleLine up the growth rates of several peers
Example URL
https://api.zenithcode.net/stable/batch-key-metrics-latest?symbols=7203,6758,9984Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
symbolsstring | Required | Up to 50 securities codes separated by commas (e.g. 7203,6758,9984). Duplicates are merged | 7203,6758,9984 |
Try it
Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 10 tokens.
travel_exploreTry in the API ViewerResponse example (real data)
lock
Live response examples are shown to signed-in users only (they include exchange data such as stock prices). Sign in to view
Response fields
symbol証券コード（4 桁。英字を含むコードもある） | string | 証券コード（4 桁。英字を含むコードもある） |
foundfalse = 最新スナップショットに該当銘柄が無い（数値はすべて null） | boolean | false = 最新スナップショットに該当銘柄が無い（数値はすべて null） |
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
Does it cost more with more symbols?expand_more
No. The cost is the same regardless of the number of symbols.
How many tokens does one call use?expand_more
10 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.