All APIsexpand_more
Returns by period
GET
/stable/returns1 tokens per callReturns price changes over 1 day, 1 week, 1 month, 3 months, 6 months, 1 year and year to date, plus the 3-year annualized return. These are the same figures as the quote endpoint, trimmed for ranking and comparison. Ratios are 0–1 decimals.
What you can do with this API
- check_circleCompare the returns of several stocks side by side
- check_circleList the last month and year-to-date performance
Example URL
https://api.zenithcode.net/stable/returns?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)
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 | 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 → |
priceDateThe close on the latest trading day (split-adjusted). This is exchange data and is shown only to signed-in users. | string | 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 → |
changePct1dThe 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 → |
changePct1wThe 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 → |
changePct1mThe 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 → |
changePct3mThe 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 → |
changePct6mThe 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 → |
changePct1yThe 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 → |
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 → |
return3yAnnualizedThe annualized return from the last close on or before three years ago, and the Sharpe ratio: that return minus the risk-free rate, divided by 3-year volatility. | number | The annualized return from the last close on or before three years ago, and the Sharpe ratio: that return minus the risk-free rate, divided by 3-year volatility.How it is calculated → |
priceMetricsDate | string |
Related APIs
FAQ
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.