Changes from V1 API to V2 API

In J-Quants API V2, several important specification changes including the authentication method have been made for the purpose of improving usability. Customers using V1 API are requested to check the following changes and migrate to V2 API.

Users who registered on or after December 22, 2025 can only use V2. No migration is required.

V1 specification is here

Authentication & Authorization

The authentication method has been changed from "Token Method" to "API Key Method".

Item	V1 API	V2 API
API Usage	Issue and use ID Token / Refresh Token with `token/auth_user` etc.	Use API Key (`x-api-key` header) issued from the dashboard
Authorization Expiration	ID Token / Refresh Token has an expiration date	API Key itself has no expiration date (Re-issuance/Deletion is possible)

Plan & Data Scope

Item	V1 API	V2 API
Premium Plan Period Limit	Unlimited	Up to Past 20 years
Listed Issue Master (Margin/Credit Category)	Available only in Standard, Premium plans	Available in All Plans

Rate Limits

Maximum number of API requests (Rate Limit) has been set for each plan.

Plan	Limit (Requests / min)
Free	5
Light	60
Standard	120
Premium	500

Endpoint & Parameter Changes

With the migration from V1 API to V2 API, paths and parameters of endpoints have been changed.

Endpoint Correspondence Table

Dataset	V1 Endpoint	V2 Endpoint
Refresh Token	`/v1/token/auth_user`	Discontinued (Use API Key)
ID Token	`/v1/token/auth_refresh`	Discontinued (Use API Key)
Stock Prices (OHLC)	`/v1/prices/daily_quotes`	`/v2/equities/bars/daily`
Morning Session Stock Prices	`/v1/prices/prices_am`	`/v2/equities/bars/daily/am`
Earnings Calendar	`/v1/fins/announcement`	`/v2/equities/earnings-calendar`
Trading by Type of Investors	`/v1/markets/trades_spec`	`/v2/equities/investor-types`
Listed Issue Master	`/v1/listed/info`	`/v2/equities/master`
Futures (OHLC)	`/v1/derivatives/futures`	`/v2/derivatives/bars/daily/futures`
Options (OHLC)	`/v1/derivatives/options`	`/v2/derivatives/bars/daily/options`
Index Option Prices (OHLC)	`/v1/option/index_option`	`/v2/derivatives/bars/daily/options/225`
Breakdown Trading Data	`/v1/markets/breakdown`	`/v2/markets/breakdown`
Trading Calendar	`/v1/markets/trading_calendar`	`/v2/markets/calendar`
Margin Trading Outstanding (Issues Subject to Daily Publication)	`/v1/markets/daily_margin_interest`	`/v2/markets/margin-alert`
Margin Trading Outstandings	`/v1/markets/weekly_margin_interest`	`/v2/markets/margin-interest`
Short Sale Value and Ratio by Sector	`/v1/markets/short_selling`	`/v2/markets/short-ratio`
Outstanding Short Selling Positions Reported	`/v1/markets/short_selling_positions`	`/v2/markets/short-sale-report`
Indices (OHLC)	`/v1/indices`	`/v2/indices/bars/daily`
TOPIX Prices (OHLC)	`/v1/indices/topix`	`/v2/indices/bars/daily/topix`
Financial Statement Data (BS/PL/CF)	`/v1/fins/fs_details`	`/v2/fins/details`
Financial Data(Summary only)	`/v1/fins/statements`	`/v2/fins/summary`
Cash Dividend Data	`/v1/fins/dividend`	`/v2/fins/dividend`

Response Format

Item	V1 API	V2 API
Response Structure	Varies by API	Basically returns data as an array in `"data"` key

Response Example

{
  "data": [
    { ... },
    { ... }
  ],
  "pagination_key": "..."
}

Column Name Change Example (Stock Prices)

In V2 API, response column names may be changed to abbreviated forms. Below is an example of Stock Prices (OHLC).

Item	V1 API Column Name	V2 API Column Name
Date	`Date`	`Date`
Code	`Code`	`Code`
Open	`Open`	`O`
High	`High`	`H`
Low	`Low`	`L`
Close	`Close`	`C`
Volume	`Volume`	`Vo`
Turnover Value	`TurnoverValue`	`Va`
Adjustment Open	`AdjustmentOpen`	`AdjO`
Adjustment High	`AdjustmentHigh`	`AdjH`
Adjustment Low	`AdjustmentLow`	`AdjL`
Adjustment Close	`AdjustmentClose`	`AdjC`
Adjustment Volume	`AdjustmentVolume`	`AdjVo`
Adjustment Factor	`AdjustmentFactor`	`AdjFactor`