All APIsexpand_more
Ready-made screens (high dividend, value, growth, etc.)
/stable/screener-presets10 tokens per callNewRuns one of six ready-made screens (high dividend, value, high ROE, growth, dividend growth, momentum) over common stocks with a market cap of at least JPY 5 billion. Ratios are 0–1 decimals. For example, high-dividend means dividend yield between 4% and 12%, positive PER, sorted by yield; value means PER of 15 or less, PBR of 1 or less and ROE of 5% or more, sorted by lowest PBR.
What you can do with this API
- check_circleGet a list of high-dividend candidates without defining conditions
- check_circleCompare value stocks with high-ROE stocks
- check_circleLook for companies that keep paying dividends without a cut
Example URL
https://api.zenithcode.net/stable/screener-presets?preset=high-dividend§or=3700&limit=50Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
presetselect | Required | Preset name: high-dividend, value, high-roe, growth, dividend-growth or momentum Allowed values: high-dividend, value, high-roe, growth, dividend-growth, momentum | high-dividend |
sectorstring | Optional | Restrict to one TSE 33-sector code (e.g. 3700 = Transportation Equipment) | 3700 |
limitnumber | Optional | Maximum number of rows to return (default 50, max 100) | 50 |
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)
Response fields
symbol | string | |
nameJa | string | |
nameEn | string | |
sector | string | |
priceThe close on the latest trading day (split-adjusted). This is exchange data and is shown only to signed-in users. | number | The close on the latest trading day (split-adjusted). This is exchange data and is shown only to signed-in users.How it is calculated → |
marketCapThe close multiplied by shares outstanding excluding treasury shares (both split-adjusted). | number | The close multiplied by shares outstanding excluding treasury shares (both split-adjusted).How it is calculated → |
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 → |
roeNet income attributable to owners of the parent divided by average equity (opening and closing). For example, 0.098 in the API is 9.8% on screen. | number | Net income attributable to owners of the parent divided by average equity (opening and closing). For example, 0.098 in the API is 9.8% on screen.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 → |
changePctYtdThe change of the latest adjusted close from the adjusted close on the base date. The base date is the last trading day on or before the calendar look-back date. | number | The change of the latest adjusted close from the adjusted close on the base date. The base date is the last trading day on or before the calendar look-back date.How it is calculated → |
assetType | string | |
rankSix presets: high dividend, value, high ROE, growth, dividend growth (years without a cut) and momentum. All require a market cap of at least ¥5 billion. They are lists of matching stocks, not investment recommendations. | integer | Six presets: high dividend, value, high ROE, growth, dividend growth (years without a cut) and momentum. All require a market cap of at least ¥5 billion. They are lists of matching stocks, not investment recommendations.How it is calculated → |
valueSix presets: high dividend, value, high ROE, growth, dividend growth (years without a cut) and momentum. All require a market cap of at least ¥5 billion. They are lists of matching stocks, not investment recommendations. | number | Six presets: high dividend, value, high ROE, growth, dividend growth (years without a cut) and momentum. All require a market cap of at least ¥5 billion. They are lists of matching stocks, not investment recommendations.How it is calculated → |
Related APIs
FAQ
What if I want to change the conditions?expand_more
Use the stock screener, which lets you combine conditions freely.
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.