All APIsexpand_more
Top gainers, losers and most active
/stable/market-movers10 tokens per callNewReturns rankings for the latest trading day: biggest gainers, biggest losers, or most active by trading value (unadjusted close × volume). Gainers and losers need a previous-day close and non-zero volume, and stocks with a split in the last 10 days are excluded. Common stocks by default; filter by sector or market segment. Changes are split-adjusted 0–1 decimals.
What you can do with this API
- check_circleCheck today's big risers and fallers
- check_circleFind the most heavily traded stocks
- check_circleBuild a gainers ranking for the Growth market only
Example URL
https://api.zenithcode.net/stable/market-movers?type=gainers&limit=20§or=3700Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
typeselect | Optional | Ranking type: gainers (default), losers or actives (by trading value) Allowed values: gainers, losers, actives | gainers |
limitnumber | Optional | Maximum number of rows to return (default 20, max 100) | 20 |
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 → |
prevCloseThe 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 → |
changeThe 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 → |
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 → |
volumeThe 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
Why is a stock that just split missing?expand_more
Adjusted prices may not be settled right after a split, so stocks with a split in the last 10 days are left out of gainers and losers.
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.