Stock Prices (OHLC) (/equities/bars/daily)

GET /v2/equities/bars/daily

Overview

You can get information about stock price.
Stock prices are available both adjusted for stock splits, reverse stock splits, etc. and unadjusted.

Market capitalization (MktCap) is scheduled to be removed from this API.
Please use MktCap in the Valuation Indicators API instead. Market capitalization in that API uses a share count that excludes treasury shares, so its value may not match market capitalization in this API, which uses a share count that includes them.
We will announce the removal date on this page and in the Release Notes once it has been decided.

Attention

Coverage:
- Coverage is limited to issues listed on the TSE. Issues that are not listed on the TSE (issues listed only on regional exchanges) and PTS data are not included. Issue codes that contain letters (such as 186A) are also covered. See also the FAQ "Is data from regional exchanges and PTS available?".
- Delisted issues can also be retrieved by specifying dates or periods within their listing period, as long as they fall within the data storage period. See also the FAQ "Can I retrieve data for delisted stocks?".
- The four prices (O, H, L, C), the trading volume (Vo), and the trading value (Va) all cover only regular trading sessions (the auction market) on the Tokyo Stock Exchange. ToSTNeT-1, ToSTNeT-2, ToSTNeT-3, off-auction distributions, and other off-auction trades are not included (the same applies to the morning and afternoon items).
Missing values (Null) and record availability:
- Even for days with no trade (no execution, trading halted all day, etc.), the record itself for the issue and business day is returned, as long as the day is within the issue's listing period and the data storage period. In that case, however, Open, High, Low, Close, the trading volume and the trading value are recorded as Null. Because the absence of executions is expressed as Null, the trading volume (Vo) and the trading value (Va) are never recorded as 0.
- In addition, the whole-day OHLC, the trading volume (Vo) and the trading value (Va) become Null together; a record never has only some of these items as Null. The adjusted items (AdjO, etc.) are Null only when the corresponding unadjusted items are Null.
- The data for Oct. 1st, 2020 are the OHLC, trading volume, and trading value in Null because trading was halted all day due to the failure of the equity trading system, arrowhead.
We do not provide a dedicated status item for identifying days with no trading, nor any information that distinguishes the reason for the absence of trading (no execution, trading halt, etc.). Programmatically, please treat a day as "no execution on that day" when the OHLC, Vo, and Va are all Null. For the availability of trading-suspension information, see the FAQ "Do you provide data on trading suspensions or corporate actions?".
Trading value (Va/MVa/AVa) is not subject to price adjustment (the value is identical for the adjusted and unadjusted series).
Price items in this API are based on yen-denominated trading on the Tokyo Stock Exchange; all issues, including foreign stocks listed on the TSE, are denominated in JPY.
Daily prices can be obtained for all plans, but morning/afternoon session prices are available only for Premium plan.
For plans other than Premium, the morning/afternoon session items are not returned as Null; the keys themselves are not included in the response. All items other than the morning/afternoon session items are always included in the response as keys, even when their values are Null.
Stock price adjustments are supported for stock splits, reverse stock splits, and rights issues. Adjustments for cash dividends are not included, and please note that some other corporate actions are not supported either.
For rights issues, stock prices are adjusted on the assumption that all allotted rights are exercised (actual exercise results are not reflected).
For rights issues, trading volume (Vo/AdjVo, etc.) is not adjusted.
Rights issues for foreign stocks and issues listed on TOKYO PRO Market are excluded from price adjustment (AdjFactor = 1).
Unadjusted values and adjusted values (including the adjustment factor) are provided in the same record. Because adjusted values are recalculated retroactively when a subsequent corporate action occurs, please use the unadjusted values — the values as of that time — for analysis that relies on the values actually delivered at each point in time (point-in-time). For the calculation procedure, see How to calculate adjusted prices.
The daily upper-price-limit flag (UL) is not determined from the close price. Even when the close price does not reach the upper price limit, "1" is recorded if the executed price (high price) of the day reached the upper price limit of that day.
We do not provide items that directly indicate special quotes or the upper and lower price limits.

