J-Quants API
View as Markdown

Minute Stock Prices (OHLC) (/equities/bars/minute)

GET /v2/equities/bars/minute

Overview

You can retrieve minute-by-minute stock price data.
This API provides 1-minute interval data including OHLC (Open, High, Low, Close), trading volume, and turnover value.

Attention

  • This API becomes available by subscribing to the "Stock Prices (minute-OHLC, Tick)" add-on. It is not available with a base plan alone. See also the FAQ "Can I subscribe to the add-on plan only?".
  • Coverage:
  • When the earliest available date differs by issue, the criterion is the date of listing on the TSE. For issues listed on the TSE within the past 2 years, the earliest available date is the TSE listing date even if it falls within the period above. The same applies to issues that moved to the TSE from other exchanges or from TOKYO PRO Market, as well as to newly listed issues.
  • Issues whose market segment changed (including the market restructuring) are also recorded, covering the period before the change.
  • This API aggregates tick data into 1-minute intervals, and data is not returned for minutes with no trading activity.
  • Auction (Itayose) executions are recorded in the 1-minute record of their execution time, and closing-auction executions are aggregated into the 15:30 record. However, there is no field indicating that an execution came from an auction, so it must be inferred from the time.
    • The morning-close and day-close auctions appear as records at those times (11:30 and 15:30) whose OHLC values are all the same.
    • The opening is the first record of the day, but its execution time is not necessarily 9:00. The first record of the day is not always "09:00".
    • Afternoon-opening auction executions are combined with the continuous-session executions of the same minute, so the auction portion alone cannot be separated.
    • Records between the end of continuous trading (15:25) and the close (15:30) are normally not returned, so 15:24 is followed by 15:30.
  • The OHLC (O/H/L/C) are unadjusted prices; no adjustment for stock splits, reverse splits, etc. is applied. For adjusted prices, see the daily OHLC.
  • When retrieving many issues or long periods (the entire period), we recommend using the CSV file download feature instead of repeated API calls. Use the List of Downloadable Files API and the Get File Download URL API, or the Download page after signing in.
  • 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.

Retrieve Minute Stock Prices

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

To retrieve data, you must specify either a stock code (code) or date (date).

Parameter and Response

To retrieve data, you must specify either a stock code (code) or date (date).
Parameter in the request and results are as below:

codedatefrom /toResults
Data for the specified issue for all periods
Data for the specified issue on the specified date
Data for the specified issue during the specified period
Data for all listed issues on the specified 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

When from and to are not specified (e.g. 20210907 or 2021-09-07)

fromstringoptional

From date (e.g. 20210901 or 2021-09-01)

tostringoptional

To date (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/minute
curl -G https://api.jquants.com/v2/equities/bars/minute \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="20230324"

Responses

There is no specification that defines or guarantees the row order of the data array.

Data Item

Datestring
Date (YYYY-MM-DD)
Timestring
Time (HH:mm, JST. The start time of each 1-minute record; e.g., 15:00 aggregates executions from 15:00:00 to 15:00:59)
Codestring
Issue code
Onumber
Open price (the first execution price during the 1-minute interval)
Hnumber
High price (the highest execution price during the 1-minute interval)
Lnumber
Low price (the lowest execution price during the 1-minute interval)
Cnumber
Close price (the last execution price during the 1-minute interval)
Vonumber
Trading volume (total executed quantity during the 1-minute interval, in shares)
Vanumber
Trading value (total of execution price x executed quantity during the 1-minute interval, in yen)

Response Sample

{
    "data": [
        {
            "Date": "2023-03-24",
            "Time": "09:00",
            "Code": "86970",
            "O": 2047.0,
            "H": 2055.0,
            "L": 2045.0,
            "C": 2050.0,
            "Vo": 12500.0,
            "Va": 25625000.0
        }
    ],
    "pagination_key": "value1.value2."
}

Was this page helpful?