Your Company

Data & Specs

The free plan does not provide data for the last 12 weeks. What happens to the stock price if a stock split occurs during this period?

When a stock split occurs, historical stock prices are adjusted retroactively from the effective date. Therefore, if a stock split occurs between 12 weeks ago and the present, stock prices prior to 12 weeks ago will also be adjusted for the split. See the data specs by plan and adjusted price spec for details.

Is data from regional exchanges and PTS available? Are there any future distribution plans?

Only data for stocks listed on the Tokyo Stock Exchange is distributed. There are no plans to distribute data from regional exchanges or PTS.

Are values in the financial info API (fins/summary) cumulative or quarterly?

Sales / OP (operating profit) / OdP (ordinary profit) / NP (net profit) are cumulative values from the start of the fiscal period (not quarterly standalone values). For example, CurPerType=3Q is the 9-month cumulative (1Q+2Q+3Q). This applies to all accounting standards. Note: OdP is blank for IFRS and US GAAP. See Financial Info API spec for details.

Which endpoint provides the total number of issued shares?

End-of-period issued shares are available from the financial info API (/v2/fins/summary). Subtract TrShFY (treasury shares) from ShOutFY (total issued shares incl. treasury) to get shares excluding treasury stock. The equities master endpoint does not have a total issued shares field. See Financial Info API spec for details.

How do I calculate market capitalization?

Multiply the end-of-period issued shares (ShOutFY) from the financial info API by the closing price from the OHLC price API to get an approximate market cap. Note that this is not exact for daily calculations since it uses end-of-period share counts.

Are adjusted stock prices retroactively updated for past data?

For stocks that have had splits or consolidations, adjusted prices are recalculated retroactively back to the oldest available data. There is no limit on how far back adjustments reach. The available data period varies by plan. See Data specs by plan for details.

Which indices are available in the index OHLC endpoint?

The list of available indices is in the index code list. Note that data coverage periods vary by index.

Is futures data available in the minute/tick data endpoints?

J-Quants API currently does not provide minute-bar data for futures. The minute/tick add-on only covers equity (cash equity) data. See Minute-bar data spec for details.

Is minute-bar data updated in real time?

Minute-bar data is updated on a daily basis. Real-time delivery is not available. See the data update schedule for details.

Account item names in fins/details change every year. How do I map old and new names?

Keys in /v2/fins/details use the 'verbose label (English)' from the EDINET XBRL taxonomy, which may change with revisions. Column E (Japanese GAAP) or Column D (IFRS) in EDINET's Account Item List corresponds to API keys. XBRL element names (e.g., CashAndDeposits) are generally consistent, allowing cross-year mapping. For details, see the EDINET Taxonomy (Account Item List).

Which endpoint provides specific data such as average volume or dividend yield?

Please refer to the data specs & endpoint list for a full list of data and endpoints. If you cannot find what you need, please contact us via the inquiry form.

Does J-Quants API provide ISIN codes or FIGI codes?

J-Quants API does not include ISIN codes or FIGI codes. For details on available data items, please refer to the equities master API spec.

Data is missing or incorrect for a specific stock.

Thank you for reporting the issue. Please provide the following information via the inquiry form. Data fix status is also updated regularly at the data fix information page.

  • Stock code
  • Endpoint (e.g., /v2/equities/bars/daily)
  • Issue description (e.g., missing data on a specific date, abnormal values)
  • Date or period when the issue was observed

API response format (column names) has changed from before.

V2 API has changed the response structure and column names. See V1→V2 migration guide for details.

  • Response structure: Returned as an array under the data key. pagination_key is also included when paginating
  • Column names: Shortened forms are used for OHLC prices etc. Examples: Open → O, High → H, Low → L, Close → C, Volume → Vo, TurnoverValue → Va, AdjustmentFactor → AdjFactor

How do I retrieve data when it exceeds the single-response limit?

If pagination_key is included in the response, it indicates more data exists. Specify the previous response's pagination_key value as a query parameter in your next request to retrieve the next batch. Repeat until pagination_key is empty or absent to retrieve all records.

Was this page helpful?