We do not provide the date and time when each data item became available on J-Quants. For update frequency and approximate update times, see Update Timing of Provided Data.
Questions we have received about data specifications are also answered in the FAQ (Data & Specs).

Data correction policy

In this service, we may add or overwrite data due to data deficiencies or omissions. In such cases, the correction history is recorded on Data Correction History and Known issues, so please refer to it.
Note: In these cases, neither the correction history nor pre-correction data is provided via the API, CSV, or other means.

Get daily stock prices

GET https://api.jquants.com/v2/equities/bars/daily

In your request message, either "code" or "date" must be specified.

Parameter and Response

In your request message, either "code" or "date" must be specified.
Combination of parameter in the request and results are as below.

code	date	from /to	Results
			All historical stock prices of a specific issue.
			Stock prices of a specific issue for the specific date
			Stock prices of a specific issue for the specified period
			All listed issue prices for the specific date.

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

Either code or date must be specified.

codestringoptional: Issue code (e.g. 27800 or 2780)
If a 4-character issue code is specified, only the data of common stock will be obtained for the issue on which both common and preferred stocks are listed.
datestringoptional: Date of data when "from" and "to" are not specified (e.g. 20210907 or 2021-09-07)
fromstringoptional: Starting point of data period (e.g. 20210901 or 2021-09-01)
tostringoptional: End point of data period (e.g. 20210907 or 2021-09-07)
pagination_keystringoptional: The primary key of the first item that this operation will evaluate.
Use the value that was returned for pagination_key in the previous operation.

Sample Code

Request

GET

/v2/equities/bars/daily

curl -G https://api.jquants.com/v2/equities/bars/daily \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="20230324"

Responses

Data Item

Datestring: Date (YYYY-MM-DD)
Codestring: Issue code
Onumber: Open Price (before adjustment, in yen)
The unadjusted opening price for the whole day. It includes the opening itayose execution.
Hnumber: High price (before adjustment, in yen)
The unadjusted high price for the whole day.
Lnumber: Low price (before adjustment, in yen)
The unadjusted low price for the whole day.
Cnumber: Close price (before adjustment, in yen)
The unadjusted close price for the whole day. It includes the closing itayose execution.
ULstring: Flag of hitting the upper price limit of the day (0: Other than hitting the upper price limit, 1: Hitting the upper price limit)
LLstring: Flag of hitting the lower price limit of the day (0: Other than hitting the lower price limit, 1: Hitting the lower price limit)
Vonumber: Trading volume (before adjustment)
The trading volume for the whole day. The unit is the number of shares for common stocks, and the number of units for ETFs, REITs, etc.
Vanumber: Trading value (in yen)
The trading value for the whole day.
AdjFactornumber: Adjustment factor (In the case of a two-for-one stock split, "0.5" will be set in the record on the ex-rights date.)
AdjOnumber: Adjusted open price (*1)
AdjHnumber: Adjusted high price (*1)
AdjLnumber: Adjusted low price (*1)
AdjCnumber: Adjusted close price (*1)
AdjVonumber: Adjusted volume (*1)
MOnumber: Open price of the morning session (before adjustment) (*2)
MHnumber: High price of the morning session (before adjustment) (*2)
MLnumber: Low price of the morning session (before adjustment) (*2)
MCnumber: Close price of the morning session (before adjustment) (*2)
MULstring: Flag of hitting the upper price limit of the day in morning session (0: Other than hitting the upper price limit, 1: Hitting the upper price limit) (*2)
MLLstring: Flag of hitting the lower price limit of the day in morning session (0: Other than hitting the lower price limit, 1: Hitting the lower price limit) (*2)
MVonumber: Trading volume of the morning session (before adjustment) (*2)
MVanumber: Trading value of the morning session (in yen) (*2)
MAdjOnumber: Adjusted open price of the morning session (*1, *2)
MAdjHnumber: Adjusted high price of the morning session (*1, *2)
MAdjLnumber: Adjusted low price of the morning session (*1, *2)
MAdjCnumber: Adjusted close price of the morning session (*1, *2)
MAdjVonumber: Adjusted trading volume of the morning session (*1, *2)
AOnumber: Open price of the afternoon session (before adjustment) (*2)
AHnumber: High price of the afternoon session (before adjustment) (*2)
ALnumber: Low price of the afternoon session (before adjustment) (*2)
ACnumber: Close price of the afternoon session (before adjustment) (*2)
AULstring: Flag of hitting the upper price limit of the day in afternoon session (0: Other than hitting the upper price limit, 1: Hitting the upper price limit) (*2)
ALLstring: Flag of hitting the lower price limit of the day in afternoon session (0: Other than hitting the lower price limit, 1: Hitting the lower price limit) (*2)
AVonumber: Trading volume of the afternoon session (before adjustment) (*2)
AVanumber: Trading value of the afternoon session (in yen) (*2)
AAdjOnumber: Adjusted open price of the afternoon session (*1, *2)
AAdjHnumber: Adjusted high price of the afternoon session (*1, *2)
AAdjLnumber: Adjusted low price of the afternoon session (*1, *2)
AAdjCnumber: Adjusted close price of the afternoon session (*1, *2)
AAdjVonumber: Adjusted trading volume of the afternoon session (*1, *2)
MktCapnumber: Market capitalization (in millions of JPY) (*3)
ExRTstring: Ex-rights type (1: Stock split, 2: Reverse stock split, 3: Rights issue. Bonus share allotment is included in "1: Stock split".) (*4)
Use this item to identify ex-rights dates of rights issues when you recalculate adjusted trading volume yourself.

