All APIsexpand_more
New 52-week highs and lows
/stable/new-highs-lows10 tokens per callReturns stocks that set a 52-week high or low within the last days calendar days up to the latest trading day (default 1 = that day only). The range is the split-adjusted intraday high and low over the past 364 days, and a tie counts. Recent IPOs (fewer than 120 trading days) and stocks with a split in the last 10 days are excluded. Sorted by trading value, largest first.
What you can do with this API
- check_circleFind stocks with momentum that hit a 52-week high
- check_circleReview stocks at new lows to check risk
- check_circleSee which stocks hit new highs in the last week, by sector
Example URL
https://api.zenithcode.net/stable/new-highs-lows?type=highs&days=5&limit=50§or=3700Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
typeselect | Optional | highs = new 52-week highs (default), lows = new 52-week lows Allowed values: highs, lows | highs |
daysnumber | Optional | Calendar days to look back from the latest trading day (1 = that day only) (default 1, max 30) | 5 |
limitnumber | Optional | Maximum number of rows to return (default 50, max 100) | 50 |
sectorstring | Optional | TSE 33-sector code (e.g. 3700 = Transportation Equipment). See /stable/available-sectors | 3700 |
marketselect | Optional | Market segment (prime, standard or growth) Allowed values: prime, standard, growth | |
includeEtfstring | Optional | true to include ETFs and REITs (default: common stocks only) |
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
rank | integer | |
symbol | string | |
nameJa | string | |
nameEn | string | |
sectorTSE 33-sector code | string | TSE 33-sector code |
segmentMarket segment | string | Market segment |
dateLatest trading date (YYYY-MM-DD) | string | Latest trading date (YYYY-MM-DD) |
closeThe 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 → |
high52The highest split-adjusted high and lowest low over the last 365 days. Null with fewer than 200 trading days. | number | The highest split-adjusted high and lowest low over the last 365 days. Null with fewer than 200 trading days.How it is calculated → |
low52The highest split-adjusted high and lowest low over the last 365 days. Null with fewer than 200 trading days. | number | The highest split-adjusted high and lowest low over the last 365 days. Null with fewer than 200 trading days.How it is calculated → |
highDateThe highest split-adjusted high and lowest low over the last 365 days. Null with fewer than 200 trading days. | string | The highest split-adjusted high and lowest low over the last 365 days. Null with fewer than 200 trading days.How it is calculated → |
lowDateThe highest split-adjusted high and lowest low over the last 365 days. Null with fewer than 200 trading days. | string | The highest split-adjusted high and lowest low over the last 365 days. Null with fewer than 200 trading days.How it is calculated → |
distanceFromHighStocks whose 52-week high (or low) was set within the last `days` days. distanceFromHigh is how far the close is from the 52-week high. | number | Stocks whose 52-week high (or low) was set within the last `days` days. distanceFromHigh is how far the close is from the 52-week high.How it is calculated → |
distanceFromLowStocks whose 52-week high (or low) was set within the last `days` days. distanceFromHigh is how far the close is from the 52-week high. | number | Stocks whose 52-week high (or low) was set within the last `days` days. distanceFromHigh is how far the close is from the 52-week high.How it is calculated → |
changePctThe API computes these from the adjusted closes of the latest and previous trading days. Trading value is the unadjusted close × volume. | number | The API computes these from the adjusted closes of the latest and previous trading days. Trading value is the unadjusted close × volume.How it is calculated → |
turnoverThe API computes these from the adjusted closes of the latest and previous trading days. Trading value is the unadjusted close × volume. | number | The API computes these from the adjusted closes of the latest and previous trading days. Trading value is the unadjusted close × volume.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 → |
Related APIs
FAQ
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.