*1 The item has been adjusted to take into account past divisions, etc.
・Both adjusted prices and adjusted volumes are delivered rounded to one decimal place (the second decimal place is rounded half up).
・When a stock split, reverse stock split, rights issue, etc. occurs, past adjusted values are recalculated retroactively. Unadjusted OHLC and trading volume (O, H, L, C, Vo, and the corresponding morning/afternoon session items) are not changed afterwards. See also the FAQ "Are adjusted stock prices retroactively updated for past data?".
・We do not provide any way to obtain from the API the adjusted values as they were delivered at each past point in time. If you need them, calculate them from the unadjusted values, which are not changed after the fact, and AdjFactor (see How to calculate adjusted prices).
*2 The item is available only for Premium plan users (for plans other than Premium, the key itself is not included in the response).
*3 Market capitalization is calculated as "close price (before adjustment) × number of listed shares" and recorded in millions of JPY (rounded to the nearest million).
・Market capitalization also reflects corporate actions such as stock splits and reverse stock splits.
・ETFs, ETNs, etc. are recorded as Null.
・Days with no trading are recorded as Null.
*4 Null is recorded on days with no applicable corporate action on the ex-rights date.

Response Sample

{
    "data": [
        {
            "Date": "2023-03-24",
            "Code": "86970",
            "O": 2047.0,
            "H": 2069.0,
            "L": 2035.0,
            "C": 2045.0,
            "UL": "0",
            "LL": "0",
            "Vo": 2202500.0,
            "Va": 4507051850.0,
            "AdjFactor": 1.0,
            "AdjO": 2047.0,
            "AdjH": 2069.0,
            "AdjL": 2035.0,
            "AdjC": 2045.0,
            "AdjVo": 2202500.0,
            "MO": 2047.0,
            "MH": 2069.0,
            "ML": 2040.0,
            "MC": 2045.5,
            "MUL": "0",
            "MLL": "0",
            "MVo": 1121200.0,
            "MVa": 2297525850.0,
            "MAdjO": 2047.0,
            "MAdjH": 2069.0,
            "MAdjL": 2040.0,
            "MAdjC": 2045.5,
            "MAdjVo": 1121200.0,
            "AO": 2047.0,
            "AH": 2047.0,
            "AL": 2035.0,
            "AC": 2045.0,
            "AUL": "0",
            "ALL": "0",
            "AVo": 1081300.0,
            "AVa": 2209526000.0,
            "AAdjO": 2047.0,
            "AAdjH": 2047.0,
            "AAdjL": 2035.0,
            "AAdjC": 2045.0,
            "AAdjVo": 1081300.0,
            "MktCap": 1083850.0,
            "ExRT": null
        }
    ],
    "pagination_key": "value1.value2."
}