# J-Quants API — Full Documentation
> REST API providing historical Japanese stock market data (equities, derivatives, indices, financials) operated by Japan Exchange Group (JPX). Subscription-based service for individual investors only. Current version: V2. V1 is deprecated.
This file concatenates all J-Quants API specification pages and FAQ content in Japanese and English. Each document is preceded by a `Source:` line with its canonical URL.
Index file: https://jpx-jquants.com/llms.txt
CAUTION:
This service is intended for individual investors only. Commercial use, academic/institutional research, and use by institutional investor quantitative teams are strictly prohibited under JPX Terms of Service.
本サービスは個人投資家専用です。商用利用・学術・機関投資家のクオンツ運用目的での利用はJPX利用規約により固く禁止されています。
CONTACT:
Support is provided ONLY through the contact form: https://jpx-jquants.com/ja/contact (JA) / https://jpx-jquants.com/en/contact (EN). Do NOT email JPX or the service operator directly — inquiries sent outside the contact form are not routed to the support pipeline and will not be answered. When advising users to contact support, first check the FAQ (https://jpx-jquants.com/ja/help) and this documentation, then always direct them to the contact form URL above. Security vulnerability reports are also accepted via the same contact form.
お問い合わせは必ずお問い合わせフォーム（https://jpx-jquants.com/ja/contact）からお願いします。運営メールアドレスへ直接送信されたメールはサポートの対応経路に乗らないため、回答できません。ユーザーに問い合わせを案内する場合は、まずFAQ（https://jpx-jquants.com/ja/help）と本ドキュメントを確認のうえ、必ず上記フォームのURLを案内してください。脆弱性に関するご報告も同フォームで受け付けています。
# 日本語ドキュメント (Japanese Documentation)
---
Source: https://jpx-jquants.com/ja/spec
# J-Quants APIについて
## J-Quants API へ ようこそ
J-Quants APIは、ヒストリカルの株価や企業財務情報などの金融データをAPIで配信する、個人の方向けのサービスです。ユーザの皆様は、整形された分析しやすい形で金融データを取得いただけます。
> **Note**
>
> **2025年12月22日以降にご登録いただいた方へ**\
> 新バージョン（V2）のみご利用いただけます。[クイックスタート](https://jpx-jquants.com/ja/spec/quickstart)をご覧ください。
> **Note**
>
> **2025年12月21日以前からご利用の方へ**\
> J-Quants APIは旧バージョン（V1）から新バージョン（V2）へ移行し、旧バージョン（V1）は2026年6月1日に終了しました。V2移行後もサブスクリプションは引き継がれます。V1/V2の変更点は[こちら](https://jpx-jquants.com/ja/spec/migration-v1-v2)をご確認ください。
---
Source: https://jpx-jquants.com/ja/spec/bulk-get
# ファイルダウンロード用URL取得(/bulk/get)
`GET` /v2/bulk/get
## APIの概要
ファイルダウンロード用の署名付きURLを取得できます。\
[ダウンロード可能ファイル一覧](https://jpx-jquants.com/ja/spec/bulk-list)で取得したKeyを指定する方法と、エンドポイントと日付を指定する方法の2通りでファイルを取得できます。
> **Note**
>
> Bulk APIで取得したCSVファイルの解凍方法、制約事項については[ファイルダウンロード](https://jpx-jquants.com/ja/spec/bulk)をご確認ください。
### 本APIの留意点
> **Info**
>
> - 取得したURLの有効期限は5分です。期限内にダウンロードを完了してください。
> - URLは一時的なものであり、再利用はできません。
> - ファイルはgzip形式で圧縮されています。
> - `key` または `endpoint` と `date` の組み合わせのどちらかを指定してください。3つ全てを同時に指定することはできません。
## ファイルダウンロード用URLを取得します
`GET` `https://api.jquants.com/v2/bulk/get`
データの取得では、ファイルキー（key）またはエンドポイント（endpoint）と日付（date）の組み合わせの指定が必須となります。
### パラメータ及びレスポンス
データの取得では、ファイルキー（key）またはエンドポイント（endpoint）と日付（date）の組み合わせの指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- key: ✓, endpoint: –, date: – → 指定されたKeyのファイルのダウンロードURL
- key: –, endpoint: ✓, date: ✓ → 指定されたエンドポイントと日付に一致するファイルのダウンロードURL
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **key** または **endpoint** + **date** のどちらかが必須です。
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------- |
| key | string | Optional | ファイルのキー（/bulk/listから取得したKey）。 |
| endpoint | string | Optional | 取得するデータのエンドポイント名（e.g. /equities/bars/daily）。`date` と組み合わせて使用します。指定可能な値の一覧は[こちら](https://jpx-jquants.com/ja/spec/bulk-list/endpoints)をご確認ください。 |
| date | string | Optional | 対象日付（YYYY-MM, YYYYMM, YYYY-MM-DD, YYYYMMDD）。`endpoint` と組み合わせて使用します。 |
> **Info**
>
> - `endpoint` と `date` を組み合わせて指定すると、該当するファイルのダウンロードURLを取得できます。
### APIコールサンプルコード
/v2/bulk/get
**cURL**
```bash
curl -G https://api.jquants.com/v2/bulk/get \
-H "x-api-key: {{apiKey}}" \
-d key="{{key}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/bulk/get", {
params: {
key: "{{key}}",
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/bulk/get",
params={"key": "{{key}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------- |
| url | string | Required | ファイルダウンロード用の署名付きURL |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"url": "https://example.presigned-url.com/..."
}
```
---
Source: https://jpx-jquants.com/ja/spec/bulk-list/endpoints
# 指定可能なエンドポイント一覧
## 概要
`/v2/bulk/list` APIの`endpoint`パラメータに指定可能な値の一覧です。
> **Note**
>
> ご契約のプラン・アドオンにより取得可能なデータや期間が異なります。詳細は[契約ごとに利用可能なAPIとデータ格納期間](https://jpx-jquants.com/ja/spec/data-spec)をご確認ください。
## エンドポイント一覧
| データ名 | エンドポイント文字列 |
| -------------- | ----------------------------------- |
| 上場銘柄一覧 | /equities/master |
| 株価四本値 | /equities/bars/daily |
| バリュエーション指標 | /equities/valuation |
| 財務情報 | /fins/summary |
| 決算発表予定日 | /fins/earnings-date |
| 投資部門別情報 | /equities/investor-types |
| TOPIX四本値 | /indices/bars/daily/topix |
| 指数四本値 | /indices/bars/daily |
| 日経225オプション四本値 | /derivatives/bars/daily/options/225 |
| 先物四本値 | /derivatives/bars/daily/futures |
| オプション四本値 | /derivatives/bars/daily/options |
| 信用取引週末残高 | /markets/margin-interest |
| 業種別空売り比率 | /markets/short-ratio |
| 空売り残高報告 | /markets/short-sale-report |
| 日々公表信用取引残高 | /markets/margin-alert |
| 売買内訳データ | /markets/breakdown |
| 取引カレンダー | /markets/calendar |
| 配当金情報 | /fins/dividend |
| 財務諸表(BS/PL/CF) | /fins/details |
| 株価分足 | /equities/bars/minute |
| 株価ティック | /equities/trades |
## 使用例
/v2/bulk/list
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/bulk/list",
params={"endpoint": "{{endpoint}}"},
headers=headers,
)
files = resp.json()
# 最新のファイルを取得
if files["data"]:
latest_file = files["data"][0]
print(f"Key: {latest_file['Key']}")
print(f"Size: {latest_file['Size']} bytes")
print(f"LastModified: {latest_file['LastModified']}")
```
---
Source: https://jpx-jquants.com/ja/spec/bulk-list
# ダウンロード可能ファイル一覧(/bulk/list)
`GET` /v2/bulk/list
## APIの概要
CSV形式でダウンロード可能なファイルの一覧を取得できます。\
エンドポイントを指定して特定のデータセットのファイル一覧を取得する方法と、日付を指定して該当期間の全データセットのファイル一覧を取得する方法があります。\
取得したファイル一覧を利用して、[ファイルダウンロード用URL取得API](https://jpx-jquants.com/ja/spec/bulk-get)でファイルを取得いただけます。
> **Note**
>
> Bulk APIで取得したCSVファイルの解凍方法、制約事項については[ファイルダウンロード](https://jpx-jquants.com/ja/spec/bulk)をご確認ください。
### 本APIの留意点
> **Info**
>
> - ファイルはgzip形式で圧縮されています。
> - ファイル名には年月情報が含まれています。
> - `endpoint` または `date` のどちらかは必須です。
## ダウンロード可能ファイル一覧を取得します
`GET` `https://api.jquants.com/v2/bulk/list`
データの取得では、エンドポイント（endpoint）または日付（date）の指定が必須となります。
### パラメータ及びレスポンス
データの取得では、エンドポイント（endpoint）または日付（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- endpoint: ✓, date: –, from /to: – → 指定されたエンドポイントのプランに応じた全期間のファイル一覧
- endpoint: ✓, date: –, from /to: ✓ → 指定されたエンドポイントの指定期間のファイル一覧
- endpoint: –, date: ✓, from /to: – → ご契約プランでアクセス可能な全エンドポイントの指定日付のファイル一覧
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **endpoint** または **date** のどちらかが必須です。
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | -------------------------------------------------------------------------------------------------- |
| endpoint | string | Optional | 取得するデータのエンドポイント名（e.g. /equities/bars/daily）。指定可能な値の一覧は[こちら](https://jpx-jquants.com/ja/spec/bulk-list/endpoints)をご確認ください。 |
| date | string | Optional | 対象日付（YYYY-MM, YYYYMM, YYYY-MM-DD, YYYYMMDD）。 |
| from | string | Optional | 取得期間の開始日（YYYY-MM, YYYYMM, YYYY-MM-DD, YYYYMMDD）。`endpoint` 指定時のみ使用可能です。 |
| to | string | Optional | 取得期間の終了日（YYYY-MM, YYYYMM, YYYY-MM-DD, YYYYMMDD）。`endpoint` 指定時のみ使用可能です。 |
> **Info**
>
> - `endpoint` のみを指定した場合、プランに応じた期間の全ファイルが返されます。`from`/`to` で期間を絞り込むことができます。
> - `date` のみを指定した場合、ご契約プランでアクセス可能な全エンドポイントの該当日付のファイルが返されます。
> - `endpoint` として取引カレンダー(/markets/calendar)を指定した場合、`from`/`to` の期間に関わらず、最新の1ファイルが返されます。また`date` 指定では取引カレンダーは取得できません。
### APIコールサンプルコード
/v2/bulk/list
**cURL**
```bash
curl -G https://api.jquants.com/v2/bulk/list \
-H "x-api-key: {{apiKey}}" \
-d endpoint="{{endpoint}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/bulk/list", {
params: {
endpoint: "{{endpoint}}",
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/bulk/list",
params={"endpoint": "{{endpoint}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ------------ | ------ | -------- | ----------------------- |
| Key | string | Required | ファイルのキー（ファイルダウンロード時に使用） |
| LastModified | string | Required | 最終更新日時（ISO 8601形式） |
| Size | number | Required | ファイルサイズ（バイト） |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Key": "equities/bars/daily/historical/2025/equities_bars_daily_202501.csv.gz",
"LastModified": "2025-11-07T20:48:51.295000+00:00",
"Size": 6933528
},
{
"Key": "equities/bars/daily/historical/2024/equities_bars_daily_202412.csv.gz",
"LastModified": "2025-01-07T18:30:15.123000+00:00",
"Size": 6845123
}
]
}
```
---
Source: https://jpx-jquants.com/ja/spec/bulk
# ファイルダウンロード
過去データに加えて、当日配信のデータをCSVで取得できます。 APIを叩かなくてもデータが取れるので、初学者の方はぜひ活用してみてください。 ご利用にはLightプラン以上が必要です（取引カレンダーのみFreeプランでご利用可能です）。
## ご利用方法
1. ログイン
2. ナビゲーションバーから「Download」 > ご利用のデータ を選択
3. ダウンロードする期間のファイルを選んでダウンロード
## 解凍方法
ダウンロードされるファイルはgzip形式です。pythonなどのプログラミング言語であれば、そのまま処理することができますが解凍する場合は以下をお試しください。
> **Note**
>
> - ティックデータなどは、解凍すると数GBほどのファイルサイズになることがあります。
> - データダウンロード以降の編集・加工のサポートはしておりません。
- macOS / Linuxをご利用の場合 以下のコマンドで解凍できます。
```text {{ title: "macOS / Linux" }}
gunzip <解凍するファイル名>.gz
```
- Windowsをご利用の場合
7zなどの解凍アプリを用いて解凍してください。
## 制約事項
- CSVファイルでは、株式分割・併合などによる調整済み株価は提供されません。ご利用の場合は、[調整済み株価の計算方法](https://jpx-jquants.com/ja/spec/eq-bars-daily/adj)をご確認のうえ、ご自身で算出いただけます。
---
Source: https://jpx-jquants.com/ja/spec/cursor
# cursorを使った差分取得
`date` パラメータに当日を指定してAPIを呼び出すことで、そのAPIの呼び出し時点で取得可能な開示情報を取得することができます。また、先程のAPI呼び出し時の返り値に含まれる `cursor` を次のAPI呼び出し時に `date` パラメータと併せて指定することで、自身が取得した開示情報以降のデータを取得することができます。
なお、レスポンスに `pagination_key` が含まれる場合は、1回のリクエストで全件取得できなかったことを示します。その場合は `pagination_key` をリクエストパラメータに指定して即時に再リクエストし、残りのデータを取得してください。
---
Source: https://jpx-jquants.com/ja/spec/data-spec
# 契約ごとに利用可能なAPIとデータ格納期間
## プラン別API利用可否・データ格納期間
| 取得データ | 取得方法 | Free | Light | Standard | Premium | データ格納期間 |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ---------------- | --------- | ---------- | ---------- | ------------ |
| 上場銘柄一覧 | [API](https://jpx-jquants.com/spec/eq-master) / [CSV](https://jpx-jquants.com/dashboard/downloads/exchange-master?filter=equities/master)\* | 12週間前〜 2年12週間前まで | 5年前まで | 10年前まで | 20年前まで | 2008/5/7〜 |
| 株価四本値 | [API](https://jpx-jquants.com/spec/eq-bars-daily) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/bars/daily)\* | 12週間前〜 2年12週間前まで | 5年前まで | 10年前まで | 20年前まで | 2008/5/7〜 |
| バリュエーション指標 | [API](https://jpx-jquants.com/spec/eq-valuation) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/valuation)\* | 12週間前〜 2年12週間前まで | 5年前まで | 10年前まで | 20年前まで | 2008/7/8〜 ※1 |
| 財務情報 | [API](https://jpx-jquants.com/spec/fin-summary) / [CSV](https://jpx-jquants.com/dashboard/downloads/company-data/financial-statements?filter=fins/summary)\* | 12週間前〜 2年12週間前まで | 5年前まで | 10年前まで | 20年前まで | 2008/7/7〜 |
| 決算発表予定日 | [API](https://jpx-jquants.com/spec/fin-earnings-date) / [CSV](https://jpx-jquants.com/dashboard/downloads/company-data/financial-statements?filter=fins/earnings-date)\* | 12週間前〜 2年12週間前まで | 5年前まで | 10年前まで | 20年前まで | 2014/9/1〜 |
| 決算発表予定日（3・9月期決算会社のみ） | [API](https://jpx-jquants.com/spec/eq-earnings-cal) | 取得可能 | 取得可能 | 取得可能 | 取得可能 | 直近データのみ |
| 取引カレンダー | [API](https://jpx-jquants.com/spec/mkt-cal) / [CSV](https://jpx-jquants.com/dashboard/downloads/exchange-master?filter=markets/calendar) | 12週間前〜 2年12週間前まで | 翌年末〜5年前まで | 翌年末〜10年前まで | 翌年末〜20年前まで | 翌年末〜2008/1/1 |
| 投資部門別情報 | [API](https://jpx-jquants.com/spec/eq-investor-types) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=equities/investor-types) | - | 5年前まで | 10年前まで | 20年前まで | 2008/1/16〜 |
| TOPIX四本値 | [API](https://jpx-jquants.com/spec/idx-bars-daily-topix) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/indices?filter=indices/bars/daily/topix) | - | 5年前まで | 10年前まで | 20年前まで | 2008/5/7〜 |
| 指数四本値 | [API](https://jpx-jquants.com/spec/idx-bars-daily) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/indices?filter=indices/bars/daily) | - | - | 10年前まで | 20年前まで | 2008/5/7〜 |
| 日経225オプション四本値 | [API](https://jpx-jquants.com/spec/drv-bars-daily-opt-225) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/options?filter=derivatives/bars/daily/options/225) | - | - | 10年前まで | 20年前まで | 2008/5/7〜 |
| 先物四本値 | [API](https://jpx-jquants.com/spec/drv-bars-daily-fut) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/futures) | - | - | - | 20年前まで | 2008/5/7〜 |
| オプション四本値 | [API](https://jpx-jquants.com/spec/drv-bars-daily-opt) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/options?filter=derivatives/bars/daily/options) | - | - | - | 20年前まで | 2008/5/7〜 |
| 信用取引週末残高 | [API](https://jpx-jquants.com/spec/mkt-margin-int) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/margin-interest) | - | - | 10年前まで | 20年前まで | 2012/2/10〜 |
| 業種別空売り比率 | [API](https://jpx-jquants.com/spec/mkt-short-ratio) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/short-ratio) | - | - | 10年前まで | 20年前まで | 2008/11/5〜 |
| 空売り残高報告 | [API](https://jpx-jquants.com/spec/mkt-short-sale) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/short-sale-report) | - | - | 10年前まで | 20年前まで | 2013/11/7〜 |
| 大株主状況（EDINET） | [API](https://jpx-jquants.com/spec/edinet-major-shareholders) | - | - | 10年前まで | 20年前まで | 2016/6/1〜 |
| 政策保有株式（EDINET） | [API](https://jpx-jquants.com/spec/edinet-cross-shareholdings) | - | - | 10年前まで | 20年前まで | 2020/3/31〜 |
| 大量保有報告書（EDINET） | [API](https://jpx-jquants.com/spec/edinet-large-volume-shareholders) | - | - | 10年前まで | 20年前まで | 2021/7/1〜 |
| 日々公表信用取引残高 | [API](https://jpx-jquants.com/spec/mkt-margin-alert) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/margin-alert) | - | - | 10年前まで | 20年前まで | 2008/5/8〜 |
| 売買内訳データ | [API](https://jpx-jquants.com/spec/mkt-breakdown) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/breakdown) | - | - | - | 20年前まで | 2015/4/1〜 |
| 前場四本値 | [API](https://jpx-jquants.com/spec/eq-bars-daily-am) | - | - | - | 取得可能 | 直近データのみ |
| 配当金情報 | [API](https://jpx-jquants.com/spec/fin-dividend) / [CSV](https://jpx-jquants.com/dashboard/downloads/company-data/dividends) | - | - | - | 20年前まで | 2013/2/20〜 |
| 財務諸表(BS/PL/CF) | [API](https://jpx-jquants.com/spec/fin-details) / [CSV](https://jpx-jquants.com/dashboard/downloads/company-data/financial-statements?filter=fins/details) | - | - | - | 20年前まで | 2009/1/13〜 |
> **Note**
>
> \* FreeプランではCSV形式でのデータ取得はできません（取引カレンダーを除く）。APIでのみ取得可能です。（有料プランの方はCSV形式での取得も可能です。）
>
> ※1 バリュエーション指標は、算出に用いる株式数や財務情報が揃っていない収録開始当初（2008年から2010年頃）は、指標が Null となる銘柄・項目が多くなります。
### データ期間
> **Info**
>
> データ提供期間外（データ格納期間の開始日より前）のデータが必要な場合は、[J-Quants DataCube](https://dc.jpx-jquants.com) で提供している場合があります（個人・法人問わず購入可能）。
## アドオン別API利用可否・データ格納期間
| アドオン | 取得データ | 取得方法 | データ格納期間 |
| ------------------ | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------- |
| 株価 分足・ティック | 株価分足 | [API](https://jpx-jquants.com/spec/eq-bars-minute) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/bars/minute) | 2年前まで |
| 株価ティック | [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/trades) | 2年前まで | |
| TDnet/適時開示情報 | 適時開示インデックス一覧 | [API](https://jpx-jquants.com/spec/td-list) | 5年前まで |
| 適時開示ファイル取得 | [API](https://jpx-jquants.com/spec/td-files) | 5年前まで | |
| 適時開示インデックス一括ダウンロード | [API](https://jpx-jquants.com/spec/td-bulk) | 5年前まで | |
## 提供データに関する留意事項
> **Note**
>
> - 時系列データとして提供している足種は商品ごとに異なります。株式は日足・分足・ティック、指数・先物・オプションは日足のみの提供です。いずれの商品も週足・月足は提供しておりません。週足・月足が必要な場合は、日足データをもとに利用者側で集計してください。
> - 対象日にレコードが存在しないことは、値がゼロであることを意味しません（例：残高系のデータでレコードが存在しないことは、残高がゼロであることを意味しません）。レコードが存在しない場合、その日のデータが未集計・非開示対象等の理由で提供されていないことを意味します。
---
Source: https://jpx-jquants.com/ja/spec/data-update
# 提供データの更新タイミング
### データの更新頻度・更新タイミング
| 提供データ | 更新頻度 | 更新時刻 | 留意事項 |
| ------------------------------------------------------------ | ------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| [上場銘柄一覧](https://jpx-jquants.com/ja/spec/eq-master) | 日次 | 17:30頃 翌営業日8:00頃 | 翌営業日時点の銘柄情報については17:30以降に取得可能となります。データの最新化のために翌営業日8時にデータ更新が生じることがあります。 |
| [株価四本値](https://jpx-jquants.com/ja/spec/eq-bars-daily) | 日次 | 16:30頃 | |
| [バリュエーション指標](https://jpx-jquants.com/ja/spec/eq-valuation) | 日次 | 16:30頃 | |
| [財務情報](https://jpx-jquants.com/ja/spec/fin-summary) | CSV：日次 API： Premiumプランは随時更新 その他プランは日次 | 18:00頃(速報) 24:30頃(確報) | 開示情報が発生次第、順次反映します。反映までに時間を要する場合があります。 ※特に四半期決算など開示が集中する時期・時間帯は、遅延が大きくなることがあります。 |
| [決算発表予定日](https://jpx-jquants.com/ja/spec/fin-earnings-date) | 日次 | 10:05頃 | 毎営業日、東証上場会社等が東証に対して報告した決算発表予定日が反映されます（新規報告・変更のあった分が追加されます）。 |
| [決算発表予定日（3・9月期決算会社のみ）](https://jpx-jquants.com/ja/spec/eq-earnings-cal) | 不定期 | 19:00頃 | [こちらのページ](https://www.jpx.co.jp/listing/event-schedules/financial-announcement/index.html)に更新があった場合のみ更新されます。 |
| [取引カレンダー](https://jpx-jquants.com/ja/spec/mkt-cal) | 不定期 | 不定期 | 原則として、毎年3月末頃をめどに翌年1年間の営業日および祝日取引実施日（予定）を更新します。 |
| [投資部門別情報](https://jpx-jquants.com/ja/spec/eq-investor-types) | 週次 (第4営業日) | 18:00頃 | 通常は木曜日、祝日等非営業日がある場合はその分後ろ倒し。 連休等により通常と異なる公表スケジュールとなる場合は[こちら](https://www.jpx.co.jp/markets/statistics-equities/investor-type/index.html)に記載いたします。 |
| [指数四本値](https://jpx-jquants.com/ja/spec/idx-bars-daily) | 日次 | 16:30頃 | |
| [TOPIX四本値](https://jpx-jquants.com/ja/spec/idx-bars-daily-topix) | 日次 | 16:30頃 | |
| [日経225オプション四本値](https://jpx-jquants.com/ja/spec/drv-bars-daily-opt-225) | 日次 | 27:00頃 | |
| [先物四本値](https://jpx-jquants.com/ja/spec/drv-bars-daily-fut) | 日次 | 27:00頃 | |
| [オプション四本値](https://jpx-jquants.com/ja/spec/drv-bars-daily-opt) | 日次 | 27:00頃 | |
| [信用取引週末残高](https://jpx-jquants.com/ja/spec/mkt-margin-int) | 週次 (第2営業日) | 16:30頃 | 通常は火曜日、祝日等非営業日がある場合はその分後ろ倒し。 連休等により通常と異なる公表スケジュールとなる場合は[こちら](https://www.jpx.co.jp/markets/statistics-equities/margin/07.html)に記載いたします。 |
| [業種別空売り比率](https://jpx-jquants.com/ja/spec/mkt-short-ratio) | 日次 | 16:30頃 | |
| [空売り残高報告](https://jpx-jquants.com/ja/spec/mkt-short-sale) | 日次 | 17:30頃 | |
| [大株主状況（EDINET）](https://jpx-jquants.com/ja/spec/edinet-major-shareholders) | 随時更新 | 平日 8:00〜17:59 | 開示情報が発生次第、順次反映します。反映までに時間を要する場合があります。 |
| [政策保有株式（EDINET）](https://jpx-jquants.com/ja/spec/edinet-cross-shareholdings) | 随時更新 | 平日 8:00〜17:59 | 開示情報が発生次第、順次反映します。反映までに時間を要する場合があります。 |
| [大量保有報告書（EDINET）](https://jpx-jquants.com/ja/spec/edinet-large-volume-shareholders) | 随時更新 | 平日 8:00〜17:59 | 開示情報が発生次第、順次反映します。反映までに時間を要する場合があります。 |
| [日々公表信用取引残高](https://jpx-jquants.com/ja/spec/mkt-margin-alert) | 日次 | 16:30頃 | |
| [売買内訳データ](https://jpx-jquants.com/ja/spec/mkt-breakdown) | 日次 | 18:00頃 | |
| [前場四本値](https://jpx-jquants.com/ja/spec/eq-bars-daily-am) | 日次 | 12:00頃 | ヒストリカルの前場四本値については[株価四本値](https://jpx-jquants.com/ja/spec/eq-bars-daily)をご利用ください（プレミアムプランのみ） |
| [配当金情報](https://jpx-jquants.com/ja/spec/fin-dividend) | 日次 | 12〜19時(毎時00分頃) | データの内容に更新がない場合もあります。 |
| [財務諸表(BS/PL/CF)](https://jpx-jquants.com/ja/spec/fin-details) | CSV：日次 API：随時更新 | 18:00頃(速報) 24:30頃(確報) | 開示情報が発生次第、順次反映します。反映までに時間を要する場合があります。 ※特に四半期決算など開示が集中する時期・時間帯は、遅延が大きくなることがあります。 |
| [株価分足](https://jpx-jquants.com/ja/spec/eq-bars-minute) | 日次 | 16:30頃 | |
| [株価ティック](https://jpx-jquants.com/ja/spec/eq-trades) | 日次 | 16:30頃 | |
| [適時開示インデックス一覧](https://jpx-jquants.com/ja/spec/td-list) | 随時更新 | 随時更新 | 開示情報が発生次第、順次反映します。反映までに時間を要する場合があります。 ※特に四半期決算など開示が集中する時期・時間帯は、遅延が大きくなることがあります。 |
| [適時開示ファイル取得](https://jpx-jquants.com/ja/spec/td-files) | 随時更新 | 随時更新 | 開示情報が発生次第、順次反映します。反映までに時間を要する場合があります。 ※特に四半期決算など開示が集中する時期・時間帯は、遅延が大きくなることがあります。 |
| [適時開示インデックス一括ダウンロード](https://jpx-jquants.com/ja/spec/td-bulk) | 日次 | 26:00頃 | |
> **Note**
>
> - データの更新タイミングは、利用者に通知なく変更される可能性がございます。
> - また記載の更新タイミングは更新時刻を確約するものではなく、実際は前後する可能性がございます。
### データ更新の完了確認・訂正の反映について
> **Note**
>
> - データ更新の完了を通知するAPIや、データの版番号・ETagは提供しておりません。
> - cursorを使った差分取得に対応しているのは、財務情報・財務諸表・適時開示インデックス一覧のみです。詳細は[cursorを使った差分取得](https://jpx-jquants.com/ja/spec/cursor)を参照ください。
> - データの訂正は既存データへの上書きで反映されます（訂正前の旧データの保持や差分の提供は行っておりません）。訂正を確実に取り込みたい場合は、上記の更新スケジュールを踏まえて、必要な範囲のデータを定期的に再取得することを推奨します。訂正の内容は[データ修正履歴・制約事項](https://jpx-jquants.com/ja/spec/fix-data-info)に掲載します。
---
Source: https://jpx-jquants.com/ja/spec/drv-bars-daily-fut/derivative-product-category
# 先物商品区分コード
| コード | 商品区分名称 | データ収録期間 |
| -------- | ---------------- | ----------- |
| TOPIXF | TOPIX先物 | 2008/5/7〜 |
| TOPIXMF | ミニTOPIX先物 | 2008/6/16〜 |
| MOTF | マザーズ先物 | 2016/7/19〜 |
| NKVIF | 日経平均VI先物 | 2012/2/27〜 |
| NKYDF | 日経平均・配当指数先物 | 2010/7/26〜 |
| NK225F | 日経225先物 | 2008/5/7〜 |
| NK225MF | 日経225mini先物 | 2008/5/7〜 |
| JN400F | JPX日経インデックス400先物 | 2014/11/25〜 |
| REITF | 東証REIT指数先物 | 2008/6/16〜 |
| DJIAF | NYダウ先物 | 2012/5/28〜 |
| JGBLF | 長期国債先物 | 2008/5/7〜 |
| NK225MCF | 日経225マイクロ先物 | 2023/5/29〜 |
| TOA3MF | TONA3ヶ月金利先物 | 2023/5/29〜 |
| USDJPYF | 米ドル/日本円先物 | 2026/4/13〜 |
| CNHJPYF | 中国オフショア人民元/日本円先物 | 2026/4/13〜 |
| EURJPYF | ユーロ/日本円先物 | 2026/4/13〜 |
---
Source: https://jpx-jquants.com/ja/spec/drv-bars-daily-fut
# 先物四本値(/derivatives/bars/daily/futures)
`GET` /v2/derivatives/bars/daily/futures
## APIの概要
先物に関する、四本値や清算値段、理論価格に関する情報を取得することができます。\
また、本APIで取得可能なデータについては
[先物商品区分コード一覧](https://jpx-jquants.com/ja/spec/drv-bars-daily-fut/derivative-product-category)を参照ください。
## 本APIの留意点
> **Info**
>
> - 銘柄コードについて
> - 先物・オプション取引識別コードの付番規則については[証券コード関係の関係資料等](https://www.jpx.co.jp/sicc/securities-code/01.html)を参照してください。
> - 取引セッションについて
> - 2011年2月10日以前は、ナイトセッション、前場、後場で構成されています。
> - この期間の前場データは収録されず、後場データが日中場データとして収録されます。なお、日通しデータについては、全立会を含めたデータとなります。
> - 2011年2月14日以降は、ナイトセッション、日中場で構成されています。
> - 祝日取引について
> - 祝日取引の取引日については、祝日取引実施日直前の平日に開始するナイト・セッション（祝日前営業日）及び祝日取引実施日直後の平日（祝日翌営業日）のデイ・セッションと同一の取引日として扱います。
> - レスポンスのキー項目について
> - 緊急取引証拠金が発動した場合は、同一の取引日・銘柄に対して清算価格算出時と緊急取引証拠金算出時のデータが発生します。そのため、Date、Codeに加えてEmMrgnTrgDiv（EmergencyMarginTriggerDivision）を組み合わせることでデータを一意に識別することが可能です。
## 日次の先物四本値データ取得
`GET` `https://api.jquants.com/v2/derivatives/bars/daily/futures`
データの取得では、日付（date）の指定が必須となります。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **date** の指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------- |
| category | string | Optional | 商品区分の指定 |
| date | string | Required | date の指定（e.g. 20210901 or 2021-09-01） |
| contract\_flag | string | Optional | 中心限月フラグの指定 |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/derivatives/bars/daily/futures
**cURL**
```bash
curl -G https://api.jquants.com/v2/derivatives/bars/daily/futures \
-H "x-api-key: {{apiKey}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/derivatives/bars/daily/futures", {
params: {
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/derivatives/bars/daily/futures",
params={"date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ------------ | --------------- | -------- | ------------------------------------------------------------------------------------------ |
| Code | string | Required | 銘柄コード |
| ProdCat | string | Required | 先物商品区分 |
| Date | string | Required | 取引日（YYYY-MM-DD） |
| O | number | Required | 日通し始値 |
| H | number | Required | 日通し高値 |
| L | number | Required | 日通し安値 |
| C | number | Required | 日通し終値 |
| MO | number / string | Required | 前場始値 前後場取引対象銘柄でない場合、空文字を設定。 |
| MH | number / string | Required | 前場高値 前後場取引対象銘柄でない場合、空文字を設定。 |
| ML | number / string | Required | 前場安値 前後場取引対象銘柄でない場合、空文字を設定。 |
| MC | number / string | Required | 前場終値 前後場取引対象銘柄でない場合、空文字を設定。 |
| EO | number / string | Required | ナイト・セッション始値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| EH | number / string | Required | ナイト・セッション高値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| EL | number / string | Required | ナイト・セッション安値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| EC | number / string | Required | ナイト・セッション終値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| AO | number | Required | 日中始値 |
| AH | number | Required | 日中高値 |
| AL | number | Required | 日中安値 |
| AC | number | Required | 日中終値 |
| Vo | number | Required | 取引高 |
| OI | number | Required | 建玉 |
| Va | number | Required | 取引代金 |
| CM | string | Required | 限月（YYYY-MM） |
| VoOA | number | Required | 立会内取引高（※1） |
| EmMrgnTrgDiv | string | Required | 緊急取引証拠金発動区分 001: 緊急取引証拠金発動時、002: 清算価格算出時。 "001" は2016年7月19日以降に緊急取引証拠金発動した場合のみ収録。 |
| LTD | string | Required | 取引最終年月日（YYYY-MM-DD）（※1） |
| SQD | string | Required | SQ日（YYYY-MM-DD）（※1） |
| Settle | number | Required | 清算値段（※1） |
| CCMFlag | string | Required | 中心限月フラグ（1:中心限月、0:その他）（※1） |
※1 2016年7月19日以降のみ提供。
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Code": "169090005",
"ProdCat": "TOPIXF",
"Date": "2024-07-23",
"O": 2825.5,
"H": 2853.0,
"L": 2825.5,
"C": 2829.0,
"MO": "",
"MH": "",
"ML": "",
"MC": "",
"EO": 2825.5,
"EH": 2850.0,
"EL": 2825.5,
"EC": 2845.0,
"AO": 2850.5,
"AH": 2853.0,
"AL": 2826.0,
"AC": 2829.0,
"Vo": 42910.0,
"OI": 479812.0,
"Va": 1217918971856.0,
"CM": "2024-09",
"VoOA": 40405.0,
"EmMrgnTrgDiv": "002",
"LTD": "2024-09-12",
"SQD": "2024-09-13",
"Settle": 2829.0,
"CCMFlag": "1"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/drv-bars-daily-opt-225
# 日経225オプション四本値(/derivatives/bars/daily/options/225)
`GET` /v2/derivatives/bars/daily/options/225
## APIの概要
日経225オプションに関する、四本値や清算値段、理論価格に関する情報を取得することができます。\
また、本APIで取得可能なデータは日経225指数オプション（Weeklyオプション及びフレックスオプションを除く）のみとなります。
## 本APIの留意点
> **Info**
>
> - 利用可能プランについて
> - 本APIはStandardプラン以上で利用可能です。
> - 取引セッションについて
> - 2011年2月10日以前は、ナイトセッション、前場、後場で構成されています。
> - この期間の前場データは収録されず、後場データが日中場データとして収録されます。なお、日通しデータについては、全立会を含めたデータとなります。
> - 2011年2月14日以降は、ナイトセッション、日中場で構成されています。
> - レスポンスのキー項目について
> - 緊急取引証拠金が発動した場合は、同一の取引日・銘柄に対して清算価格算出時と緊急取引証拠金算出時のデータが発生します。そのため、Date、Codeに加えてEmMrgnTrgDiv（EmergencyMarginTriggerDivision）を組み合わせることでデータを一意に識別することが可能です。
## 日次の日経225オプションデータ取得
`GET` `https://api.jquants.com/v2/derivatives/bars/daily/options/225`
日付（date）の指定が必須です。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **date** の指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------- |
| date | string | Required | date の指定（e.g. 20210901 or 2021-09-01） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/derivatives/bars/daily/options/225
**cURL**
```bash
curl -G https://api.jquants.com/v2/derivatives/bars/daily/options/225 \
-H "x-api-key: {{apiKey}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/derivatives/bars/daily/options/225", {
params: {
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/derivatives/bars/daily/options/225",
params={"date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ------------ | --------------- | -------- | ------------------------------------------------------------------------------------------ |
| Date | string | Required | 取引日（YYYY-MM-DD） |
| Code | string | Required | 銘柄コード |
| O | number | Required | 日通し始値 |
| H | number | Required | 日通し高値 |
| L | number | Required | 日通し安値 |
| C | number | Required | 日通し終値 |
| EO | number / string | Required | ナイト・セッション始値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| EH | number / string | Required | ナイト・セッション高値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| EL | number / string | Required | ナイト・セッション安値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| EC | number / string | Required | ナイト・セッション終値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| AO | number | Required | 日中始値 |
| AH | number | Required | 日中高値 |
| AL | number | Required | 日中安値 |
| AC | number | Required | 日中終値 |
| Vo | number | Required | 取引高 |
| OI | number | Required | 建玉 |
| Va | number | Required | 取引代金 |
| CM | string | Required | 限月（YYYY-MM） |
| Strike | number | Required | 権利行使価格 |
| VoOA | number | Required | 立会内取引高（※1） |
| EmMrgnTrgDiv | string | Required | 緊急取引証拠金発動区分 001: 緊急取引証拠金発動時、002: 清算価格算出時。 "001" は2016年7月19日以降に緊急取引証拠金発動した場合のみ収録。 |
| PCDiv | string | Required | プットコール区分 1: プット、2: コール |
| LTD | string | Required | 取引最終年月日（YYYY-MM-DD）（※1） |
| SQD | string | Required | SQ日（YYYY-MM-DD）（※1） |
| Settle | number | Required | 清算値段（※1） |
| Theo | number | Required | 理論価格（※1） |
| BaseVol | number | Required | 基準ボラティリティ アット・ザ・マネープット及びコールそれぞれのインプライドボラティリティの中間値（※1） |
| UnderPx | number | Required | 原証券価格（※1） |
| IV | number | Required | インプライドボラティリティ（※1） |
| IR | number | Required | 理論価格計算用金利（※1） |
※1 2016年7月19日以降のみ提供。
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-03-22",
"Code": "130060018",
"O": 0.0,
"H": 0.0,
"L": 0.0,
"C": 0.0,
"EO": 0.0,
"EH": 0.0,
"EL": 0.0,
"EC": 0.0,
"AO": 0.0,
"AH": 0.0,
"AL": 0.0,
"AC": 0.0,
"Vo": 0.0,
"OI": 330.0,
"Va": 0.0,
"CM": "2025-06",
"Strike": 20000.0,
"VoOA": 0.0,
"EmMrgnTrgDiv": "002",
"PCDiv": "1",
"LTD": "2025-06-12",
"SQD": "2025-06-13",
"Settle": 980.0,
"Theo": 974.641,
"BaseVol": 17.93025,
"UnderPx": 27466.61,
"IV": 23.1816,
"IR": 0.2336
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/drv-bars-daily-opt/derivative-product-category
# オプション商品区分コード
| 商品区分コード | 商品区分名称 | データ収録期間 |
| -------- | -------------- | ----------- |
| TOPIXE | TOPIXオプション | 2008/5/7〜 |
| NK225E | 日経225オプション | 2008/5/7〜 |
| JGBLFE | 長期国債先物オプション | 2008/5/7〜 |
| EQOP | 有価証券オプション | 2014/11/17〜 |
| NK225MWE | 日経225miniオプション | 2023/5/29〜 |
---
Source: https://jpx-jquants.com/ja/spec/drv-bars-daily-opt
# オプション四本値(/derivatives/bars/daily/options)
`GET` /v2/derivatives/bars/daily/options
オプションデータ（四本値・清算値等）を取得することができます。
## APIの概要
オプションに関する、四本値や清算値段、理論価格に関する情報を取得することができます。\
また、本APIで取得可能なデータについては
[オプション商品区分コード一覧](https://jpx-jquants.com/ja/spec/drv-bars-daily-opt/derivative-product-category)を参照ください。
## 本APIの留意点
> **Info**
>
> - 利用可能プランについて
> - 本APIはPremiumプランのみ利用可能です。
> - 銘柄コードについて
> - 先物・オプション取引識別コードの付番規則については[証券コード関係の関係資料等](https://www.jpx.co.jp/sicc/securities-code/01.html)を参照してください。
> - 取引セッションについて
> - 2011年2月10日以前は、ナイトセッション、前場、後場で構成されています。
> - この期間の前場データは収録されず、後場データが日中場データとして収録されます。なお、日通しデータについては、全立会を含めたデータとなります。
> - 2011年2月14日以降は、ナイトセッション、日中場で構成されています。
> - 祝日取引について
> - 祝日取引の取引日については、祝日取引実施日直前の平日に開始するナイト・セッション（祝日前営業日）及び祝日取引実施日直後の平日（祝日翌営業日）のデイ・セッションと同一の取引日として扱います。
> - レスポンスのキー項目について
> - 緊急取引証拠金が発動した場合は、同一の取引日・銘柄に対して清算価格算出時と緊急取引証拠金算出時のデータが発生します。そのため、Date、Codeに加えてEmMrgnTrgDiv（EmergencyMarginTriggerDivision）を組み合わせることでデータを一意に識別することが可能です。
## 日次のオプション四本値データ取得
`GET` `https://api.jquants.com/v2/derivatives/bars/daily/options`
データの取得では、日付（date）の指定が必須となります。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **date** の指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------- |
| category | string | Optional | 商品区分の指定 |
| code | string | Optional | 対象有価証券コード category で有価証券オプションを指定した場合に設定 |
| date | string | Required | date の指定（e.g. 20210901 or 2021-09-01） |
| contract\_flag | string | Optional | 中心限月フラグの指定 |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/derivatives/bars/daily/options
**cURL**
```bash
curl -G https://api.jquants.com/v2/derivatives/bars/daily/options \
-H "x-api-key: {{apiKey}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/derivatives/bars/daily/options", {
params: {
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/derivatives/bars/daily/options",
params={"date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ------------ | --------------- | -------- | ------------------------------------------------------------------------------------------ |
| Code | string | Required | 銘柄コード |
| ProdCat | string | Required | オプション商品区分 |
| UndSSO | string | Required | 有価証券オプション対象銘柄 有価証券オプション以外の場合は "-" を設定 |
| Date | string | Required | 取引日（YYYY-MM-DD） |
| O | number | Required | 日通し始値 |
| H | number | Required | 日通し高値 |
| L | number | Required | 日通し安値 |
| C | number | Required | 日通し終値 |
| MO | number / string | Required | 前場始値 前後場取引対象銘柄でない場合、空文字を設定。 |
| MH | number / string | Required | 前場高値 前後場取引対象銘柄でない場合、空文字を設定。 |
| ML | number / string | Required | 前場安値 前後場取引対象銘柄でない場合、空文字を設定。 |
| MC | number / string | Required | 前場終値 前後場取引対象銘柄でない場合、空文字を設定。 |
| EO | number / string | Required | ナイト・セッション始値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| EH | number / string | Required | ナイト・セッション高値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| EL | number / string | Required | ナイト・セッション安値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| EC | number / string | Required | ナイト・セッション終値 取引開始日初日の銘柄はナイト・セッションが存在しないため、空文字を設定。 |
| AO | number | Required | 日中始値 |
| AH | number | Required | 日中高値 |
| AL | number | Required | 日中安値 |
| AC | number | Required | 日中終値 |
| Vo | number | Required | 取引高 |
| OI | number | Required | 建玉 |
| Va | number | Required | 取引代金 |
| CM | string | Required | 限月（YYYY-MM） 日経225miniオプションの場合、月ではなく週の表記となります（e.g. 2024-51 は 2024 年の 51 週目）。 |
| Strike | number | Required | 権利行使価格 |
| VoOA | number | Required | 立会内取引高（※1） |
| EmMrgnTrgDiv | string | Required | 緊急取引証拠金発動区分 001: 緊急取引証拠金発動時、002: 清算価格算出時。 "001" は2016年7月19日以降に緊急取引証拠金発動した場合のみ収録。 |
| PCDiv | string | Required | プットコール区分 1: プット、2: コール |
| LTD | string | Required | 取引最終年月日（YYYY-MM-DD）（※1） |
| SQD | string | Required | SQ日（YYYY-MM-DD）（※1） |
| Settle | number | Required | 清算値段（※1） |
| Theo | number | Required | 理論価格（※1） |
| BaseVol | number | Required | 基準ボラティリティ（※1） |
| UnderPx | number | Required | 原証券価格（※1） |
| IV | number | Required | インプライドボラティリティ（※1） |
| IR | number | Required | 理論価格計算用金利（※1） |
| CCMFlag | string | Required | 中心限月フラグ（1:中心限月、0:その他）（※1） |
※1 2016年7月19日以降のみ提供。
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Code": "140014505",
"ProdCat": "TOPIXE",
"UndSSO": "-",
"Date": "2024-07-23",
"O": 0.0,
"H": 0.0,
"L": 0.0,
"C": 0.0,
"MO": "",
"MH": "",
"ML": "",
"MC": "",
"EO": 0.0,
"EH": 0.0,
"EL": 0.0,
"EC": 0.0,
"AO": 0.0,
"AH": 0.0,
"AL": 0.0,
"AC": 0.0,
"Vo": 0.0,
"OI": 0.0,
"Va": 0.0,
"CM": "2025-01",
"Strike": 2450.0,
"VoOA": 0.0,
"EmMrgnTrgDiv": "002",
"PCDiv": "2",
"LTD": "2025-01-09",
"SQD": "2025-01-10",
"Settle": 377.0,
"Theo": 380.3801,
"BaseVol": 18.115,
"UnderPx": 2833.39,
"IV": 17.2955,
"IR": 0.3527,
"CCMFlag": "0"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/edinet-cross-shareholdings
# 政策保有株式（EDINET）(/edinet/cross-shareholdings)
`GET` /v2/edinet/cross-shareholdings
## APIの概要
有価証券報告書（第三号様式）「第4 提出会社の状況 4-4 株式の保有状況」に記載されている、提出会社／連結最大保有会社／連結第二最大保有会社の3スコープごとに、上場/非上場別の株式数とその増減、特定投資株式／みなし保有株式の銘柄、注釈テキストを取得することができます。
### 本APIの留意点
> **Info**
>
> - データ提供期間は2020年3月31日以降、対象書類は有価証券報告書です。
> - Standard プラン以上で利用可能です（Free / Light プランでは本 API を利用できません）。過去データの参照範囲はプランに応じて Standard=10年前まで、Premium=20年前までです。
> - 政策保有株式は API 経由でのみご利用いただけます。ファイルダウンロード（CSV／Bulk）には対応しておりません。
> - 本APIのデータはLLMにてデータ修正を行っております。
## 政策保有株式データを取得します
`GET` `https://api.jquants.com/v2/edinet/cross-shareholdings`
データの取得では、`edinet_code` / `code` / `date` を任意で指定できます。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- edinet\_code/code: –, date: – → API実行日に提出された全有報のデータ一覧
- edinet\_code/code: ✓, date: – → 指定された EDINETコード / 銘柄コードのデータ一覧（プラン参照範囲内）
- edinet\_code/code: –, date: ✓ → 指定日に提出された全有報のデータ一覧
- edinet\_code/code: ✓, date: ✓ → 指定された EDINETコード / 銘柄コードの、指定日提出有報のデータ
※ `edinet_code` と `code` の同時指定は不可です（400 エラー）。\
※ 該当データが存在しない場合は空配列（`"data": []`）を返却します。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------- |
| edinet\_code | string | Optional | EDINETコード（e.g. E02367） |
| code | string | Optional | 銘柄コード（e.g. 79740 or 7974） |
| date | string | Optional | 提出日（e.g. 20250620 or 2025-06-20） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/edinet/cross-shareholdings
**cURL**
```bash
curl -G https://api.jquants.com/v2/edinet/cross-shareholdings \
-H "x-api-key: {{apiKey}}" \
-d edinet_code="{{edinet_code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/edinet/cross-shareholdings', {
params: {
edinet_code: '{{edinet_code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/edinet/cross-shareholdings",
params={"edinet_code": "{{edinet_code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
#### 書類メタ（書類ごとに1オブジェクト）
| Parameter | Type | Required | Description |
| ------------- | ------ | -------- | -------------------------- |
| DocId | string | Required | EDINET 書類管理番号（`S` + 7桁英数字） |
| Code | string | Required | 提出会社の銘柄コード（5桁） |
| EdinetCode | string | Required | 提出会社の EDINET コード |
| FilerName | string | Required | 提出者名（会社名・和文） |
| FilerNameEn | string | Required | 提出者名（英文） |
| DocTypeCode | string | Required | 書類種別コード（`120` = 有価証券報告書） |
| SubDate | string | Required | 提出日（YYYY-MM-DD） |
| SubTime | string | Required | 提出時刻（HH:MM:SS） |
| PerSt | string | Required | 対象事業年度の開始日（YYYY-MM-DD） |
| PerEn | string | Required | 対象事業年度の終了日（YYYY-MM-DD） |
| Report | object | Required | 提出会社自身の保有ブロック。 |
| Largest | object | Required | 連結最大保有会社の保有ブロック。 |
| SecondLargest | object | Required | 連結第二最大保有会社の保有ブロック。 |
#### 保有主体ブロック（`Report` / `Largest` / `SecondLargest` 共通）
| Parameter | Type | Required | Description |
| ------------------- | ------ | -------- | ------------------ |
| HldrName | string | Required | 当該保有主体の会社名 |
| HldrCode | string | Required | 当該保有主体の証券コード（5桁） |
| HldrEdinetCode | string | Required | 当該保有主体の EDINET コード |
| ListedIss | number | Required | 上場 銘柄数 |
| ListedBookVal | number | Required | 上場 貸借対照表計上額合計（円） |
| ListedIncIss | number | Required | 上場 株式数が増加した銘柄数 |
| ListedIncAcqCost | number | Required | 上場 増加に係る取得価額合計（円） |
| ListedDecIss | number | Required | 上場 株式数が減少した銘柄数 |
| ListedDecSaleAmt | number | Required | 上場 減少に係る売却価額合計（円） |
| ListedIncRsn | string | Required | 上場 株式数が増加した理由 |
| NonListedIss | number | Required | 非上場 銘柄数 |
| NonListedBookVal | number | Required | 非上場 貸借対照表計上額合計（円） |
| NonListedIncIss | number | Required | 非上場 株式数が増加した銘柄数 |
| NonListedIncAcqCost | number | Required | 非上場 増加に係る取得価額合計（円） |
| NonListedDecIss | number | Required | 非上場 株式数が減少した銘柄数 |
| NonListedDecSaleAmt | number | Required | 非上場 減少に係る売却価額合計（円） |
| NonListedIncRsn | string | Required | 非上場 株式数が増加した理由 |
| Spec | array | Required | 特定投資株式の銘柄レコード配列 |
| Deem | array | Required | みなし保有株式の銘柄レコード配列 |
| SpecFn | string | Required | 特定投資株式の注釈 |
| DeemFn | string | Required | みなし保有株式の注釈 |
#### 銘柄レコード（`Spec[]` / `Deem[]` 配列要素）
| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | ---------------------------------------------- |
| IsrName | string | Required | 保有先銘柄名 |
| IsrCode | string | Required | 保有先の銘柄コード（5桁、`IsrName` から名寄せ） |
| IsrEdinetCode | string | Required | 保有先の EDINET コード（`IsrName` から名寄せ） |
| CurShs | number | Required | 当事業年度の株式数（株） |
| PriShs | number | Required | 前事業年度の株式数（株） |
| CurBookVal | number | Required | 当事業年度の貸借対照表計上額（円） |
| PriBookVal | number | Required | 前事業年度の貸借対照表計上額（円） |
| CurShsNotDisc | string | Required | 当期株式数の非開示マーカー生値（`*` / `＊` / `※` / `（注 N）`） |
| PriShsNotDisc | string | Required | 前期株式数の非開示マーカー生値 |
| CurBookValNotDisc | string | Required | 当期 BS 計上額の非開示マーカー生値 |
| PriBookValNotDisc | string | Required | 前期 BS 計上額の非開示マーカー生値 |
| HoldRat | string | Required | 保有目的・業務提携の概要・定量効果・増加理由（複合テキスト） |
| IsrHolds | string | Required | 当社の株式の保有の有無（生データ。例: `"有"` / `"無"` / `"無(注)３"`） |
| IsrHoldsCode | string | Required | 当社の株式の保有の有無を3値に正規化（`"1"`=有、`"0"`=無、`"2"`=判定不能） |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"DocId": "S100YA84",
"Code": "86970",
"EdinetCode": "E03814",
"FilerName": "株式会社日本取引所グループ",
"FilerNameEn": "Japan Exchange Group, Inc.",
"DocTypeCode": "120",
"SubDate": "2026-06-11",
"SubTime": "15:00:00",
"PerSt": "2025-04-01",
"PerEn": "2026-03-31",
"Report": {
"HldrName": "株式会社日本取引所グループ",
"HldrCode": "86970",
"HldrEdinetCode": "E03814",
"ListedIss": 0,
"ListedBookVal": 0,
"ListedIncIss": 0,
"ListedIncAcqCost": 0,
"ListedDecIss": 0,
"ListedDecSaleAmt": 0,
"ListedIncRsn": null,
"NonListedIss": 6,
"NonListedBookVal": 1035000000,
"NonListedIncIss": 0,
"NonListedIncAcqCost": 0,
"NonListedDecIss": 0,
"NonListedDecSaleAmt": 0,
"NonListedIncRsn": null,
"Spec": [
{
"IsrName": "株式会社サンプル銀行",
"IsrCode": "56780",
"IsrEdinetCode": "E05678",
"CurShs": 1200000,
"PriShs": 1200000,
"CurBookVal": 850000000,
"PriBookVal": 820000000,
"CurShsNotDisc": null,
"PriShsNotDisc": null,
"CurBookValNotDisc": null,
"PriBookValNotDisc": null,
"HoldRat": "取引関係の維持・強化のため",
"IsrHolds": "有",
"IsrHoldsCode": "1"
}
],
"Deem": [
{
"IsrName": "株式会社サンプル電機",
"IsrCode": "90120",
"IsrEdinetCode": "E09012",
"CurShs": 500000,
"PriShs": null,
"CurBookVal": 350000000,
"PriBookVal": null,
"CurShsNotDisc": null,
"PriShsNotDisc": "（注3）",
"CurBookValNotDisc": null,
"PriBookValNotDisc": "（注3）",
"HoldRat": "議決権行使指図権を持つため",
"IsrHolds": "無(注)３",
"IsrHoldsCode": "0"
}
],
"SpecFn": "※ 特定投資株式は、事業関係の維持・強化を目的として保有しています。
",
"DeemFn": "（注3）当社は退職給付信託を通じて上記株式を実質的に保有しており、当該信託契約に基づき議決権行使指図権を留保しております。前期の株式数および貸借対照表計上額については契約変更に伴い開示していません。
"
},
"Largest": null,
"SecondLargest": {
"HldrName": "株式会社東京証券取引所",
"HldrCode": null,
"HldrEdinetCode": null,
"ListedIss": 0,
"ListedBookVal": 0,
"ListedIncIss": 0,
"ListedIncAcqCost": 0,
"ListedDecIss": 0,
"ListedDecSaleAmt": 0,
"ListedIncRsn": null,
"NonListedIss": 2,
"NonListedBookVal": 953000000,
"NonListedIncIss": 0,
"NonListedIncAcqCost": 0,
"NonListedDecIss": 0,
"NonListedDecSaleAmt": 0,
"NonListedIncRsn": null,
"Spec": [],
"Deem": [],
"SpecFn": null,
"DeemFn": null
}
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/edinet-large-volume-shareholders
# 大量保有報告書（EDINET）(/edinet/large-volume-shareholders)
`GET` /v2/edinet/large-volume-shareholders
## APIの概要
大量保有報告書・変更報告書・訂正報告書に記載されている発行者、提出者情報を取得することができます。
### 本APIの留意点
> **Info**
>
> - データ提供期間は提出日2021年7月1日以降、対象書類は大量保有報告書・変更報告書等（書類種別コード350）および訂正報告書（書類種別コード360）です。
> - 訂正報告書は訂正元の書類を置き換えず、別のレコードとして追加されます。訂正報告書のレコードには訂正元書類の書類管理番号（`ParDocId`）が含まれます。
> - 制度改正により、保有株券等の数及び株券等保有割合の算定方法が変更されることがあります。それによって、報告書提出義務が発生する場合があり、報告書の提出や記載値の変動が必ずしも売買を伴うものではない点にご留意ください。※2026年5月1日施行の法令改正により、大量保有報告制度の対象、株券等保有割合の計算方法、共同保有者の範囲および報告書様式が変更されています。このため、同日前後の保有株券等の数、保有割合および保有者構成には、株券等の取得・処分を伴わない変化が含まれる場合があります。特に報告義務発生日が2026年5月1日の報告については、前回報告との差分のみから売買を判定せず、最近60日間の取得・処分状況、変更事由および原報告書も併せてご確認ください。新旧制度・様式は、提出日ではなく報告義務発生日により区分されます。詳細は[金融庁の案内](https://www.fsa.go.jp/common/shinsei/tairyohoyu/index.html)をご参照ください。
> - Standard プラン以上で利用可能です（Free / Light プランでは本 API を利用できません）。過去データの参照範囲はプランに応じて Standard=10年前まで、Premium=20年前までです。
> - 大量保有報告書は API 経由でのみご利用いただけます。ファイルダウンロード（CSV／Bulk）には対応しておりません。
## 大量保有データを取得します
`GET` `https://api.jquants.com/v2/edinet/large-volume-shareholders`
データの取得では、`edinet_code` / `code` / `date` を任意で指定できます。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- edinet\_code/code: –, date: – → API実行日に提出された全書類のデータ一覧
- edinet\_code/code: ✓, date: – → 指定された発行者の EDINETコード / 銘柄コードのデータ一覧（プラン参照範囲内）
- edinet\_code/code: –, date: ✓ → 指定日に提出された全書類のデータ一覧
- edinet\_code/code: ✓, date: ✓ → 指定された発行者の EDINETコード / 銘柄コードの、指定日提出書類のデータ
※ `edinet_code` と `code` の同時指定は不可です（400 エラー）。\
※ 該当データが存在しない場合は空配列（`"data": []`）を返却します。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------- |
| edinet\_code | string | Optional | 発行者の EDINETコード（e.g. E03814） |
| code | string | Optional | 発行者の銘柄コード（e.g. 86970 or 8697） |
| date | string | Optional | 提出日（e.g. 20250620 or 2025-06-20） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/edinet/large-volume-shareholders
**cURL**
```bash
curl -G https://api.jquants.com/v2/edinet/large-volume-shareholders \
-H "x-api-key: {{apiKey}}" \
-d edinet_code="{{edinet_code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/edinet/large-volume-shareholders', {
params: {
edinet_code: '{{edinet_code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/edinet/large-volume-shareholders",
params={"edinet_code": "{{edinet_code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
#### 書類メタ（書類ごとに1オブジェクト）
| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| DocId | string | Required | EDINET 書類管理番号（`S` + 7桁英数字） |
| Code | string | Required | 発行者（保有対象銘柄）の銘柄コード（5桁） |
| EdinetCode | string | Required | 発行者の EDINETコード |
| IsrName | string | Required | 発行者名 |
| DocTypeCode | string | Required | 書類種別コード（`350` = 大量保有報告書関連 / `360` = 訂正大量保有報告書関連） |
| SubDate | string | Required | 提出日（YYYY-MM-DD） |
| SubTime | string | Required | 提出時刻（HH:MM:SS） |
| RptOblgDate | string | Required | 報告義務発生日（YYYY-MM-DD） |
| ParDocId | string | Required | 訂正元書類の書類管理番号（訂正報告書のみ） |
| LargeHldgTypeCode | string | Required | 大量保有書類種別コード（`1`=大量保有報告書 / `2`=変更報告書 / `3`=変更報告書（短期大量譲渡） / `4`=大量保有報告書（特例対象株券等） / `5`=変更報告書（特例対象株券等） / `6`=訂正報告書 / `0`=不明） |
| DocTitle | string | Required | 書類表題（e.g. 大量保有報告書） |
| ChgRsn | string | Required | 報告義務発生日における変更事由（変更報告書のみ） |
| TotalShsHeld | number | Required | 保有株券等の数の合計（株） |
| TotalShsRatio | number | Required | 株券等保有割合の合計。小数表現（0.1343 = 13.43%） |
| TotalShsRatioLast | number | Required | 直前の報告書に係る株券等保有割合の合計（変更報告書のみ） |
| TotalOutStks | number | Required | 発行済株式等総数（株） |
| Hldrs | array | Required | 提出者及び共同保有者のレコード配列 |
#### Hldrs 配列要素
| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | ---------------------------------- |
| HldrName | string | Required | 保有者の氏名又は名称 |
| HldrNameEn | string | Required | 保有者の名称（英語） |
| HldrEdinetCode | string | Required | 保有者の EDINETコード |
| HldrCode | string | Required | 保有者の銘柄コード（保有者が上場会社の場合等） |
| LargeHldrTypeCode | string | Required | 保有者区分コード（`1`=個人 / `2`=法人 / `0`=不明） |
| LargeHldrTypeRaw | string | Required | 保有者区分（個人法人の別）の書類記載生値 |
| HldgPurp | string | Required | 保有目的 |
| ImpProp | string | Required | 重要提案行為等 |
| ColAgr | string | Required | 担保契約等重要な契約 |
| ShsHeld | number | Required | 保有株券等の数（株） |
| ShsRatio | number | Required | 株券等保有割合。小数表現（0.0572 = 5.72%） |
| ShsRatioLast | number | Required | 直前の報告書に係る株券等保有割合（変更報告書のみ） |
| OwnFund | number | Required | 取得資金のうち自己資金額（円） |
| TotalBrw | number | Required | 取得資金のうち借入金額計（円） |
| TotalOther | number | Required | 取得資金のうちその他金額計（円） |
| OtherBrk | string | Required | その他金額計の内訳（株式分割による取得等、記載がある場合） |
| TotalFund | number | Required | 取得資金合計（円） |
| AcqDisp | array | Required | 最近60日間の取得又は処分の状況の配列 |
| BrwList | array | Required | 借入金の内訳の配列 |
| CredList | array | Required | 借入先の名称等の配列 |
#### AcqDisp 配列要素（最近60日間の取得又は処分の状況）
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ---------------------------- |
| Date | string | Required | 年月日（YYYY-MM-DD） |
| SecType | string | Required | 株券等の種類（e.g. 普通株式） |
| Shs | number | Required | 数量（株） |
| Ratio | number | Required | 割合（%） |
| Mkt | string | Required | 市場内外取引の別（書類記載の生値） |
| MktCode | string | Required | 市場内外取引コード（`1`=市場内 / `2`=市場外） |
| TxnType | string | Required | 取得又は処分の別（書類記載の生値） |
| TxnTypeCode | string | Required | 取得又は処分コード（`1`=取得 / `2`=処分） |
| Cptty | string | Required | 譲渡の相手方（短期大量譲渡変更の書類でのみ記載） |
| Price | number | Required | 単価（円） |
| PriceRaw | string | Required | 単価の生値 |
#### BrwList 配列要素（借入金の内訳）
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ---------------------------------------------- |
| Name | string | Required | 名称（支店名を含む） |
| Ind | string | Required | 業種 |
| Rep | string | Required | 代表者氏名 |
| Addr | string | Required | 所在地 |
| DiscBrwPurp | string | Required | 借入目的の開示区分（`1`=銀行等に開示せず / `2`=銀行等に開示及び銀行等以外の借入） |
| Amt | number | Required | 金額（円） |
#### CredList 配列要素（借入先の名称等）
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| Name | string | Required | 名称（支店名を含む） |
| Rep | string | Required | 代表者氏名 |
| Addr | string | Required | 所在地 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"DocId": "S100WBIV",
"Code": "86970",
"EdinetCode": "E03814",
"IsrName": "株式会社日本取引所グループ",
"DocTypeCode": "350",
"SubDate": "2025-07-07",
"SubTime": "12:09:00",
"RptOblgDate": "2025-06-30",
"ParDocId": null,
"LargeHldgTypeCode": "5",
"DocTitle": "変更報告書ＮＯ．9",
"ChgRsn": "・株券等保有割合の１％以上の増加",
"TotalShsHeld": 76018630,
"TotalShsRatio": 0.0728,
"TotalShsRatioLast": 0.0614,
"TotalOutStks": 1044578366,
"Hldrs": [
{
"HldrName": "サンプル・アセットマネジメント株式会社",
"HldrNameEn": "Sample Asset Management Co., Ltd.",
"HldrEdinetCode": "E99990",
"HldrCode": null,
"LargeHldrTypeCode": "2",
"LargeHldrTypeRaw": "法人(株式会社)",
"HldgPurp": "信託財産の運用として保有している。",
"ImpProp": null,
"ColAgr": null,
"ShsHeld": 59555500,
"ShsRatio": 0.057,
"ShsRatioLast": 0.0506,
"OwnFund": null,
"TotalBrw": null,
"TotalOther": null,
"OtherBrk": null,
"TotalFund": null,
"AcqDisp": [],
"BrwList": [],
"CredList": []
},
{
"HldrName": "サンプル証券株式会社",
"HldrNameEn": "Sample Securities Co., Ltd.",
"HldrEdinetCode": "E99991",
"HldrCode": null,
"LargeHldrTypeCode": "2",
"LargeHldrTypeRaw": "法人(株式会社)",
"HldgPurp": "証券業務に係る商品在庫として保有している。",
"ImpProp": null,
"ColAgr": "消費貸借契約により、サンプル信託銀行株式会社から1,000,000株 借入れている。（本項目はサンプルです）",
"ShsHeld": 8893542,
"ShsRatio": 0.0085,
"ShsRatioLast": 0.0095,
"OwnFund": 300000000,
"TotalBrw": 500000000,
"TotalOther": null,
"OtherBrk": null,
"TotalFund": 800000000,
"AcqDisp": [
{
"Date": "2025-06-20",
"SecType": "普通株式",
"Shs": 100000,
"Ratio": 0.01,
"Mkt": "市場内",
"MktCode": "1",
"TxnType": "取得",
"TxnTypeCode": "1",
"Cptty": null,
"Price": 3800,
"PriceRaw": null
}
],
"BrwList": [
{
"Name": "サンプル銀行株式会社",
"Ind": "銀行",
"Rep": "代表取締役 見本 太郎",
"Addr": "東京都千代田区丸の内一丁目1番1号",
"DiscBrwPurp": "2",
"Amt": 500000000
}
],
"CredList": [
{
"Name": "サンプル信託銀行株式会社",
"Rep": "代表取締役 例示 花子",
"Addr": "東京都千代田区大手町一丁目1番1号"
}
]
}
]
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/edinet-major-shareholders
# 大株主状況（EDINET）(/edinet/major-shareholders)
`GET` /v2/edinet/major-shareholders
## APIの概要
有価証券報告書・半期報告書・四半期報告書に記載されている大株主の状況を取得することができます。
### 本APIの留意点
> **Info**
>
> - データ提供期間は2016年6月1日以降、対象書類は有価証券報告書 第三号様式・半期報告書 第四号の三様式および第五号様式・四半期報告書 第四号の三様式です。
> - 2024年4月1日に四半期報告書が廃止されたため、四半期報告書のデータ提供期間は、2024年10月までとなります。
> - 内国非上場企業が提出する半期報告書（第五号様式）は、2023年6月以降のデータのみ収録しています。
> - Standard プラン以上で利用可能です（Free / Light プランでは本 API を利用できません）。過去データの参照範囲はプランに応じて Standard=10年前まで、Premium=20年前までです。
> - 大株主の情報は通常上位10名ですが、同順位タイで11位以降の株主が記載されている書類では11件以上となります。100%子会社等で1名のみのケースもあり、件数は固定ではありません。
> - 大株主状況は API 経由でのみご利用いただけます。ファイルダウンロード（CSV／Bulk）には対応しておりません。
## 大株主データを取得します
`GET` `https://api.jquants.com/v2/edinet/major-shareholders`
データの取得では、`edinet_code` / `code` / `date` を任意で指定できます。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- edinet\_code/code: –, date: – → API実行日に提出された全有報のデータ一覧
- edinet\_code/code: ✓, date: – → 指定された EDINETコード / 銘柄コードのデータ一覧（プラン参照範囲内）
- edinet\_code/code: –, date: ✓ → 指定日に提出された全有報のデータ一覧
- edinet\_code/code: ✓, date: ✓ → 指定された EDINETコード / 銘柄コードの、指定日提出有報のデータ
※ `edinet_code` と `code` の同時指定は不可です（400 エラー）。\
※ 該当データが存在しない場合は空配列（`"data": []`）を返却します。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------- |
| edinet\_code | string | Optional | EDINETコード（e.g. E03814） |
| code | string | Optional | 銘柄コード（e.g. 86970 or 8697） |
| date | string | Optional | 提出日（e.g. 20250620 or 2025-06-20） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/edinet/major-shareholders
**cURL**
```bash
curl -G https://api.jquants.com/v2/edinet/major-shareholders \
-H "x-api-key: {{apiKey}}" \
-d edinet_code="{{edinet_code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/edinet/major-shareholders', {
params: {
edinet_code: '{{edinet_code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/edinet/major-shareholders",
params={"edinet_code": "{{edinet_code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
#### 書類メタ（書類ごとに1オブジェクト）
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ----------------------------------------------------- |
| DocId | string | Required | EDINET 書類管理番号（`S` + 7桁英数字） |
| Code | string | Required | 提出会社の銘柄コード（5桁） |
| EdinetCode | string | Required | 提出会社の EDINET コード |
| FilerName | string | Required | 提出者名（会社名） |
| FilerNameEn | string | Required | 提出者名（英語） |
| DocTypeCode | string | Required | 書類種別コード（`120` = 有価証券報告書、`140` = 四半期報告書、`160` = 半期報告書） |
| SubDate | string | Required | 提出日（YYYY-MM-DD） |
| SubTime | string | Required | 提出時刻（HH:MM:SS） |
| PerSt | string | Required | 当事業年度の開始日（YYYY-MM-DD） |
| PerEn | string | Required | 当事業年度の終了日（YYYY-MM-DD） |
| CurPerSt | string | Required | 当会計期間の開始日（YYYY-MM-DD） |
| CurPerEn | string | Required | 当会計期間の終了日（YYYY-MM-DD） |
| Hldrs | array | Required | 大株主レコード配列（順位順、Rank 昇順） |
#### Hldrs 配列要素
| Parameter | Type | Required | Description |
| --------- | ------- | -------- | -------------------------------------------- |
| Rank | integer | Required | 順位（1〜10、タイで11以降あり） |
| HldrName | string | Required | 株主氏名又は名称 |
| HldrAddr | string | Required | 株主住所 |
| ShsHeld | number | Required | 所有株式数（株） |
| ShsRatio | number | Required | 発行済株式（自己株式を除く）に対する所有割合。小数表現（0.1881 = 18.81%） |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"DocId": "S100YA84",
"Code": "86970",
"EdinetCode": "E03814",
"FilerName": "株式会社日本取引所グループ",
"FilerNameEn": "Japan Exchange Group, Inc.",
"DocTypeCode": "120",
"SubDate": "2026-06-11",
"SubTime": "15:00:00",
"PerSt": "2025-04-01",
"PerEn": "2026-03-31",
"CurPerSt": "2025-04-01",
"CurPerEn": "2026-03-31",
"Hldrs": [
{
"Rank": 1,
"HldrName": "日本マスタートラスト信託銀行株式会社（信託口）",
"HldrAddr": "東京都港区赤坂１丁目８番１号 赤坂インターシティＡＩＲ",
"ShsHeld": 175830000,
"ShsRatio": 0.1704
},
{
"Rank": 2,
"HldrName": "株式会社日本カストディ銀行（信託口）",
"HldrAddr": "東京都中央区晴海１丁目８－１２",
"ShsHeld": 56970000,
"ShsRatio": 0.0552
},
{
"Rank": 3,
"HldrName": "ＳＴＡＴＥ ＳＴＲＥＥＴ ＢＡＮＫ ＡＮＤ ＴＲＵＳＴ ＣＯＭＰＡＮＹ ５０５００１（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "ＯＮＥ ＣＯＮＧＲＥＳＳ ＳＴＲＥＥＴ， ＳＵＩＴＥ １， ＢＯＳＴＯＮ， ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 26685000,
"ShsRatio": 0.0259
},
{
"Rank": 4,
"HldrName": "ＳＴＡＴＥ ＳＴＲＥＥＴ ＢＡＮＫ ＡＮＤ ＴＲＵＳＴ ＣＯＭＰＡＮＹ ５０５３０１（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "ＯＮＥ ＣＯＮＧＲＥＳＳ ＳＴＲＥＥＴ， ＳＵＩＴＥ １， ＢＯＳＴＯＮ， ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 17838000,
"ShsRatio": 0.0173
},
{
"Rank": 5,
"HldrName": "ＪＰモルガン証券株式会社",
"HldrAddr": "東京都千代田区丸の内２丁目７－３ 東京ビルディング",
"ShsHeld": 15316000,
"ShsRatio": 0.0148
},
{
"Rank": 6,
"HldrName": "ＪＰ ＭＯＲＧＡＮ ＣＨＡＳＥ ＢＡＮＫ ３８５７８１（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "２５ ＢＡＮＫ ＳＴＲＥＥＴ， ＣＡＮＡＲＹ ＷＨＡＲＦ， ＬＯＮＤＯＮ， Ｅ１４ ５ＪＰ， ＵＮＩＴＥＤ ＫＩＮＧＤＯＭ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 15139000,
"ShsRatio": 0.0147
},
{
"Rank": 7,
"HldrName": "株式会社三菱ＵＦＪ銀行",
"HldrAddr": "東京都千代田区丸の内１丁目４番５号",
"ShsHeld": 15114000,
"ShsRatio": 0.0146
},
{
"Rank": 8,
"HldrName": "ＳＴＡＴＥ ＳＴＲＥＥＴ ＢＡＮＫ ＡＮＤ ＴＲＵＳＴ ＣＯＭＰＡＮＹ ５０５１０３（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "ＯＮＥ ＣＯＮＧＲＥＳＳ ＳＴＲＥＥＴ， ＳＵＩＴＥ １， ＢＯＳＴＯＮ， ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 14996000,
"ShsRatio": 0.0145
},
{
"Rank": 9,
"HldrName": "ＨＳＢＣ ＨＯＮＧ ＫＯＮＧ－ＴＲＥＡＳＵＲＹ ＳＥＲＶＩＣＥＳ Ａ／Ｃ ＡＳＩＡＮ ＥＱＵＩＴＩＥＳ ＤＥＲＩＶＡＴＩＶＥＳ（常任代理人 香港上海銀行東京支店）",
"HldrAddr": "１ ＱＵＥＥＮ’Ｓ ＲＯＡＤ ＣＥＮＴＲＡＬ，ＨＯＮＧ ＫＯＮＧ（東京都中央区日本橋３丁目１１－１）",
"ShsHeld": 14484000,
"ShsRatio": 0.014
},
{
"Rank": 10,
"HldrName": "Ｊ．Ｐ． ＭＯＲＧＡＮ ＢＡＮＫ ＬＵＸＥＭＢＯＵＲＧ Ｓ．Ａ． ３８４５１３（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "ＥＵＲＯＰＥＡＮ ＢＡＮＫ ＡＮＤ ＢＵＳＩＮＥＳＳ ＣＥＮＴＥＲ ６， ＲＯＵＴＥ ＤＥ ＴＲＥＶＥＳ， Ｌ－２６３３ ＳＥＮＮＩＮＧＥＲＢＥＲＧ， ＬＵＸＥＭＢＯＵＲＧ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 14035000,
"ShsRatio": 0.0136
}
]
},
{
"DocId": "S100XBRL",
"Code": "86970",
"EdinetCode": "E03814",
"FilerName": "株式会社日本取引所グループ",
"FilerNameEn": "Japan Exchange Group, Inc.",
"DocTypeCode": "160",
"SubDate": "2025-11-14",
"SubTime": "15:00:00",
"PerSt": "2025-04-01",
"PerEn": "2026-03-31",
"CurPerSt": "2025-04-01",
"CurPerEn": "2025-09-30",
"Hldrs": [
{
"Rank": 1,
"HldrName": "日本マスタートラスト信託銀行株式会社（信託口）",
"HldrAddr": "東京都港区赤坂１丁目８番１号 赤坂インターシティＡＩＲ",
"ShsHeld": 176520000,
"ShsRatio": 0.1711
}
]
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/eq-bars-daily-am
# 前場四本値(/equities/bars/daily/am)
`GET` /v2/equities/bars/daily/am
## APIの概要
前場終了時に、前場の株価データを取得することができます。
### 本APIの留意点
> **Info**
>
> - 前場の取引高が存在しない（売買されていない）銘柄についての四本値、取引高と売買代金は、`null` が収録されています。
> - 東証上場銘柄でない銘柄（地方取引所単独上場銘柄）についてはデータの収録対象外となっております。
> - なお、当日のデータは翌日6:00頃まで取得可能です。ヒストリカルの前場四本値については
> [株価四本値(/equities/bars/daily)](https://jpx-jquants.com/ja/spec/eq-bars-daily)
> をご利用ください。
## 前場の株価データを取得します
`GET` `https://api.jquants.com/v2/equities/bars/daily/am`
データの取得では、銘柄コード（`code`）が指定できます。
### パラメータ及びレスポンス
データの取得では、銘柄コード（`code`）の指定が可能です。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓ → 指定された銘柄についての前場の株価データ
- code: – → 全上場銘柄について前場の株価データ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/equities/bars/daily/am
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/bars/daily/am \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/bars/daily/am', {
params: {
code: '{{code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/bars/daily/am",
params={"code": "{{code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | -------------- |
| Date | string | Required | 日付（YYYY-MM-DD） |
| Code | string | Required | 銘柄コード |
| MO | number | Required | 前場始値 |
| MH | number | Required | 前場高値 |
| ML | number | Required | 前場安値 |
| MC | number | Required | 前場終値 |
| MVo | number | Required | 前場売買高 |
| MVa | number | Required | 前場取引代金 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-03-20",
"Code": "39400",
"MO": 232.0,
"MH": 244.0,
"ML": 232.0,
"MC": 240.0,
"MVo": 52600.0,
"MVa": 12518800.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/eq-bars-daily/adj
# 調整済み株価の計算方法
> **Note**
>
> ファイルダウンロードで取得できる株価データには、調整済み株価の値が収録されていません。
> APIによるデータ取得ではなく、ファイルを取得する場合、提供する調整係数から調整済み株価をご自身で算出するための手順です。
調整前の株価（`O/H/L/C/Vo`）に加えて、
株式分割・併合を反映するための**調整係数** `AdjFactor` が含まれます（例：**株式分割 1:2 の場合、権利落ち日に** `AdjFactor = 0.5`）。
このページでは、APIが返す `AdjFactor` を使って **自分で調整済み株価（調整後終値など）を計算する手順**を、表計算ユーザー向けに説明します。
## 前提（ここで作る「調整済み」の意味）
- **目的**: 株式分割・株式併合・ライツイシューによる株価の段差（見かけのギャップ）をならし、時系列比較しやすくする
- **対象**: 本APIの株価調整は **株式分割・株式併合・ライツイシュー**（外株およびTOKYO PRO MARKET上場銘柄のライツイシュー、配当など一部コーポレートアクションは対象外）
## 計算の考え方
`AdjFactor` は「その日が権利落ち日（分割・併合等の効力発生日）のときに入る係数」です。
過去日付の株価を調整するには、**未来側（より新しい日付）に出てきた** `AdjFactor` **を累積（掛け算）していく**必要があります。
つまり、日付が古いほど「その後に起きた分割・併合等」の影響を多く受けるので、\*\*累積調整係数（ここでは `CumAdj`）\*\*を作ってから価格に掛けます。
## 表計算ソフトでの手順（テーブル例つき）
### 1) ダウンロードしたファイルから必要な列を準備する
最低限、次の列があれば計算できます。
- `Date`（日付）
- `C`（終値・調整前）※他の `O/H/L` も同様
- `Vo`（出来高・調整前）※出来高も調整したい場合
- `AdjFactor`（調整係数）
### 2) 日付を「新しい順（降順）」に並べ替える
**ここが一番のポイント**です。`CumAdj` を「上から下へ」計算できるように、`Date` を **降順** にします。
### 3) 累積調整係数 `CumAdj` を作る
まず表計算ソフトに、次のような表を作ります（例は分割 1:2 が途中で1回だけ起きるケース）。
| 行 | A:Date | B:C(調整前) | C:Vo(調整前) | D:AdjFactor | E:CumAdj(累積) | F:AdjC(自分で計算) | G:AdjVo(自分で計算) |
| -: | :--------- | -------: | --------: | ----------: | -----------: | ------------: | -------------: |
| 2 | 2024-01-12 | 500 | 1,200,000 | 1.0 | | | |
| 3 | 2024-01-11 | 480 | 2,400,000 | 0.5 | | | |
| 4 | 2024-01-10 | 980 | 1,100,000 | 1.0 | | | |
ここでの `CumAdj` は「**その行より新しい日付にある `AdjFactor` を全部掛け合わせた値**」にします。
（権利落ち日の `AdjFactor` は、\*\*その日より前（古い日付）\*\*に効かせたいので、**1行下（古い行）に効く**イメージです）
#### セル式（例）
- **E2（最新日）**: `1`
- **E3以降**（下へコピー）: 「1つ上（より新しい日付）の `CumAdj`」×「1つ上の `AdjFactor`」
- `E3` に入れる式: `=E2*D2`
- これを最終行までコピー
この例だと、権利落ち日 `2024-01-11` の `AdjFactor=0.5` が、1つ古い `2024-01-10` の `CumAdj` に反映され、`0.5` になります。
| 行 | A:Date | B:C(調整前) | C:Vo(調整前) | D:AdjFactor | E:CumAdj(累積) | F:AdjC(自分で計算) | G:AdjVo(自分で計算) |
| -: | :--------- | -------: | --------: | ----------: | -----------: | ------------: | -------------: |
| 2 | 2024-01-12 | 500 | 1,200,000 | 1.0 | 1.0 | | |
| 3 | 2024-01-11 | 480 | 2,400,000 | 0.5 | 1.0 | | |
| 4 | 2024-01-10 | 980 | 1,100,000 | 1.0 | 0.5 | | |
### 4) 調整済み終値（例：AdjC）を計算する
価格（`O/H/L/C`）は、**調整前価格 × CumAdj** で計算します。
- `F2`（下へコピー）:
- `=B2*E2`
| 行 | A:Date | B:C(調整前) | C:Vo(調整前) | D:AdjFactor | E:CumAdj(累積) | F:AdjC(自分で計算) | G:AdjVo(自分で計算) |
| -: | :--------- | -------: | --------: | ----------: | -----------: | ------------: | -------------: |
| 2 | 2024-01-12 | 500 | 1,200,000 | 1.0 | 1.0 | 500.00 | |
| 3 | 2024-01-11 | 480 | 2,400,000 | 0.5 | 1.0 | 480.00 | |
| 4 | 2024-01-10 | 980 | 1,100,000 | 1.0 | 0.5 | 490.00 | |
### 5) 調整済み出来高（例：AdjVo）を計算する（必要な場合）
出来高は価格と逆で、分割 1:2 の場合に過去の出来高を2倍にして連続性を持たせるため、**調整前出来高 ÷ CumAdj** で計算します。
- `G2`（下へコピー）:
- `=C2/E2`
※ `CumAdj` が 0 のケースは通常ありませんが、念のためExcelでは `=IF(E2=0,"",C2/E2)` のようにしてもOKです。
| 行 | A:Date | B:C(調整前) | C:Vo(調整前) | D:AdjFactor | E:CumAdj(累積) | F:AdjC(自分で計算) | G:AdjVo(自分で計算) |
| -: | :--------- | -------: | --------: | ----------: | -----------: | ------------: | -------------: |
| 2 | 2024-01-12 | 500 | 1,200,000 | 1.0 | 1.0 | 500.00 | 1,200,000 |
| 3 | 2024-01-11 | 480 | 2,400,000 | 0.5 | 1.0 | 480.00 | 2,400,000 |
| 4 | 2024-01-10 | 980 | 1,100,000 | 1.0 | 0.5 | 490.00 | 2,200,000 |
---
Source: https://jpx-jquants.com/ja/spec/eq-bars-daily
# 株価四本値(/equities/bars/daily)
`GET` /v2/equities/bars/daily
## APIの概要
株価データを取得することができます。\
株価は分割・併合等を考慮した調整済み株価（小数点第２位四捨五入）と調整前の株価を取得することができます。
> **Warning**
>
> **時価総額（`MktCap`）は本APIから削除予定です。**\
> 今後は[バリュエーション指標API](https://jpx-jquants.com/ja/spec/eq-valuation)の `MktCap` をご利用ください。同APIの時価総額は自己株式を控除した株式数を用いており、自己株式を含む株式数を用いる本APIの時価総額とは値が一致しない場合があります。\
> 削除の時期は決まり次第、本ページと[リリースノート](https://jpx-jquants.com/ja/spec/release)でご案内します。
### 本APIの留意点
> **Info**
>
> - 取引が存在しない日の銘柄についての四本値、取引高と売買代金は、Nullが収録されています。
> - 東証上場銘柄でない銘柄（地方取引所単独上場銘柄）についてはデータの収録対象外となっております。
> - 上場廃止銘柄についても、上場していた期間内の日付・期間を指定すれば取得可能です。
> - 2020/10/1のデータは東京証券取引所の株式売買システムの障害により終日売買停止となった関係で、四本値、取引高と売買代金はNullが収録されています。
> - 日通しデータについては全プランで取得できますが、前場/後場別のデータについてはPremiumプランのみ取得可能です。
> - Premiumプラン以外のプランでは、前場/後場別のデータ項目はNullで返却されるのではなく、キー自体がレスポンスに含まれません。
> - 株価調整については株式分割・株式併合・ライツイシューに対応しております。その他一部コーポレートアクションには対応しておりませんので、ご了承ください。
> - ライツイシューでは取引高（`Vo`/`AdjVo` 等）は調整されません。
> - 外国株（外株）および TOKYO PRO MARKET 上場銘柄のライツイシューは、株価調整の対象外です（`AdjFactor = 1`）。
## 日次の株価データを取得します
`GET` `https://api.jquants.com/v2/equities/bars/daily`
データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。
### パラメータ及びレスポンス
データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, from /to: – → 指定された銘柄について全期間分のデータ
- code: ✓, date: ✓, from /to: – → 指定された銘柄について指定された日付のデータ
- code: ✓, date: –, from /to: ✓ → 指定された銘柄について指定された期間分のデータ
- code: –, date: ✓, from /to: – → 全上場銘柄について指定された日付のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式等の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| date | string | Optional | from と to を指定しないとき（e.g. 20210907 or 2021-09-07） |
| from | string | Optional | fromの指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | to の指定（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/equities/bars/daily
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/bars/daily \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/bars/daily', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/bars/daily",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------------------------------------------- |
| Date | string | Required | 日付（YYYY-MM-DD） |
| Code | string | Required | 銘柄コード |
| O | number | Required | 始値（調整前） |
| H | number | Required | 高値（調整前） |
| L | number | Required | 安値（調整前） |
| C | number | Required | 終値（調整前） |
| UL | string | Required | 日通ストップ高フラグ（0：ストップ高以外, 1：ストップ高） |
| LL | string | Required | 日通ストップ安フラグ（0：ストップ安以外, 1：ストップ安） |
| Vo | number | Required | 取引高（調整前） |
| Va | number | Required | 取引代金 |
| AdjFactor | number | Required | 調整係数（株式分割1:2の場合、権利落ち日に 0.5 が入る。） |
| AdjO | number | Required | 調整済み始値（※1） |
| AdjH | number | Required | 調整済み高値（※1） |
| AdjL | number | Required | 調整済み安値（※1） |
| AdjC | number | Required | 調整済み終値（※1） |
| AdjVo | number | Required | 調整済み取引高（※1） |
| MO | number | Required | 前場始値（※2） |
| MH | number | Required | 前場高値（※2） |
| ML | number | Required | 前場安値（※2） |
| MC | number | Required | 前場終値（※2） |
| MUL | string | Required | 前場ストップ高フラグ（0：ストップ高以外, 1：ストップ高）,（※2） |
| MLL | string | Required | 前場ストップ安フラグ（0：ストップ安以外, 1：ストップ安）,（※2） |
| MVo | number | Required | 前場売買高（※2） |
| MVa | number | Required | 前場取引代金（※2） |
| MAdjO | number | Required | 調整済み前場始値（※1, ※2） |
| MAdjH | number | Required | 調整済み前場高値（※1, ※2） |
| MAdjL | number | Required | 調整済み前場安値（※1, ※2） |
| MAdjC | number | Required | 調整済み前場終値（※1, ※2） |
| MAdjVo | number | Required | 調整済み前場売買高（※1, ※2） |
| AO | number | Required | 後場始値（※2） |
| AH | number | Required | 後場高値（※2） |
| AL | number | Required | 後場安値（※2） |
| AC | number | Required | 後場終値（※2） |
| AUL | string | Required | 後場ストップ高フラグ（0：ストップ高以外, 1：ストップ高）,（※2） |
| ALL | string | Required | 後場ストップ安フラグ（0：ストップ安以外, 1：ストップ安）,（※2） |
| AVo | number | Required | 後場売買高（※2） |
| AVa | number | Required | 後場取引代金（※2） |
| AAdjO | number | Required | 調整済み後場始値（※1, ※2） |
| AAdjH | number | Required | 調整済み後場高値（※1, ※2） |
| AAdjL | number | Required | 調整済み後場安値（※1, ※2） |
| AAdjC | number | Required | 調整済み後場終値（※1, ※2） |
| AAdjVo | number | Required | 調整済み後場売買高（※1, ※2） |
| MktCap | number | Required | 時価総額（百万円）（※3） |
| ExRT | string | Required | 権利落種類（1：株式分割, 2：株式併合, 3：ライツイシュー。株式無償割当は「1：株式分割」に含む）（※4） |
※1 過去の分割等を考慮した調整済みの項目です\
※2 Premiumプランのみ取得可能な項目です（Premiumプラン以外のプランでは、キー自体がレスポンスに含まれません）\
※3 時価総額 ＝ 終値（調整前）× 上場株式数で算出し、百万円単位（百万円未満を四捨五入）で収録しています。\
・時価総額は、分割・併合等のコーポレートアクションにも対応しております。\
・ETF・ETN等はNullとなります。\
・取引が存在しない日はNullとなります。\
※4 権利落ち日に該当するコーポレートアクションが無い日はNullが収録されます。
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"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."
}
```
---
Source: https://jpx-jquants.com/ja/spec/eq-bars-minute
# 株価分足(/equities/bars/minute)
`GET` /v2/equities/bars/minute
## APIの概要
分足の株価データを取得することができます。\
1分単位の四本値（始値・高値・安値・終値）、出来高、売買代金のデータを提供します。
### 本APIの留意点
> **Info**
>
> - 東証上場銘柄でない銘柄（地方取引所単独上場銘柄）についてはデータの収録対象外となっております。
> - データ取得可能期間は過去2年間です。
> - 当APIは取引のティックデータを1分単位で集約したデータを提供しており、その1分間に取引が存在しない時間帯のデータは返却値に含まれません。
## 分足の株価データを取得します
`GET` `https://api.jquants.com/v2/equities/bars/minute`
データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。
### パラメータ及びレスポンス
データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, from /to: – → 指定された銘柄について全期間分のデータ
- code: ✓, date: ✓, from /to: – → 指定された銘柄について指定された日付のデータ
- code: ✓, date: –, from /to: ✓ → 指定された銘柄について指定された期間分のデータ
- code: –, date: ✓, from /to: – → 全上場銘柄について指定された日付のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式等の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| date | string | Optional | from と to を指定しないとき（e.g. 20210907 or 2021-09-07） |
| from | string | Optional | fromの指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | to の指定（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/equities/bars/minute
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/bars/minute \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/bars/minute', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/bars/minute",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | -------------- |
| Date | string | Required | 日付（YYYY-MM-DD） |
| Time | string | Required | 時刻（HH:mm） |
| Code | string | Required | 銘柄コード |
| O | number | Required | 始値 |
| H | number | Required | 高値 |
| L | number | Required | 安値 |
| C | number | Required | 終値 |
| Vo | number | Required | 出来高 |
| Va | number | Required | 売買代金 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"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."
}
```
---
Source: https://jpx-jquants.com/ja/spec/eq-earnings-cal
# 決算発表予定日（3・9月期決算会社のみ）(/equities/earnings-calendar)
`GET` /v2/equities/earnings-calendar
## APIの概要
3月期・9月期決算の会社の決算発表予定日を取得できます。（その他の決算期の会社は今後対応予定です）
## 本APIの留意点
> **Info**
>
> - 下記のサイトで、3月期・９月期決算会社分に更新があった場合のみ19時ごろに更新されます。３月期・９月期決算会社についての更新がなかった場合は、最終更新日時点のデータを提供します。\
> [https://www.jpx.co.jp/listing/event-schedules/financial-announcement/index.html](https://www.jpx.co.jp/listing/event-schedules/financial-announcement/index.html)
> - 本APIは翌営業日に決算発表が行われる銘柄に関する情報を返します。
> - 本APIから得られたデータにおいてDateの項目が翌営業日付であるレコードが存在しない場合は、3月期・9月期決算会社における翌営業日の開示予定はないことを意味します。
> - REITのデータは含まれません。
> - 全上場銘柄（REIT等を含む）の発表予定日や公表履歴が必要な場合は、[決算発表予定日](https://jpx-jquants.com/ja/spec/fin-earnings-date)APIをご利用ください。
## 決算発表予定日の銘柄コード、年度、 四半期等の照会をします。
`GET` `https://api.jquants.com/v2/equities/earnings-calendar`
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------- |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/equities/earnings-calendar
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/earnings-calendar \
-H "x-api-key: {{apiKey}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/equities/earnings-calendar")
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/earnings-calendar",
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------------------------------------------- |
| Date | string | Required | 日付（YYYY-MM-DD） 決算発表予定日が未定の場合、空文字("")となります。 |
| Code | string | Required | 銘柄コード |
| CoName | string | Required | 会社名 |
| FY | string | Required | 決算期末 |
| SectorNm | string | Required | 業種名 |
| FQ | string | Required | 決算種別 |
| Section | string | Required | 市場区分 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2022-02-14",
"Code": "43760",
"CoName": "くふうカンパニー",
"FY": "9月30日",
"SectorNm": "情報・通信業",
"FQ": "第１四半期",
"Section": "マザーズ"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/eq-investor-types
# 投資部門別情報(/equities/investor-types)
`GET` /v2/equities/investor-types
## APIの概要
投資部門別売買状況（株式・金額）のデータを取得することができます。\
配信データは下記のページで公表している内容と同一です。データの単位は千円です。\
[https://www.jpx.co.jp/markets/statistics-equities/investor-type/index.html](https://www.jpx.co.jp/markets/statistics-equities/investor-type/index.html)
### 本APIの留意点
> **Info**
>
> - 2022年4月4日に行われた市場区分見直しに伴い、市場区分に応じた内容となっている統計資料は、見直し後の市場区分に変更して掲載しています。
> - 過誤訂正により過去の投資部門別売買状況データが訂正された場合は、本APIでは以下のとおりデータを提供します。
> - 2023年4月3日以前に訂正が公表された過誤訂正：訂正前のデータは提供せず、訂正後のデータのみ提供します。
> - 2023年4月3日以降に訂正が公表された過誤訂正：訂正前と訂正後のデータのいずれも提供します。訂正が生じた場合には、市場名、開始日および終了日を同一とするレコードが追加され、公表日が新しいデータが訂正後、公表日が古いデータが訂正前のデータと識別することが可能です。
> - 過誤訂正により過去の投資部門別売買状況データが訂正された場合は、過誤訂正が公表された翌営業日にデータが更新されます。
## 投資部門別売買状況のデータを取得します
`GET` `https://api.jquants.com/v2/equities/investor-types`
データの取得では、市場（`section`）または公表日の日付（`from` / `to`）が指定できます。
### パラメータ及びレスポンス
データの取得では、セクション（`section`）または日付（`from` / `to`）の指定が可能です。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- section: ✓, from /to: ✓ → 指定したセクションの指定した期間のデータ
- section: ✓, from /to: – → 指定したセクションの全期間のデータ
- section: –, from /to: ✓ → すべてのセクションの指定した期間のデータ
- section: –, from /to: – → すべてのセクションの全期間のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------- |
| section | string | Optional | セクション（e.g. TSEPrime） 指定可能な値の一覧は[こちら](https://jpx-jquants.com/ja/spec/eq-investor-types/section)をご確認ください。 |
| from | string | Optional | fromの指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | toの指定（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/equities/investor-types
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/investor-types \
-H "x-api-key: {{apiKey}}" \
-d section="{{section}}" \
-d from="{{from}}" \
-d to="{{to}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/investor-types', {
params: {
section: '{{section}}',
from: '{{from}}',
to: '{{to}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/investor-types",
params={"section": "{{section}}", "from": "{{from}}", "to": "{{to}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ------------------------------------------------- |
| PubDate | string | Required | 公表日（YYYY-MM-DD） |
| StDate | string | Required | 開始日（YYYY-MM-DD） |
| EnDate | string | Required | 終了日（YYYY-MM-DD） |
| Section | string | Required | 市場名（[市場名](https://jpx-jquants.com/ja/spec/eq-investor-types/section)を参照） |
| PropSell | number | Required | 自己計\_売 |
| PropBuy | number | Required | 自己計\_買 |
| PropTot | number | Required | 自己計\_合計 |
| PropBal | number | Required | 自己計\_差引 |
| BrkSell | number | Required | 委託計\_売 |
| BrkBuy | number | Required | 委託計\_買 |
| BrkTot | number | Required | 委託計\_合計 |
| BrkBal | number | Required | 委託計\_差引 |
| TotSell | number | Required | 総計\_売 |
| TotBuy | number | Required | 総計\_買 |
| TotTot | number | Required | 総計\_合計 |
| TotBal | number | Required | 総計\_差引 |
| IndSell | number | Required | 個人\_売 |
| IndBuy | number | Required | 個人\_買 |
| IndTot | number | Required | 個人\_合計 |
| IndBal | number | Required | 個人\_差引 |
| FrgnSell | number | Required | 海外投資家\_売 |
| FrgnBuy | number | Required | 海外投資家\_買 |
| FrgnTot | number | Required | 海外投資家\_合計 |
| FrgnBal | number | Required | 海外投資家\_差引 |
| SecCoSell | number | Required | 証券会社\_売 |
| SecCoBuy | number | Required | 証券会社\_買 |
| SecCoTot | number | Required | 証券会社\_合計 |
| SecCoBal | number | Required | 証券会社\_差引 |
| InvTrSell | number | Required | 投資信託\_売 |
| InvTrBuy | number | Required | 投資信託\_買 |
| InvTrTot | number | Required | 投資信託\_合計 |
| InvTrBal | number | Required | 投資信託\_差引 |
| BusCoSell | number | Required | 事業法人\_売 |
| BusCoBuy | number | Required | 事業法人\_買 |
| BusCoTot | number | Required | 事業法人\_合計 |
| BusCoBal | number | Required | 事業法人\_差引 |
| OthCoSell | number | Required | その他法人\_売 |
| OthCoBuy | number | Required | その他法人\_買 |
| OthCoTot | number | Required | その他法人\_合計 |
| OthCoBal | number | Required | その他法人\_差引 |
| InsCoSell | number | Required | 生保・損保\_売 |
| InsCoBuy | number | Required | 生保・損保\_買 |
| InsCoTot | number | Required | 生保・損保\_合計 |
| InsCoBal | number | Required | 生保・損保\_差引 |
| BankSell | number | Required | 都銀・地銀等\_売 |
| BankBuy | number | Required | 都銀・地銀等\_買 |
| BankTot | number | Required | 都銀・地銀等\_合計 |
| BankBal | number | Required | 都銀・地銀等\_差引 |
| TrstBnkSell | number | Required | 信託銀行\_売 |
| TrstBnkBuy | number | Required | 信託銀行\_買 |
| TrstBnkTot | number | Required | 信託銀行\_合計 |
| TrstBnkBal | number | Required | 信託銀行\_差引 |
| OthFinSell | number | Required | その他金融機関\_売 |
| OthFinBuy | number | Required | その他金融機関\_買 |
| OthFinTot | number | Required | その他金融機関\_合計 |
| OthFinBal | number | Required | その他金融機関\_差引 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2017-01-13",
"StDate": "2017-01-04",
"EnDate": "2017-01-06",
"Section": "TSE1st",
"PropSell": 1311271004,
"PropBuy": 1453326508,
"PropTot": 2764597512,
"PropBal": 142055504,
"BrkSell": 7165529005,
"BrkBuy": 7030019854,
"BrkTot": 14195548859,
"BrkBal": -135509151,
"TotSell": 8476800009,
"TotBuy": 8483346362,
"TotTot": 16960146371,
"TotBal": 6546353,
"IndSell": 1401711615,
"IndBuy": 1161801155,
"IndTot": 2563512770,
"IndBal": -239910460,
"FrgnSell": 5094891735,
"FrgnBuy": 5317151774,
"FrgnTot": 10412043509,
"FrgnBal": 222260039,
"SecCoSell": 76381455,
"SecCoBuy": 61700100,
"SecCoTot": 138081555,
"SecCoBal": -14681355,
"InvTrSell": 168705109,
"InvTrBuy": 124389642,
"InvTrTot": 293094751,
"InvTrBal": -44315467,
"BusCoSell": 71217959,
"BusCoBuy": 63526641,
"BusCoTot": 134744600,
"BusCoBal": -7691318,
"OthCoSell": 10745152,
"OthCoBuy": 15687836,
"OthCoTot": 26432988,
"OthCoBal": 4942684,
"InsCoSell": 15926202,
"InsCoBuy": 9831555,
"InsCoTot": 25757757,
"InsCoBal": -6094647,
"BankSell": 10606789,
"BankBuy": 8843871,
"BankTot": 19450660,
"BankBal": -1762918,
"TrstBnkSell": 292932297,
"TrstBnkBuy": 245322795,
"TrstBnkTot": 538255092,
"TrstBnkBal": -47609502,
"OthFinSell": 22410692,
"OthFinBuy": 21764485,
"OthFinTot": 44175177,
"OthFinBal": -646207
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/eq-investor-types/section
# 市場名
| 項目 | 値 |
| ------- | ----------- |
| 市場一部 | TSE1st |
| 市場二部 | TSE2nd |
| マザーズ | TSEMothers |
| JASDAQ | TSEJASDAQ |
| プライム | TSEPrime |
| スタンダード | TSEStandard |
| グロース | TSEGrowth |
| 東証および名証 | TokyoNagoya |
---
Source: https://jpx-jquants.com/ja/spec/eq-master/marketcode
# 市場区分コード及び市場区分名
| コード | 名称 |
| ---- | ---------------- |
| 0101 | 東証一部 |
| 0102 | 東証二部 |
| 0104 | マザーズ |
| 0105 | TOKYO PRO MARKET |
| 0106 | JASDAQ スタンダード |
| 0107 | JASDAQ グロース |
| 0109 | その他 |
| 0111 | プライム |
| 0112 | スタンダード |
| 0113 | グロース |
---
Source: https://jpx-jquants.com/ja/spec/eq-master
# 上場銘柄一覧(/equities/master)
`GET` /v2/equities/master
## APIの概要
過去時点での銘柄情報、当日の銘柄情報および翌営業日時点の銘柄情報が取得可能です。\
ただし、翌営業日時点の銘柄情報については17 時半以降に取得可能となります。
### 本APIの留意点
> **Info**
>
> - 過去日付の指定について、Premiumプランでデータ提供開始日（2008年5月7日）より過去日付を指定した場合であっても、2008年5月7日時点の銘柄情報を返却します。
> - 指定された日付が休業日の場合は、指定日の翌営業日の銘柄情報を返却します。
> **Note**
>
> 2022年4月の東証市場区分再編により、日本銀行（銘柄コード83010）および信金中央金庫（銘柄コード84210）については、制度上所属する市場区分が存在しなくなりましたが、J-Quants では市場区分をスタンダードとして返却します。
### 上場廃止銘柄の取扱い
> **Info**
>
> - 過去の日付を `date` に指定した場合、その時点で上場していた銘柄の情報を取得できます。現在すでに上場廃止となっている銘柄も、上場していた時点の日付を指定すれば取得可能です。
> - 上場廃止後の日付を指定して `code` を直接指定した場合、レスポンスは空になります。
> - 上場日・上場廃止日の項目は提供していません。
> - 上場廃止銘柄の一覧は提供していません。
### コード変更・社名変更・市場区分変更の履歴
> **Note**
>
> 銘柄コード・社名・市場区分などの変更履歴や新旧の対応表は提供していません。日付を指定して取得した日次スナップショットの差分により、変更内容をご確認ください。
## 日次の銘柄情報を取得します
`GET` `https://api.jquants.com/v2/equities/master`
データの取得では、銘柄コード（code）または日付（date）の指定が可能です。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: –, date: – → APIを実行した日付時点における全銘柄情報一覧（※1）
- code: ✓, date: – → APIを実行した日付時点における指定された銘柄情報（※1）
- code: –, date: ✓ → 指定日付時点における全銘柄情報の一覧（※2）
- code: ✓, date: ✓ → 指定日付時点における指定された銘柄情報（※2）
※1 休業日において日付を指定せずにクエリした場合、直近の翌営業日における銘柄情報一覧を返却します。\
※2 未来日付の指定について、Light プラン以上では翌営業日時点のデータが取得可能です。翌営業日より先の未来日付を指定した場合であっても、翌営業日時点の銘柄情報を返却します。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | --------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 27890 or 2789） 4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| date | string | Optional | 基準となる日付の指定（e.g. 20210907 or 2021-09-07） |
### APIコールサンプルコード
/v2/equities/master
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/master \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/master', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/master",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------------------------------------------------------------- |
| Date | string | Required | 情報適用年月日（YYYY-MM-DD） |
| Code | string | Required | 銘柄コード |
| CoName | string | Required | 会社名 |
| CoNameEn | string | Required | 会社名（英語） |
| S17 | string | Required | 17業種コード（[17業種コード及び業種名](https://jpx-jquants.com/ja/spec/eq-master/sector17code)を参照） |
| S17Nm | string | Required | 17業種コード名（[17業種コード及び業種名](https://jpx-jquants.com/ja/spec/eq-master/sector17code)を参照） |
| S33 | string | Required | 33業種コード（[33業種コード及び業種名](https://jpx-jquants.com/ja/spec/eq-master/sector33code)を参照） |
| S33Nm | string | Required | 33業種コード名（[33業種コード及び業種名](https://jpx-jquants.com/ja/spec/eq-master/sector33code)を参照） |
| ScaleCat | string | Required | 規模コード |
| Mkt | string | Required | 市場区分コード（[市場区分コード及び市場区分](https://jpx-jquants.com/ja/spec/eq-master/marketcode)を参照） |
| MktNm | string | Required | 市場区分名（[市場区分コード及び市場区分](https://jpx-jquants.com/ja/spec/eq-master/marketcode)を参照） |
| Mrgn | string | Required | 貸借信用区分（1: 信用 / 2: 貸借 / 3: その他） |
| MrgnNm | string | Required | 貸借信用区分名 |
| ProdCat | string | Required | 商品区分コード（[商品区分コード及び商品区分名](https://jpx-jquants.com/ja/spec/eq-master/product-category)を参照） |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2022-11-11",
"Code": "86970",
"CoName": "日本取引所グループ",
"CoNameEn": "Japan Exchange Group,Inc.",
"S17": "16",
"S17Nm": "金融（除く銀行）",
"S33": "7200",
"S33Nm": "その他金融業",
"ScaleCat": "TOPIX Large70",
"Mkt": "0111",
"MktNm": "プライム",
"Mrgn": "1",
"MrgnNm": "信用",
"ProdCat": "011"
}
]
}
```
---
Source: https://jpx-jquants.com/ja/spec/eq-master/product-category
# 商品区分コード及び商品区分名
| コード | 名称 |
| --- | ------- |
| 011 | 内国株券 |
| 012 | 優先出資証券 |
| 013 | REIT |
| 014 | ETF |
| 021 | 外国株券 |
| 022 | 外国REIT |
| 023 | 外国ETF |
| 024 | 外国株預託証券 |
---
Source: https://jpx-jquants.com/ja/spec/eq-master/sector17code
# 17業種コード及び業種名
| コード | 名称 |
| --- | ------------ |
| 1 | 食品 |
| 2 | エネルギー資源 |
| 3 | 建設・資材 |
| 4 | 素材・化学 |
| 5 | 医薬品 |
| 6 | 自動車・輸送機 |
| 7 | 鉄鋼・非鉄 |
| 8 | 機械 |
| 9 | 電機・精密 |
| 10 | 情報通信・サービスその他 |
| 11 | 電気・ガス |
| 12 | 運輸・物流 |
| 13 | 商社・卸売 |
| 14 | 小売 |
| 15 | 銀行 |
| 16 | 金融（除く銀行） |
| 17 | 不動産 |
| 99 | その他 |
---
Source: https://jpx-jquants.com/ja/spec/eq-master/sector33code
# 33業種コード及び業種名
| コード | 名称 |
| ---- | ---------- |
| 0050 | 水産・農林業 |
| 1050 | 鉱業 |
| 2050 | 建設業 |
| 3050 | 食料品 |
| 3100 | 繊維製品 |
| 3150 | パルプ・紙 |
| 3200 | 化学 |
| 3250 | 医薬品 |
| 3300 | 石油･石炭製品 |
| 3350 | ゴム製品 |
| 3400 | ガラス･土石製品 |
| 3450 | 鉄鋼 |
| 3500 | 非鉄金属 |
| 3550 | 金属製品 |
| 3600 | 機械 |
| 3650 | 電気機器 |
| 3700 | 輸送用機器 |
| 3750 | 精密機器 |
| 3800 | その他製品 |
| 4050 | 電気･ガス業 |
| 5050 | 陸運業 |
| 5100 | 海運業 |
| 5150 | 空運業 |
| 5200 | 倉庫･運輸関連業 |
| 5250 | 情報･通信業 |
| 6050 | 卸売業 |
| 6100 | 小売業 |
| 7050 | 銀行業 |
| 7100 | 証券･商品先物取引業 |
| 7150 | 保険業 |
| 7200 | その他金融業 |
| 8050 | 不動産業 |
| 9050 | サービス業 |
| 9999 | その他 |
---
Source: https://jpx-jquants.com/ja/spec/eq-trades
# 株価ティック(/equities/trades)
## データの概要
ティックごとの約定データをCSV形式で提供します。\
個別の取引（約定）の価格、出来高、タイムスタンプなどの詳細なデータを取得できます。
> **Note**
>
> 本データはCSV形式でのみ提供しており、API経由での取得はできません。\
> CSV形式でのダウンロードは[ダウンロード可能ファイル一覧API](https://jpx-jquants.com/ja/spec/bulk-list)および[ファイルダウンロード用URL取得API](https://jpx-jquants.com/ja/spec/bulk-get)をご利用ください。サインイン後の[Downloadページ](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/trades)からも取得いただけます。
### 本データの留意点
> **Info**
>
> - 東証上場銘柄でない銘柄（地方取引所単独上場銘柄）についてはデータの収録対象外となっております。
> - データ取得可能期間は過去2年間です。
## データ項目
| Parameter | Type | Required | Description |
| ------------------ | ------ | -------- | --------------------- |
| Date | string | Required | 日付（YYYY-MM-DD） |
| Code | string | Required | 銘柄コード |
| Time | string | Required | 約定時刻（HH:MM:SS.ffffff） |
| SessionDistinction | string | Required | 取引区分（01: 前場, 02: 後場） |
| Price | number | Required | 約定価格（円） |
| TradingVolume | number | Required | 約定数量（株） |
| TransactionId | string | Required | トランザクションID（各約定を一意に識別） |
## データサンプル
```csv
Date,Code,Time,SessionDistinction,Price,TradingVolume,TransactionId
2025-12-01,13010,09:00:00.067558,01,4810,2200,000000000021
2025-12-01,13010,09:00:01.039337,01,4810,100,000000000036
2025-12-01,13010,09:00:01.049791,01,4810,4500,000000000038
```
---
Source: https://jpx-jquants.com/ja/spec/eq-valuation/calc
# 指標の算出方法
[バリュエーション指標API](https://jpx-jquants.com/ja/spec/eq-valuation)で提供する各指標の定義と算出の考え方を説明します。\
各指標は、決算短信等の開示内容と株価をもとに当社が算出した値です。
> **Info**
>
> - 本ページは、各指標の基本的な**考え方**を示すものです。株式数の取り扱いや決算期変更時の処理など、詳細な算出仕様は公開していません。
> - 各指標は投資判断の参考情報として提供するものであり、特定の銘柄の売買を推奨するものではありません。
## 算出の前提
### TTM純利益（実績値の算出に用いる利益）
EPS、ROEおよびPERの実績値は、直近12ヶ月（TTM：Trailing Twelve Months）の純利益をもとに算出します。\
本ページでは、この直近12ヶ月の純利益の合計を **TTM純利益** と呼びます。\
通期決算のみを用いる場合と比べ、四半期開示を反映することで、より直近の業績を捉えやすくなります。
### 会社予想純利益（予想値の算出に用いる利益）
名称に `Fwd` を含む項目（FwdEPS、FwdROEおよびFwdPER）は、進行期について会社が公表した予想純利益をもとに算出します。
### 株価（当日の終値）
PER、FwdPER、PBRおよび時価総額の算出には、当日の終値を用います。\
売買が成立しなかった日は、その日に適用される基準値段を用います。
## 各指標の定義
### EPS — 1株当たり利益（実績）
赤字の場合は、1株当たり損失を示す負の値をそのまま収録します。
```
EPS = TTM純利益 / 株式数
```
### FwdEPS — 1株当たり利益（予想）
会社予想が公表されていない、または予想が取り下げられている場合はNullとなります。\
赤字予想の場合は、1株当たり損失を示す負の値をそのまま収録します。
```
FwdEPS = 会社予想純利益 / 株式数
```
### BPS — 1株当たり純資産
自己資本が負の場合は、1株当たり純資産を示す負の値をそのまま収録します。
```
BPS = 直近四半期末の自己資本 / 株式数
```
### ROE — 自己資本利益率（実績）
分母となるTTM期間の期首および期末の自己資本の平均が0以下の場合はNullとなります。\
分子が負（赤字）の場合は、負の値をそのまま収録します。
```
ROE = TTM純利益 / TTM期間の期首および期末の自己資本の平均
```
### FwdROE — 自己資本利益率（予想）
会社予想が公表されていない、または予想が取り下げられている場合はNullとなります。\
分母となる自己資本が0以下の場合もNullとなります。
```
FwdROE = 会社予想純利益 / 直近四半期末の自己資本
```
### PER — 株価収益率（実績）
EPSが0以下の場合はNullとなります。
```
PER = 株価 / EPS
```
### FwdPER — 株価収益率（予想）
会社予想が公表されていない、または予想が取り下げられている場合はNullとなります。\
FwdEPSが0以下の場合もNullとなります。
```
FwdPER = 株価 / FwdEPS
```
### PBR — 株価純資産倍率
BPSが0以下の場合はNullとなります。
```
PBR = 株価 / BPS
```
### 時価総額（MktCap）
時価総額の算出には、自己株式を控除した株式数を用います。このため、発行済株式数ベースや浮動株ベースの時価総額とは定義が異なります。
```
時価総額（百万円） = (株価 × 株式数) / 1,000,000
```
## 値がNullとなる場合
以下のいずれかに該当する場合、該当する項目にNullが収録されます。
- 算出に必要なデータが揃っていない場合（データ提供の開始当初、上場後間もない銘柄、決算期変更の移行期など）
- 会社予想が公表されていない、または予想が取り下げられている場合（名称に `Fwd` を含む項目のみ）
- 指標の算出対象外の銘柄である場合（ETF、ETN、優先出資証券など）。この場合もデータ行は返却されますが、すべての指標がNullとなります。
時価総額については指標の算出対象かどうかを判定しないため、他の指標がNullとなる銘柄（優先出資証券、REITなど）でも値が収録される場合があります。一方、株式数は決算短信の開示内容をもとに算出するため、ETF、ETN等や、新規上場後、最初の決算短信が開示される前の銘柄についてはNullとなります。
収録開始当初（おおむね2008年から2010年頃）は、算出に用いる株式数や財務情報が十分に揃っていないため、Nullとなる銘柄や項目が多くなります。
上記のほか、算出に必要なデータが揃っていても、比率としての意味が成立しない場合（赤字の場合や自己資本が0以下の場合など）はNullとなります。各指標の条件については、[各指標の定義](#各指標の定義)をご覧ください。
## 他サービス等が提供する値との差異について
同じ名称の指標であっても、算出に用いる株式数の定義、対象とする開示の範囲、端数処理などの違いにより、他の情報源や他サービスが提供する値と一致しないことがあります。\
本APIの値は、上記の考え方に基づき当社が算出しています。本APIの値をご利用の際は、上記の算出方針をご確認ください。
---
Source: https://jpx-jquants.com/ja/spec/eq-valuation
# バリュエーション指標(/equities/valuation)
`GET` /v2/equities/valuation
## APIの概要
決算短信の開示内容と株価から算出した、日次のバリュエーション指標と時価総額を取得できます。\
実績値は直近12ヶ月（TTM：Trailing Twelve Months）の純利益をもとに、予想値は進行期の予想純利益をもとに算出します。
### 本APIの留意点
> **Info**
>
> - 決算短信の開示内容は、開示時刻にかかわらず、原則として翌営業日のデータから反映されます。日次の更新時刻については、[提供データの更新タイミング](https://jpx-jquants.com/ja/spec/data-update)をご確認ください。
> - 株価には当日の終値を用います。売買が成立しなかった日は、その日に適用される基準値段を用いて算出します。
> - ROEおよびFwdROEは小数で収録しています（例：`0.2310`は23.1%を表します）。
> - 算出に必要なデータが揃わない場合は、該当項目にNullが収録されます（上場後間もない銘柄、決算期変更の移行期など）。算出に用いる株式数や財務情報が揃っていない収録開始当初（2008年から2010年頃）は、Nullとなる銘柄や項目が多くなります。
> - ETF、ETN、優先出資証券など算出対象外の銘柄についてもデータ行は返却されますが、すべての指標がNullとなります。時価総額は、他の指標の算出対象外である銘柄についても算出する場合があります。そのため、優先出資証券、REIT等では、すべての指標がNullでも時価総額に値が入る場合があります。ETF、ETN等は、決算短信の開示がなく株式数を算出できないため、時価総額もNullとなります。
> - REIT等への指標の対応は今後を予定しています（時価総額は現時点でも収録しています）。
> - 各指標の定義、実績値と予想値の違い、および値がNullとなる条件については、[指標の算出方法](https://jpx-jquants.com/ja/spec/eq-valuation/calc)をご覧ください。
## 日次のバリュエーション指標データを取得します
`GET` `https://api.jquants.com/v2/equities/valuation`
データの取得では、銘柄コード（`code`）または日付（`date`）の指定が必須です。\
各パラメータの組み合わせとレスポンスの結果は以下のとおりです。
- code: ✓, date: –, from /to: – → 指定された銘柄について全期間分のデータ
- code: ✓, date: ✓, from /to: – → 指定された銘柄について指定された日付のデータ
- code: ✓, date: –, from /to: ✓ → 指定された銘柄について指定された期間分のデータ
- code: –, date: ✓, from /to: – → 全上場銘柄について指定された日付のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（例：`27800`または`2780`） 4桁の銘柄コードを指定した場合、普通株式と優先株式等の両方が上場している銘柄については、普通株式のデータのみが取得されます。 |
| date | string | Optional | 日付。`from`と`to`を指定しないときに使用します（例：`20260826`または`2026-08-26`）。 |
| from | string | Optional | `from`の指定（例：`20260801`または`2026-08-01`） |
| to | string | Optional | `to`の指定（例：`20260826`または`2026-08-26`） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/equities/valuation
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/valuation \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/valuation', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/valuation",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | --------------------- |
| Date | string | Required | 日付（YYYY-MM-DD） |
| Code | string | Required | 銘柄コード（5桁） |
| EPS | number | Required | 1株当たり利益（実績・円）（※1、※4） |
| FwdEPS | number | Required | 1株当たり利益（予想・円）（※2、※4） |
| BPS | number | Required | 1株当たり純資産（円）（※4、※6） |
| ROE | number | Required | 自己資本利益率（実績・小数）（※1、※5） |
| FwdROE | number | Required | 自己資本利益率（予想・小数）（※2、※5） |
| PER | number | Required | 株価収益率（実績・倍）（※3、※4） |
| FwdPER | number | Required | 株価収益率（予想・倍）（※3、※4） |
| PBR | number | Required | 株価純資産倍率（倍）（※3、※4） |
| MktCap | number | Required | 時価総額（百万円）（※3、※7） |
※1 直近12ヶ月（TTM）の純利益をもとに算出した実績値です。ROEの分母には、TTM期間の期首および期末の自己資本の平均を用います。\
※2 進行期の予想純利益をもとに算出した予想値です。FwdROEの分母には、直近の決算短信等で開示された期末自己資本を用います。\
※3 株価には当日の終値を用います。売買が成立しなかった日は、その日に適用される基準値段を用います。\
※4 小数第3位を四捨五入した値を収録します。JSONのnumber型で返却されるため、末尾のゼロは省略される場合があります。\
※5 小数第5位を四捨五入した値を収録します。パーセントではなく小数である点にご注意ください（例：`0.2310`は23.1%を表します）。JSONのnumber型で返却されるため、末尾のゼロは省略される場合があります。\
※6 直近の決算短信等で開示された期末自己資本をもとに算出した値です。\
※7 株価（※3）×株式数で算出し、百万円単位（百万円未満を四捨五入）で収録します。株式分割・併合等のコーポレートアクションにも対応しています。\
・株式数には、自己株式を控除した株式数を用います。発行済株式数ベースや浮動株ベースの時価総額とは定義が異なります。\
・株価四本値APIの時価総額（`MktCap`）は、自己株式を含む株式数と終値を用いて算出するため、本項目とは算出に用いる株式数の定義が異なり、値が一致しない場合があります。自己株式を保有する銘柄では、原則として、本項目の値が自己株式相当分だけ小さくなります。株価四本値APIの時価総額は削除予定のため、今後は本項目をご利用ください。\
・株式数は決算短信の開示をもとに算出するため、ETF、ETN等や、新規上場後、最初の決算短信が開示される前の銘柄についてはNullとなります。
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-03-24",
"Code": "86970",
"EPS": 89.4,
"FwdEPS": 87.9,
"BPS": 590.65,
"ROE": 0.1534,
"FwdROE": 0.1488,
"PER": 22.88,
"FwdPER": 23.26,
"PBR": 3.46,
"MktCap": 1077137.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/fin-details
# 財務諸表(BS/PL/CF)(/fins/details)
`GET` /v2/fins/details
## APIの概要
上場企業の四半期毎の財務情報における、貸借対照表、損益計算書、キャッシュ・フロー計算書に記載の項目を取得することができます。
## 本APIの留意点
> **Info**
>
> - FinancialStatement（財務諸表の各種項目）について
> - EDINET XBRLタクソノミ本体（label情報）を用いてコンテンツを作成しています。
> - FinancialStatementに含まれる冗長ラベル（英語）については、下記サイトよりご確認ください。\
>
> [https://disclosure2dl.edinet-fsa.go.jp/guide/static/disclosure/WZEK0110.html](https://disclosure2dl.edinet-fsa.go.jp/guide/static/disclosure/WZEK0110.html) \
>
> 年度別に公表されているEDINETタクソノミページに、「勘定科目リスト」（会計基準：日本基準）及び「国際会計基準タクソノミ要素リスト」（会計基準：IFRS） が掲載されています。会計基準別に以下のとおりデータを提供しています。
> - 会計基準が日本基準の場合、「勘定科目リスト」の各シートのE列「冗長ラベル（英語）」をキーとし、その値とセットで提供しています。
> - 会計基準がIFRSの場合、「国際会計基準タクソノミ要素リスト」の各シートのD列「冗長ラベル（英語）」をキーとし、その値とセットで提供しています。
> - 提出者別タクソノミについて
> - EDINETタクソノミには存在しない提出者別タクソノミで定義される企業独自の項目は、本APIの提供対象外となります。
> **Note**
>
> - 三井海洋開発（銘柄コード62690）は、2022年2月以降の決算短信の連結財務諸表及び連結財務諸表注記を米ドルにより表示されています。そのため、本サービスの当該銘柄の対象の財務諸表情報についても米ドルでの提供となります。
> **Info**
>
> 本APIには[個別のレートリミット](https://jpx-jquants.com/ja/spec/rate-limits#エンドポイントごとのレートリミット)が適用されます。過去データの一括取得など効率的なデータ取得については[ベストプラクティス](https://jpx-jquants.com/ja/spec/rate-limits#ベストプラクティス)をご参照ください。
## 四半期の財務諸表情報を取得することができます
`GET` `https://api.jquants.com/v2/fins/details`
銘柄コード（code）または日付（date）の指定が必須となります。
### パラメータ及びレスポンス
銘柄コード（code）または日付（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, cursor: – → 指定された銘柄について全期間分の財務諸表データ
- code: ✓, date: ✓, cursor: – → 指定された銘柄について指定された日付の財務諸表データ
- code: –, date: ✓, cursor: – → 全上場銘柄について指定された日付の財務諸表データ
- code: –, date: ✓, cursor: ✓ → 前回リクエスト以降の財務諸表データを取得
### cursorを使った財務諸表の取得
cursorを使った差分取得の仕様については、[cursorを使った差分取得](https://jpx-jquants.com/ja/spec/cursor)をご参照ください。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 86970 or 8697） 4桁もしくは5桁の銘柄コード |
| date | string | Optional | 開示日付の指定（e.g. 2022-01-05 or 20220105） |
| cursor | string | Optional | 差分取得のカーソル 前回のレスポンスで返却された cursor を指定することで前回のリクエスト以降に配信されたデータを取得できます。pagination\_key と同時指定不可。 詳細は[cursorを使った差分取得](https://jpx-jquants.com/ja/spec/cursor)をご参照ください。 |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/fins/details
**cURL**
```bash
curl -G https://api.jquants.com/v2/fins/details \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/fins/details', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/fins/details",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------ |
| DiscDate | string | Required | 開示日 |
| DiscTime | string | Required | 開示時刻 |
| Code | string | Required | 銘柄コード（5桁） |
| DiscNo | string | Required | 開示番号 APIから出力されるjsonは開示番号で昇順に並んでいます。 |
| DocType | string | Required | 開示書類種別 [開示書類種別一覧](https://jpx-jquants.com/ja/spec/fin-summary/typeofdocument) |
| FS | object | Required | 財務諸表の各種項目 冗長ラベル（英語）をキーとし、その値（財務諸表の値）をバリューとして格納したデータです。 XBRLタグと紐づく冗長ラベル（英語）とその値が収録されます。 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"DiscDate": "2020-04-30",
"DiscTime": "12:00:00",
"Code": "86970",
"DiscNo": "20200429402226",
"DocType": "FYFinancialStatements_Consolidated_IFRS",
"FS": {
"EDINET code, DEI": "E03814",
"Security code, DEI": "86970",
"Filer name in Japanese, DEI": "株式会社日本取引所グループ",
"Filer name in English, DEI": "Japan Exchange Group, Inc.",
"Document type, DEI": "通期第３号参考様式 [IFRS]（連結）",
"Accounting standards, DEI": "IFRS",
"Whether consolidated financial statements are prepared, DEI": "true",
"Industry code when consolidated financial statements are prepared in accordance with industry specific regulations, DEI": "CTE",
"Industry code when financial statements are prepared in accordance with industry specific regulations, DEI": "CTE",
"Current fiscal year start date, DEI": "2019-04-01",
"Current period end date, DEI": "2020-03-31",
"Type of current period, DEI": "FY",
"Current fiscal year end date, DEI": "2020-03-31",
"Previous fiscal year start date, DEI": "2018-04-01",
"Comparative period end date, DEI": "2019-03-31",
"Previous fiscal year end date, DEI": "2019-03-31",
"Amendment flag, DEI": "false",
"Report amendment flag, DEI": "false",
"XBRL amendment flag, DEI": "false",
"Cash and cash equivalents (IFRS)": "71883000000",
"Trade and other receivables - CA (IFRS)": "16686000000",
"Income taxes receivable - CA (IFRS)": "5922000000",
"Other financial assets - CA (IFRS)": "117400000000",
"Other current assets - CA (IFRS)": "1837000000",
"Current assets (IFRS)": "67093263000000",
"Property, plant and equipment (IFRS)": "14798000000",
"Goodwill (IFRS)": "67374000000",
"Intangible assets (IFRS)": "35045000000",
"Retirement benefit asset - NCA (IFRS)": "5642000000",
"Investments accounted for using equity method (IFRS)": "14703000000",
"Other financial assets - NCA (IFRS)": "18156000000",
"Other non-current assets - NCA (IFRS)": "6049000000",
"Deferred tax assets (IFRS)": "3321000000",
"Non-current assets (IFRS)": "193039000000",
"Assets (IFRS)": "67286302000000",
"Trade and other payables - CL (IFRS)": "6643000000",
"Bonds and borrowings - CL (IFRS)": "32500000000",
"Income taxes payable - CL (IFRS)": "10289000000",
"Other current liabilities - CL (IFRS)": "10062000000",
"Current liabilities (IFRS)": "66947278000000",
"Bonds and borrowings - NCL (IFRS)": "19953000000",
"Retirement benefit liability - NCL (IFRS)": "8866000000",
"Other non-current liabilities - NCL (IFRS)": "2162000000",
"Deferred tax liabilities (IFRS)": "2665000000",
"Non-current liabilities (IFRS)": "33648000000",
"Liabilities (IFRS)": "66980926000000",
"Share capital (IFRS)": "11500000000",
"Capital surplus (IFRS)": "39716000000",
"Treasury shares (IFRS)": "-1548000000",
"Other components of equity (IFRS)": "5602000000",
"Retained earnings (IFRS)": "242958000000",
"Equity attributable to owners of parent (IFRS)": "298228000000",
"Non-controlling interests (IFRS)": "7146000000",
"Equity (IFRS)": "305375000000",
"Liabilities and equity (IFRS)": "67286302000000",
"Number of submission, DEI": "1",
"Profit (loss) before tax from continuing operations (IFRS)": "69095000000.0",
"Depreciation and amortization - OpeCF (IFRS)": "16499000000",
"Finance income - OpeCF (IFRS)": "-665000000",
"Finance costs - OpeCF (IFRS)": "96000000",
"Share of loss (profit) of investments accounted for using equity method - OpeCF (IFRS)": "-2457000000",
"Decrease (increase) in trade and other receivables - OpeCF (IFRS)": "-5246000000",
"Increase (decrease) in trade and other payables - OpeCF (IFRS)": "420000000",
"Decrease (increase) in retirement benefit asset - OpeCF (IFRS)": "230000000",
"Increase (decrease) in retirement benefit liability - OpeCF (IFRS)": "12000000",
"Other, Changes in working capital - OpeCF (IFRS)": "-424000000",
"Subtotal - OpeCF (IFRS)": "77560000000",
"Interest and dividends received - OpeCF (IFRS)": "899000000",
"Interest paid - OpeCF (IFRS)": "-96000000",
"Income taxes refund (paid) - OpeCF (IFRS)": "-21482000000",
"Net cash provided by (used in) operating activities (IFRS)": "56881000000",
"Payments into time deposits - InvCF (IFRS)": "-117400000000",
"Proceeds from withdrawal of time deposits - InvCF (IFRS)": "113100000000",
"Purchase of property, plant and equipment - InvCF (IFRS)": "-1199000000",
"Purchase of intangible assets - InvCF (IFRS)": "-12379000000",
"Proceeds from sale of investment securities - InvCF (IFRS)": "11585000000",
"Payments for acquisition of subsidiaries - InvCF (IFRS)": "-3165000000",
"Other - InvCF (IFRS)": "23000000",
"Net cash provided by (used in) investing activities (IFRS)": "-9434000000",
"Repayments of lease liabilities - FinCF (IFRS)": "-3125000000",
"Dividends paid - FinCF (IFRS)": "-35935000000",
"Purchase of treasury shares - FinCF (IFRS)": "-350000000",
"Net cash provided by (used in) financing activities (IFRS)": "-39411000000",
"Net increase (decrease) in cash and cash equivalents before effect of exchange rate changes (IFRS)": "8035000000",
"Effect of exchange rate changes on cash and cash equivalents (IFRS)": "-43000000",
"Other income (IFRS)": "975000000.0",
"Revenue - 2 (IFRS)": "124663000000.0",
"Operating expenses (IFRS)": "58532000000.0",
"Other expenses (IFRS)": "54000000.0",
"Share of profit (loss) of investments accounted for using equity method (IFRS)": "2457000000.0",
"Operating profit (loss) (IFRS)": "68533000000.0",
"Finance income (IFRS)": "665000000.0",
"Finance costs (IFRS)": "103000000.0",
"Income tax expense (IFRS)": "20781000000.0",
"Profit (loss) (IFRS)": "48314000000.0",
"Profit (loss) attributable to owners of parent (IFRS)": "47609000000.0",
"Profit (loss) attributable to non-controlling interests (IFRS)": "705000000.0",
"Basic earnings (loss) per share (IFRS)": "88.91"
}
}
],
"cursor": "eyJkIjoiMjAyNS0wNC0wMSIsInQiOiIyMDI1LTA0LTAxVDA4OjAwOjAwWiMyMDI1MDQwMTEzMDEwMCJ9"
}
```
---
Source: https://jpx-jquants.com/ja/spec/fin-dividend
# 配当金情報(/fins/dividend)
`GET` /v2/fins/dividend
## APIの概要
上場会社の配当（決定・予想）に関する１株当たり配当金額、基準日、権利落日及び支払開始予定日等の情報を取得できます。
## 本APIの留意点
> **Info**
>
> - 東証上場銘柄でない銘柄（地方取引所単独上場銘柄）についてはデータの収録対象外となっております。
## 配当金データを取得します
`GET` `https://api.jquants.com/v2/fins/dividend`
データの取得では、銘柄コード（code）または通知日付（date）の指定が必須となります。
### パラメータ及びレスポンス
データの取得では、銘柄コード（code）または通知日付（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, from /to: – → 指定された銘柄について取得可能期間の全データ
- code: ✓, date: ✓, from /to: – → 指定された銘柄について指定された通知日付のデータ
- code: ✓, date: –, from /to: ✓ → 指定された銘柄について指定された期間分のデータ
- code: –, date: ✓, from /to: – → 全上場銘柄について指定された通知日付のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード （e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| from | string | Optional | fromの指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | toの指定（e.g. 20210907 or 2021-09-07） |
| date | string | Optional | \*fromとtoを指定しないとき（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/fins/dividend
**cURL**
```bash
curl -G https://api.jquants.com/v2/fins/dividend \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/fins/dividend", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/fins/dividend",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ---------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| PubDate | string | Required | 通知日時（YYYY-MM-DD） |
| PubTime | string | Required | 通知日時（HH:MM） |
| Code | string | Required | 銘柄コード |
| RefNo | string | Required | リファレンスナンバー 配当通知を一意に特定するための番号 詳細は[リファレンスナンバー](https://jpx-jquants.com/ja/spec/fin-dividend/reference-number)を参照 |
| StatCode | string | Required | 更新区分（コード） 1: 新規、2: 訂正、3: 削除 |
| BoardDate | string | Required | 取締役会決議日 |
| IFCode | string | Required | 配当種類（コード） 1: 中間配当、2: 期末配当 |
| FRCode | string | Required | 予想／決定（コード） 1: 決定、2: 予想 |
| IFTerm | string | Required | 配当基準日年月 |
| DivRate | number / string | Required | １株当たり配当金額 未定の場合: - 、非設定の場合: 空文字 |
| RecDate | string | Required | 基準日 |
| ExDate | string | Required | 権利落日 |
| ActRecDate | string | Required | 権利確定日 |
| PayDate | string | Required | 支払開始予定日 未定の場合: - 、非設定の場合: 空文字 |
| CARefNo | string | Required | ＣＡリファレンスナンバー 訂正・削除の対象となっている配当通知のリファレンスナンバー。新規の場合はリファレンスナンバーと同じ値を設定 詳細は[リファレンスナンバー](https://jpx-jquants.com/ja/spec/fin-dividend/reference-number)を参照 |
| DistAmt | number / string | Required | 1株当たりの交付金銭等の額 未定の場合: - 、非設定の場合: 空文字 が設定されます。 2014年2月24日以降のみ提供。 |
| RetEarn | number / string | Required | 1株当たりの利益剰余金の額 未定の場合: - 、非設定の場合: 空文字 が設定されます。 2014年2月24日以降のみ提供。 |
| DeemDiv | number / string | Required | 1株当たりのみなし配当の額 未定の場合: - 、非設定の場合: 空文字 が設定されます。 2014年2月24日以降のみ提供。 |
| DeemCapGains | number / string | Required | 1株当たりのみなし譲渡収入の額 未定の場合: - 、非設定の場合: 空文字 が設定されます。 2014年2月24日以降のみ提供。 |
| NetAssetDecRatio | number / string | Required | 純資産減少割合 未定の場合: - 、非設定の場合: 空文字 が設定されます。 2014年2月24日以降のみ提供。 |
| CommSpecCode | string | Required | 記念配当/特別配当コード 1: 記念配当、2: 特別配当、3: 記念・特別配当、0: 通常の配当 |
| CommDivRate | number / string | Required | １株当たり記念配当金額 未定の場合: - 、非設定の場合: 空文字 2022年6月6日以降のみ提供。 |
| SpecDivRate | number / string | Required | １株当たり特別配当金額 未定の場合: - 、非設定の場合: 空文字 2022年6月6日以降のみ提供。 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2014-02-24",
"PubTime": "09:21",
"Code": "15550",
"RefNo": "201402241B00002",
"StatCode": "1",
"BoardDate": "2014-02-24",
"IFCode": "2",
"FRCode": "2",
"IFTerm": "2014-03",
"DivRate": "-",
"RecDate": "2014-03-10",
"ExDate": "2014-03-06",
"ActRecDate": "2014-03-10",
"PayDate": "-",
"CARefNo": "201402241B00002",
"DistAmt": "",
"RetEarn": "",
"DeemDiv": "",
"DeemCapGains": "",
"NetAssetDecRatio": "",
"CommSpecCode": "0",
"CommDivRate": "",
"SpecDivRate": ""
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/fin-dividend/reference-number
# リファレンスナンバー
## リファレンスナンバーについて
- リファレンスナンバー：配当通知を一意に特定するための番号。
- CAリファレンスナンバー：訂正・削除の対象となっている配当通知のリファレンスナンバー。新規の場合はリファレンスナンバーと同じ値。
## 具体例：以下の通知があった場合に、提供データは下表のとおりになります。
- 銘柄：日本取引所グループ（銘柄コード：86970）について
- 2023-03-06 配当が新規で通知
- 2023-03-07 配当が訂正情報として通知
- 2023-03-08 配当が削除された
- 2023-03-09 配当が新規で通知
| PubDate | Code | RefNo | CARefNo | StatCode |
| ---------- | ----- | ----- | ------- | -------- |
| 2023-03-06 | 86970 | 1 | 1 | 1：新規 |
| 2023-03-07 | 86970 | 2 | 1 | 2：訂正 |
| 2023-03-08 | 86970 | 3 | 1 | 3：削除 |
| 2023-03-09 | 86970 | 4 | 4 | 1：新規 |
> **Note**
>
> - 一部項目のみを抽出して例示しています。
> - 上記のコード値は例示のため便宜的な記載としており、また実際に発生したデータとは異なります。
---
Source: https://jpx-jquants.com/ja/spec/fin-earnings-date
# 決算発表予定日(/fins/earnings-date)
`GET` /v2/fins/earnings-date
## APIの概要
東証上場会社等が東証に対して報告した決算発表予定日を取得できます。\
決算期によらず、報告を行った全上場銘柄（REIT等を含む）が対象で、予定日の変更・未定の履歴も含めて公表日単位で提供します。
### 本APIの留意点
> **Info**
>
> - 決算発表予定日の変更が報告された場合、以前のデータは削除されず、修正後の予定日が新たなデータとして追加されます（`code` 指定時は変更履歴を含む全レコードが返却されます）。
> - 一度公表された決算発表予定日が後から「未定」に変更された場合、SchDate は空文字（`""`）となります。
> - `scheduled_date` を指定した場合、各銘柄・各決算区分（1Q/2Q/3Q/FY）で最後に公表されたレコードのみがヒットします。そのため、予定日がその後変更された場合、変更前の予定日ではヒットしません。
> - プランごとの参照可能期間は、公表日（`PubDate`）を基準に適用されます。`date` 指定時は参照範囲外の日付を指定すると 400 エラーとなります。また、`code` / `scheduled_date` 指定時は参照範囲外の公表日のデータが結果に含まれません。
## 決算発表予定日データを取得します
`GET` `https://api.jquants.com/v2/fins/earnings-date`
データの取得では、`code`（銘柄コード）・`date`（公表日）・`scheduled_date`（発表予定日）の**いずれか1つ**の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, scheduled\_date: – → 指定された銘柄の予定日公表履歴
- code: –, date: ✓, scheduled\_date: – → 指定日に公表・変更された全銘柄の予定日データ
- code: –, date: –, scheduled\_date: ✓ → 指定日を現在有効な発表予定日とする全銘柄のデータ
※ 2つ以上のパラメータを同時に指定することはできません（400 エラー）。\
※ 該当データが存在しない場合は空配列（`"data": []`）を返却します。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 86970 or 8697） |
| date | string | Optional | 公表日（e.g. 20250620 or 2025-06-20） |
| scheduled\_date | string | Optional | 決算発表予定日（e.g. 20250805 or 2025-08-05） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/fins/earnings-date
**cURL**
```bash
curl -G https://api.jquants.com/v2/fins/earnings-date \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/fins/earnings-date', {
params: {
code: '{{code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/fins/earnings-date",
params={"code": "{{code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------------------------------- |
| PubDate | string | Required | 公表日（YYYY-MM-DD） この予定日が公表・変更された日 |
| SchDate | string | Required | 決算発表予定日（YYYY-MM-DD） 未定の場合は空文字（`""`） |
| FQName | string | Required | 決算区分（1Q / 2Q / 3Q / FY） |
| FYE | string | Required | 決算期末（MMDD） |
| Code | string | Required | 銘柄コード（5桁） |
| CoName | string | Required | 会社名 |
| CoNameEn | string | Required | 会社名（英語） |
※ 会社名（CoName・CoNameEn）は PubDate 時点のデータです。
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2025-06-03",
"SchDate": "2025-07-30",
"FQName": "1Q",
"FYE": "0331",
"Code": "86970",
"CoName": "日本取引所グループ",
"CoNameEn": "Japan Exchange Group,Inc."
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/fin-summary
# 財務情報(/fins/summary)
`GET` /v2/fins/summary
## APIの概要
財務情報の開示日・銘柄コードを指定して、決算短信などの財務情報サマリーを取得できます。\
銘柄コード（code）または日付（date）のいずれか一方、もしくは両方の指定が必要です。
## 本APIの留意点
> **Info**
>
> - **会計基準について：** APIから出力される各項目名は日本基準（JGAAP）の開示項目が基準となっています。そのため、IFRSや米国基準（USGAAP）の開示データにおいては、経常利益の概念がありませんので、データが空欄となっています。
> **Info**
>
> - **四半期開示見直し対応に伴うAPI項目の追加について：**
> - 四半期開示見直し対応において、決算短信サマリー様式の記載事項が以下のとおり変更されます。
> - **変更前：** 重要な⼦会社の異動（連結範囲の変更を伴う特定⼦会社の異動）
> - **変更後：** 連結範囲の重要な変更
> - この対応に伴い、2024/7/22より本APIのレスポンス項目に"SignificantChangesInTheScopeOfConsolidation"（期中における連結範囲の重要な変更）を追加いたします。
> - 詳細は、データ項目概要欄をご覧ください。
> **Info**
>
> 本APIには[個別のレートリミット](https://jpx-jquants.com/ja/spec/rate-limits#エンドポイントごとのレートリミット)が適用されます。過去データの一括取得など効率的なデータ取得については[ベストプラクティス](https://jpx-jquants.com/ja/spec/rate-limits#ベストプラクティス)をご参照ください。
## 財務情報データを取得します
`GET` `https://api.jquants.com/v2/fins/summary`
銘柄コード（code）または日付（date）の指定が必須となります。
### パラメータ及びレスポンス
銘柄コード（code）または日付（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, cursor: – → 指定された銘柄について全期間分の財務情報データ
- code: ✓, date: ✓, cursor: – → 指定された銘柄について指定された日付の財務情報データ
- code: –, date: ✓, cursor: – → 全上場銘柄について指定された日付の財務情報データ
- code: –, date: ✓, cursor: ✓ → 前回リクエスト以降の財務情報データを取得（Premiumプランのみ）
### cursorを使った財務情報の取得
cursorを使った差分取得の仕様については、[cursorを使った差分取得](https://jpx-jquants.com/ja/spec/cursor)をご参照ください。
> **Note**
>
> cursorパラメータはPremiumプランでのみ利用可能です。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 86970 or 8697） 4桁もしくは5桁の銘柄コード |
| date | string | Optional | 開示日付の指定（e.g. 2022-01-05 or 20220105） |
| cursor | string | Optional | 差分取得のカーソル（Premiumプランのみ） 前回のレスポンスで返却された cursor を指定することで前回のリクエスト以降に配信されたデータを取得できます。pagination\_key と同時指定不可。 詳細は[cursorを使った差分取得](https://jpx-jquants.com/ja/spec/cursor)をご参照ください。 |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/fins/summary
**cURL**
```bash
curl -G https://api.jquants.com/v2/fins/summary \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/fins/summary', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/fins/summary",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | ---------------------------------------------------------------------- |
| DiscDate | string | Required | 開示日 |
| DiscTime | string | Required | 開示時刻 |
| Code | string | Required | 銘柄コード（5桁） |
| DiscNo | string | Required | 開示番号 APIから出力されるjsonは開示番号で昇順に並んでいます。 |
| DocType | string | Required | 開示書類種別 [開示書類種別一覧](https://jpx-jquants.com/ja/spec/fin-summary/typeofdocument) |
| CurPerType | string | Required | 当会計期間の種類 \[1Q, 2Q, 3Q, 4Q, 5Q, FY] |
| CurPerSt | string | Required | 当会計期間開始日 |
| CurPerEn | string | Required | 当会計期間終了日 |
| CurFYSt | string | Required | 当事業年度開始日 |
| CurFYEn | string | Required | 当事業年度終了日 |
| NxtFYSt | string | Required | 翌事業年度開始日 開示レコードに翌事業年度の開示情報がない場合空欄になります。 |
| NxtFYEn | string | Required | 翌事業年度終了日 開示レコードに翌事業年度の開示情報がない場合空欄になります。 |
| Sales | number | Required | 売上高 |
| OP | number | Required | 営業利益 |
| OdP | number | Required | 経常利益 |
| NP | number | Required | 当期純利益 |
| EPS | number | Required | 一株あたり当期純利益 |
| DEPS | number | Required | 潜在株式調整後一株あたり当期純利益 |
| TA | number | Required | 総資産 |
| Eq | number | Required | 純資産 |
| EqAR | number | Required | 自己資本比率 |
| BPS | number | Required | 一株あたり純資産 |
| CFO | number | Required | 営業活動によるキャッシュ・フロー |
| CFI | number | Required | 投資活動によるキャッシュ・フロー |
| CFF | number | Required | 財務活動によるキャッシュ・フロー |
| CashEq | number | Required | 現金及び現金同等物期末残高 |
| Div1Q | number | Required | 一株あたり配当実績\_第1四半期末 |
| Div2Q | number | Required | 一株あたり配当実績\_第2四半期末 |
| Div3Q | number | Required | 一株あたり配当実績\_第3四半期末 |
| DivFY | number | Required | 一株あたり配当実績\_期末 |
| DivAnn | number | Required | 一株あたり配当実績\_合計 |
| DivUnit | number | Required | 1口当たり分配金 |
| DivTotalAnn | number | Required | 配当金総額 |
| PayoutRatioAnn | number | Required | 配当性向 |
| FDiv1Q | number | Required | 一株あたり配当予想\_第1四半期末 |
| FDiv2Q | number | Required | 一株あたり配当予想\_第2四半期末 |
| FDiv3Q | number | Required | 一株あたり配当予想\_第3四半期末 |
| FDivFY | number | Required | 一株あたり配当予想\_期末 |
| FDivAnn | number | Required | 一株あたり配当予想\_合計 |
| FDivUnit | number | Required | 1口当たり予想分配金 |
| FDivTotalAnn | number | Required | 予想配当金総額 |
| FPayoutRatioAnn | number | Required | 予想配当性向 |
| NxFDiv1Q | number | Required | 一株あたり配当予想\_翌事業年度第1四半期末 |
| NxFDiv2Q | number | Required | 一株あたり配当予想\_翌事業年度第2四半期末 |
| NxFDiv3Q | number | Required | 一株あたり配当予想\_翌事業年度第3四半期末 |
| NxFDivFY | number | Required | 一株あたり配当予想\_翌事業年度期末 |
| NxFDivAnn | number | Required | 一株あたり配当予想\_翌事業年度合計 |
| NxFDivUnit | number | Required | 1口当たり翌事業年度予想分配金 |
| NxFPayoutRatioAnn | number | Required | 翌事業年度予想配当性向 |
| FSales2Q | number | Required | 売上高\_予想\_第2四半期末 |
| FOP2Q | number | Required | 営業利益\_予想\_第2四半期末 |
| FOdP2Q | number | Required | 経常利益\_予想\_第2四半期末 |
| FNP2Q | number | Required | 当期純利益\_予想\_第2四半期末 |
| FEPS2Q | number | Required | 一株あたり当期純利益\_予想\_第2四半期末 |
| NxFSales2Q | number | Required | 売上高\_予想\_翌事業年度第2四半期末 |
| NxFOP2Q | number | Required | 営業利益\_予想\_翌事業年度第2四半期末 |
| NxFOdP2Q | number | Required | 経常利益\_予想\_翌事業年度第2四半期末 |
| NxFNp2Q | number | Required | 当期純利益\_予想\_翌事業年度第2四半期末 |
| NxFEPS2Q | number | Required | 一株あたり当期純利益\_予想\_翌事業年度第2四半期末 |
| FSales | number | Required | 売上高\_予想\_期末 |
| FOP | number | Required | 営業利益\_予想\_期末 |
| FOdP | number | Required | 経常利益\_予想\_期末 |
| FNP | number | Required | 当期純利益\_予想\_期末 |
| FEPS | number | Required | 一株あたり当期純利益\_予想\_期末 |
| NxFSales | number | Required | 売上高\_予想\_翌事業年度期末 |
| NxFOP | number | Required | 営業利益\_予想\_翌事業年度期末 |
| NxFOdP | number | Required | 経常利益\_予想\_翌事業年度期末 |
| NxFNp | number | Required | 当期純利益\_予想\_翌事業年度期末 |
| NxFEPS | number | Required | 一株あたり当期純利益\_予想\_翌事業年度期末 |
| MatChgSub | string | Required | 期中における重要な子会社の異動 |
| SigChgInC | string | Required | 期中における連結範囲の重要な変更 \*指定されたdateが2024-07-21以前のレスポンスは、当該項目には値が収録されません。 |
| ChgByASRev | string | Required | 会計基準等の改正に伴う会計方針の変更 |
| ChgNoASRev | string | Required | 会計基準等の改正に伴う変更以外の会計方針の変更 |
| ChgAcEst | string | Required | 会計上の見積りの変更 |
| RetroRst | string | Required | 修正再表示 |
| ShOutFY | number | Required | 期末発行済株式数 |
| TrShFY | number | Required | 期末自己株式数 |
| AvgSh | number | Required | 期中平均株式数 |
| NCSales | number | Required | 売上高\_非連結 |
| NCOP | number | Required | 営業利益\_非連結 |
| NCOdP | number | Required | 経常利益\_非連結 |
| NCNP | number | Required | 当期純利益\_非連結 |
| NCEPS | number | Required | 一株あたり当期純利益\_非連結 |
| NCTA | number | Required | 総資産\_非連結 |
| NCEq | number | Required | 純資産\_非連結 |
| NCEqAR | number | Required | 自己資本比率\_非連結 |
| NCBPS | number | Required | 一株あたり純資産\_非連結 |
| FNCSales2Q | number | Required | 売上高\_予想\_第2四半期末\_非連結 |
| FNCOP2Q | number | Required | 営業利益\_予想\_第2四半期末\_非連結 |
| FNCOdP2Q | number | Required | 経常利益\_予想\_第2四半期末\_非連結 |
| FNCNP2Q | number | Required | 当期純利益\_予想\_第2四半期末\_非連結 |
| FNCEPS2Q | number | Required | 一株あたり当期純利益\_予想\_第2四半期末\_非連結 |
| NxFNCSales2Q | number | Required | 売上高\_予想\_翌事業年度第2四半期末\_非連結 |
| NxFNCOP2Q | number | Required | 営業利益\_予想\_翌事業年度第2四半期末\_非連結 |
| NxFNCOdP2Q | number | Required | 経常利益\_予想\_翌事業年度第2四半期末\_非連結 |
| NxFNCNP2Q | number | Required | 当期純利益\_予想\_翌事業年度第2四半期末\_非連結 |
| NxFNCEPS2Q | number | Required | 一株あたり当期純利益\_予想\_翌事業年度第2四半期末\_非連結 |
| FNCSales | number | Required | 売上高\_予想\_期末\_非連結 |
| FNCOP | number | Required | 営業利益\_予想\_期末\_非連結 |
| FNCOdP | number | Required | 経常利益\_予想\_期末\_非連結 |
| FNCNP | number | Required | 当期純利益\_予想\_期末\_非連結 |
| FNCEPS | number | Required | 一株あたり当期純利益\_予想\_期末\_非連結 |
| NxFNCSales | number | Required | 売上高\_予想\_翌事業年度期末\_非連結 |
| NxFNCOP | number | Required | 営業利益\_予想\_翌事業年度期末\_非連結 |
| NxFNCOdP | number | Required | 経常利益\_予想\_翌事業年度期末\_非連結 |
| NxFNCNP | number | Required | 当期純利益\_予想\_翌事業年度期末\_非連結 |
| NxFNCEPS | number | Required | 一株あたり当期純利益\_予想\_翌事業年度期末\_非連結 |
| ShEq | number | Required | 自己資本 |
| NCShEq | number | Required | 自己資本\_非連結 |
| ROE | number | Required | 自己資本利益率 |
| NCROE | number | Required | 自己資本利益率\_非連結 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"DiscDate": "2023-01-30",
"DiscTime": "12:00:00",
"Code": "86970",
"DiscNo": "20230127594871",
"DocType": "3QFinancialStatements_Consolidated_IFRS",
"CurPerType": "3Q",
"CurPerSt": "2022-04-01",
"CurPerEn": "2022-12-31",
"CurFYSt": "2022-04-01",
"CurFYEn": "2023-03-31",
"NxtFYSt": "",
"NxtFYEn": "",
"Sales": "100529000000",
"OP": "51765000000",
"OdP": "",
"NP": "35175000000",
"EPS": "66.76",
"DEPS": "",
"TA": "79205861000000",
"Eq": "320021000000",
"EqAR": "0.004",
"BPS": "",
"CFO": "",
"CFI": "",
"CFF": "",
"CashEq": "91135000000",
"Div1Q": "",
"Div2Q": "26.0",
"Div3Q": "",
"DivFY": "",
"DivAnn": "",
"DivUnit": "",
"DivTotalAnn": "",
"PayoutRatioAnn": "",
"FDiv1Q": "",
"FDiv2Q": "",
"FDiv3Q": "",
"FDivFY": "36.0",
"FDivAnn": "62.0",
"FDivUnit": "",
"FDivTotalAnn": "",
"FPayoutRatioAnn": "",
"NxFDiv1Q": "",
"NxFDiv2Q": "",
"NxFDiv3Q": "",
"NxFDivFY": "",
"NxFDivAnn": "",
"NxFDivUnit": "",
"NxFPayoutRatioAnn": "",
"FSales2Q": "",
"FOP2Q": "",
"FOdP2Q": "",
"FNP2Q": "",
"FEPS2Q": "",
"NxFSales2Q": "",
"NxFOP2Q": "",
"NxFOdP2Q": "",
"NxFNp2Q": "",
"NxFEPS2Q": "",
"FSales": "132500000000",
"FOP": "65500000000",
"FOdP": "",
"FNP": "45000000000",
"FEPS": "85.42",
"NxFSales": "",
"NxFOP": "",
"NxFOdP": "",
"NxFNp": "",
"NxFEPS": "",
"MatChgSub": "false",
"SigChgInC": "",
"ChgByASRev": "false",
"ChgNoASRev": "false",
"ChgAcEst": "true",
"RetroRst": "",
"ShOutFY": "528578441",
"TrShFY": "1861043",
"AvgSh": "526874759",
"NCSales": "",
"NCOP": "",
"NCOdP": "",
"NCNP": "",
"NCEPS": "",
"NCTA": "",
"NCEq": "",
"NCEqAR": "",
"NCBPS": "",
"FNCSales2Q": "",
"FNCOP2Q": "",
"FNCOdP2Q": "",
"FNCNP2Q": "",
"FNCEPS2Q": "",
"NxFNCSales2Q": "",
"NxFNCOP2Q": "",
"NxFNCOdP2Q": "",
"NxFNCNP2Q": "",
"NxFNCEPS2Q": "",
"FNCSales": "",
"FNCOP": "",
"FNCOdP": "",
"FNCNP": "",
"FNCEPS": "",
"NxFNCSales": "",
"NxFNCOP": "",
"NxFNCOdP": "",
"NxFNCNP": "",
"NxFNCEPS": "",
"ShEq": "318500000000",
"NCShEq": "",
"ROE": "0.112",
"NCROE": ""
}
],
"cursor": "eyJkIjoiMjAyNS0wNC0wMSIsInQiOiIyMDI1LTA0LTAxVDA4OjAwOjAwWiMyMDI1MDQwMTEzMDEwMCJ9"
}
```
---
Source: https://jpx-jquants.com/ja/spec/fin-summary/typeofdocument
# 開示書類種別
財務情報APIのTypeOfDocumentの項目一覧です。
## 書類種別一覧
| 書類種別 | 概要 |
| -------------------------------------------------------- | --------------------- |
| FYFinancialStatements\_Consolidated\_JP | 決算短信 （連結・日本基準） |
| FYFinancialStatements\_Consolidated\_US | 決算短信 （連結・米国基準） |
| FYFinancialStatements\_NonConsolidated\_JP | 決算短信 （非連結・日本基準） |
| 1QFinancialStatements\_Consolidated\_JP | 第1四半期決算短信 （連結・日本基準） |
| 1QFinancialStatements\_Consolidated\_US | 第1四半期決算短信 （連結・米国基準） |
| 1QFinancialStatements\_NonConsolidated\_JP | 第1四半期決算短信 （非連結・日本基準） |
| 2QFinancialStatements\_Consolidated\_JP | 第2四半期決算短信 （連結・日本基準） |
| 2QFinancialStatements\_Consolidated\_US | 第2四半期決算短信 （連結・米国基準） |
| 2QFinancialStatements\_NonConsolidated\_JP | 第2四半期決算短信 （非連結・日本基準） |
| 3QFinancialStatements\_Consolidated\_JP | 第3四半期決算短信 （連結・日本基準） |
| 3QFinancialStatements\_Consolidated\_US | 第3四半期決算短信 （連結・米国基準） |
| 3QFinancialStatements\_NonConsolidated\_JP | 第3四半期決算短信 （非連結・日本基準） |
| OtherPeriodFinancialStatements\_Consolidated\_JP | その他四半期決算短信 （連結・日本基準） |
| OtherPeriodFinancialStatements\_Consolidated\_US | その他四半期決算短信 （連結・米国基準） |
| OtherPeriodFinancialStatements\_NonConsolidated\_JP | その他四半期決算短信 （非連結・日本基準） |
| FYFinancialStatements\_Consolidated\_JMIS | 決算短信 （連結・ＪＭＩＳ） |
| 1QFinancialStatements\_Consolidated\_JMIS | 第1四半期決算短信 （連結・ＪＭＩＳ） |
| 2QFinancialStatements\_Consolidated\_JMIS | 第2四半期決算短信 （連結・ＪＭＩＳ） |
| 3QFinancialStatements\_Consolidated\_JMIS | 第3四半期決算短信 （連結・ＪＭＩＳ） |
| OtherPeriodFinancialStatements\_Consolidated\_JMIS | その他四半期決算短信 （連結・ＪＭＩＳ） |
| FYFinancialStatements\_NonConsolidated\_IFRS | 決算短信 （非連結・ＩＦＲＳ） |
| 1QFinancialStatements\_NonConsolidated\_IFRS | 第1四半期決算短信 （非連結・ＩＦＲＳ） |
| 2QFinancialStatements\_NonConsolidated\_IFRS | 第2四半期決算短信 （非連結・ＩＦＲＳ） |
| 3QFinancialStatements\_NonConsolidated\_IFRS | 第3四半期決算短信 （非連結・ＩＦＲＳ） |
| OtherPeriodFinancialStatements\_NonConsolidated\_IFRS | その他四半期決算短信 （非連結・ＩＦＲＳ） |
| FYFinancialStatements\_Consolidated\_IFRS | 決算短信 （連結・ＩＦＲＳ） |
| 1QFinancialStatements\_Consolidated\_IFRS | 第1四半期決算短信 （連結・ＩＦＲＳ） |
| 2QFinancialStatements\_Consolidated\_IFRS | 第2四半期決算短信 （連結・ＩＦＲＳ） |
| 3QFinancialStatements\_Consolidated\_IFRS | 第3四半期決算短信 （連結・ＩＦＲＳ） |
| OtherPeriodFinancialStatements\_Consolidated\_IFRS | その他四半期決算短信 （連結・ＩＦＲＳ） |
| FYFinancialStatements\_NonConsolidated\_Foreign | 決算短信 （非連結・外国株） |
| 1QFinancialStatements\_NonConsolidated\_Foreign | 第1四半期決算短信 （非連結・外国株） |
| 2QFinancialStatements\_NonConsolidated\_Foreign | 第2四半期決算短信 （非連結・外国株） |
| 3QFinancialStatements\_NonConsolidated\_Foreign | 第3四半期決算短信 （非連結・外国株） |
| OtherPeriodFinancialStatements\_NonConsolidated\_Foreign | その他四半期決算短信 （非連結・外国株） |
| FYFinancialStatements\_Consolidated\_Foreign | 決算短信 （連結・外国株） |
| 1QFinancialStatements\_Consolidated\_Foreign | 第1四半期決算短信 （連結・外国株） |
| 2QFinancialStatements\_Consolidated\_Foreign | 第2四半期決算短信 （連結・外国株） |
| 3QFinancialStatements\_Consolidated\_Foreign | 第3四半期決算短信 （連結・外国株） |
| OtherPeriodFinancialStatements\_Consolidated\_Foreign | その他四半期決算短信 （連結・外国株） |
| FYFinancialStatements\_Consolidated\_REIT | 決算短信（REIT） |
| DividendForecastRevision | 配当予想の修正 |
| EarnForecastRevision | 業績予想の修正 |
| REITDividendForecastRevision | 分配予想の修正 |
| REITEarnForecastRevision | 利益予想の修正 |
---
Source: https://jpx-jquants.com/ja/spec/fix-data-info
# データ修正履歴・制約事項
### データ訂正の反映方法
> **Note**
>
> - データの訂正は既存データへの上書きで反映されます。訂正前の旧データの保持や、訂正箇所の差分提供は行っておりません。
> - データ更新・訂正の完了を通知するAPIや、データの版番号・ETagは提供しておりません。
> - cursorを使った差分取得に対応しているのは、財務情報・財務諸表・適時開示インデックス一覧のみです（[cursorを使った差分取得](https://jpx-jquants.com/ja/spec/cursor)参照）。
> - 訂正を確実に取り込みたい場合は、[提供データの更新タイミング](https://jpx-jquants.com/ja/spec/data-update)を踏まえて、必要な範囲のデータを定期的に再取得することを推奨します。
### データ修正履歴
#### 最近の修正履歴(直近5件)
| 修正日 | 修正対象API | 対象期間 | 修正内容 |
| ---------- | -------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| 2026年8月27日 | 適時開示情報 | 2022年8月29日、2023年11月2日 | 欠損していた2022年8月29日、2023年11月2日の適時開示インデックス・開示書類（PDF/XBRL）を追加しました。 あわせて、適時開示インデックス一括ダウンロード（バルクデータ）も修正後のファイルに差し替えています。 |
| 2026年8月5日 | オプション四本値 | 2026年8月3日 | 有価証券オプション（EQOP）の一部銘柄について、以下の項目に誤った値が収録されていたため修正しました。Settle(清算値段) IV(インプライドボラティリティ)対象銘柄数：1,189 あわせて、2026年8月3日分のバルクデータ（日次）も修正後のファイルに差し替えています。 |
| 2026年6月29日 | 株価四本値 | ー | 株価調整対象にライツイシューを追加したことに伴い、過去に正しく調整されていなかった調整済み株価・出来高を修正しました。 対象銘柄コード：17730, 33180, 37500, 38320, 38560, 45410, 57210, 63970, 69930, 77780, 94780 |
| 2026年1月23日 | 空売り残高報告 | 2013年11月7日 - 2026年1月13日 | 以下の項目について、浮動小数点演算による微小な誤差を補正し、数値を小数点以下4桁に正規化しました。ShrtPosToSO(空売り残高割合) PrevRptRatio(直近空売り残高割合) |
| 2025年5月2日 | 財務情報 | - | データ全般を修正しました。 |
#### 過去の修正履歴
| 修正日 | 修正対象API | 対象期間 | 修正内容 |
| ---------- | ----------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| 2024年9月20日 | オプション四本値 | 2010年1月4日 - 2014年3月20日 | 指数オプションについて前場・後場四本値の値を修正 |
| 2024年9月20日 | 先物四本値 | 2010年以降 | 指数先物についてDaySession四本値の値を修正 |
| 2024年8月2日 | 財務情報 / 財務諸表 | ー | データ全般を修正しました。 |
| 2024年6月17日 | 上場銘柄一覧 | ー | ScaleCategoryの値が一部誤って"-"になってしまっているのを修正 |
| 2024年2月28日 | 財務情報 / 財務諸表 | 2009年1月13日-2024年2月8日 | データ全般を修正しました。 |
| 2023年11月7日 | 業種別空売り比率 | 2023年11月6日 | 2023年11月6日のデータ全体を修正。 |
| 2023年9月22日 | 売買内訳データ | ー | 一部日付に存在した実在しない以下銘柄コードのデータを削除 銘柄コード：20000, 30000, 50000 |
| 2023年4月10日 | 財務情報 | 2008年7月7日ー2014年3月31日 | 以下の項目について欠損データを修正（ResultDividentPerShareAnual）。各項目について、前会計期間の値が入っててしまっている箇所があったため、それらを当会計期間の値へ修正。 |
| 2023年4月10日 | 株価四本値 | 2023年3月28日 | 欠損していた2023年3月28日のデータを追加 |
| 2023年4月4日 | 財務情報 | 2008年7月7日ー2014年3月31日 | 以下の項目ついて欠損データを修正（TypeOfCurrentPeriod, CurrentPeriodStartDate, CurrentPeriodEndDate, CurrentFiscalYearStartDate, CurrentFiscalYearEndDate）。 |
| 2023年4月4日 | オプション四本値 | 2008年5月7日ー2016年7月15日 | Month（限月）について、YYYY-MM形式となるよう修正 |
### 現時点で判明している制約事項
現時点で判明している制約事項や問題事象について記載しています。
#### 現在判明している制約事項
| 追加日 | 対象のAPI | 内容 | 回避方法 | 解消日 |
| --- | ------ | -- | ---- | --- |
| なし | | | | |
#### 解消済み
| 追加日 | 対象のAPI | 内容 | 回避方法 | 解消日 |
| ---------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ---------- |
| 2024年8月26日 | 先物四本値 | 指数先物についてDaySessionの四本値の値が取得できない。 | | 2024年9月20日 |
| 2023年6月9日 | 財務情報 | TypeOfCurrentPeriodとCurrentPeriodEndDateに誤り ・銘柄コード36330の開示日付2017-04-27、2017-07-27、2017-10-30 ・銘柄コード60260の開示日付2015-04-28、2015-07-29 | TypeOfDocumentの値でどの期間かを確認することが可能です [開示書類種別](fin-summary/typeofdocument) | 2024年2月28日 |
| 2023年4月10日 | 投資部門別情報 | 日付を指定しないで全日のデータを取得できない | 日付やセクションを指定して、取得する対象を絞ってリクエストしてください。 | 2023年4月27日 |
| 2023年4月3日 | 財務情報 | 2022年5月13日のデータを日付指定で取得できない | 日付に加えて銘柄コードを指定して、取得する対象を絞ってリクエストしてください。 | 2023年4月27日 |
---
Source: https://jpx-jquants.com/ja/spec/gzip-compression
# APIレスポンスのGzip化
データ通信量削減を目的としてAPIからのレスポンスをGzip化しています。
## ユーザの利用パターンごとの影響有無
| パッケージ\*使用有無 | Accept-Encoding:gzip 有無 | クライアント側での対処の要否 |
| :----------- | :---------------------- | :------------------------------------------------- |
| **パッケージ使用** | デフォルトで上記ヘッダーが付与 | **対処不要** (圧縮されたレスポンスが自動的に解凍されるためクライアント側での考慮は不要) |
| **パッケージ不使用** | 上記headerあり | **圧縮されたレスポンスの適切な解凍処理が必要** (curlの場合 `--compressed`) |
| | 上記headerなし | **対処不要** (未圧縮のレスポンスを受信するためクライアント側での考慮は不要) |
\* 一般的にRestAPIコール時に利用されるHTTPクライアントライブラリのことを指します。（例）pythonにおけるrequestsやurllib等のライブラリ
---
Source: https://jpx-jquants.com/ja/spec/idx-bars-daily-topix
# TOPIX指数四本値(/indices/bars/daily/topix)
`GET` /v2/indices/bars/daily/topix
## APIの概要
TOPIXの日通しの四本値を取得できます。\
本APIで取得可能な指数データは TOPIX（東証株価指数）のみとなります。
## 日次のTOPIX指数データを取得します
`GET` `https://api.jquants.com/v2/indices/bars/daily/topix`
日付の範囲（from/to）を指定することができます。なお、指定しない場合は全期間のデータがレスポンスに収録されます。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------- |
| from | string | Optional | from の指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | to の指定（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/indices/bars/daily/topix
**cURL**
```bash
curl -G https://api.jquants.com/v2/indices/bars/daily/topix \
-H "x-api-key: {{apiKey}}" \
-d from="{{from}}" \
-d to="{{to}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/indices/bars/daily/topix", {
params: {
from: '{{from}}',
to: '{{to}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/indices/bars/daily/topix",
params={
"from": "{{from}}",
"to": "{{to}}",
},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | -------------- |
| Date | string | Required | 日付（YYYY-MM-DD） |
| O | number | Required | 始値 |
| H | number | Required | 高値 |
| L | number | Required | 安値 |
| C | number | Required | 終値 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2022-06-28",
"O": 1885.52,
"H": 1907.38,
"L": 1885.32,
"C": 1907.38
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/idx-bars-daily/indexcodes
# 配信対象指数コード
## 各指数の留意点
> **Info**
>
> - 2022年4月の東証市場区分再編によりマザーズ市場は廃止されていますが、一定のルールに基づき東証マザーズ指数の構成銘柄の入替を行い、2023年11月6日より指数名称を「東証グロース市場250指数」に変更されています。詳細は[こちら](https://www.jpx.co.jp/news/6030/20230428-01.html)をご参照ください。
> - 「（Premium）」とある指数はPremiumプランのみで取得可能です。
> - 配当込み指数は終値のみを提供します。
| 指数コード | 指数名称 | データ収録期間 |
| ----- | ---------------------------- | ------------------------------- |
| 0000 | TOPIX | 2008/5/7〜 |
| 0001 | 東証二部総合指数 | 2008/5/7〜2022/4/1 |
| 0028 | TOPIX Core30 | 2008/5/7〜 |
| 0029 | TOPIX Large 70 | 2008/5/7〜 |
| 002A | TOPIX 100 | 2008/5/7〜 |
| 002B | TOPIX Mid400 | 2008/5/7〜 |
| 002C | TOPIX 500 | 2008/5/7〜 |
| 002D | TOPIX Small | 2008/5/7〜 |
| 002E | TOPIX 1000 | 2008/5/7〜 |
| 002F | TOPIX Small500 | （四本値）2018/10/9〜 （終値のみ）2018/9/3〜 |
| 0040 | 東証業種別 水産・農林業 | 2008/5/7〜 |
| 0041 | 東証業種別 鉱業 | 2008/5/7〜 |
| 0042 | 東証業種別 建設業 | 2008/5/7〜 |
| 0043 | 東証業種別 食料品 | 2008/5/7〜 |
| 0044 | 東証業種別 繊維製品 | 2008/5/7〜 |
| 0045 | 東証業種別 パルプ・紙 | 2008/5/7〜 |
| 0046 | 東証業種別 化学 | 2008/5/7〜 |
| 0047 | 東証業種別 医薬品 | 2008/5/7〜 |
| 0048 | 東証業種別 石油・石炭製品 | 2008/5/7〜 |
| 0049 | 東証業種別 ゴム製品 | 2008/5/7〜 |
| 004A | 東証業種別 ガラス・土石製品 | 2008/5/7〜 |
| 004B | 東証業種別 鉄鋼 | 2008/5/7〜 |
| 004C | 東証業種別 非鉄金属 | 2008/5/7〜 |
| 004D | 東証業種別 金属製品 | 2008/5/7〜 |
| 004E | 東証業種別 機械 | 2008/5/7〜 |
| 004F | 東証業種別 電気機器 | 2008/5/7〜 |
| 0050 | 東証業種別 輸送用機器 | 2008/5/7〜 |
| 0051 | 東証業種別 精密機器 | 2008/5/7〜 |
| 0052 | 東証業種別 その他製品 | 2008/5/7〜 |
| 0053 | 東証業種別 電気・ガス業 | 2008/5/7〜 |
| 0054 | 東証業種別 陸運業 | 2008/5/7〜 |
| 0055 | 東証業種別 海運業 | 2008/5/7〜 |
| 0056 | 東証業種別 空運業 | 2008/5/7〜 |
| 0057 | 東証業種別 倉庫・運輸関連業 | 2008/5/7〜 |
| 0058 | 東証業種別 情報・通信業 | 2008/5/7〜 |
| 0059 | 東証業種別 卸売業 | 2008/5/7〜 |
| 005A | 東証業種別 小売業 | 2008/5/7〜 |
| 005B | 東証業種別 銀行業 | 2008/5/7〜 |
| 005C | 東証業種別 証券・商品先物取引業 | 2008/5/7〜 |
| 005D | 東証業種別 保険業 | 2008/5/7〜 |
| 005E | 東証業種別 その他金融業 | 2008/5/7〜 |
| 005F | 東証業種別 不動産業 | 2008/5/7〜 |
| 0060 | 東証業種別 サービス業 | 2008/5/7〜 |
| 0070 | 東証グロース市場250指数 (旧：東証マザーズ指数※) | 2008/5/7〜 |
| 0075 | REIT | 2008/5/7〜 |
| 0080 | TOPIX-17 食品 | 2009/2/2〜 |
| 0081 | TOPIX-17 エネルギー資源 | 2009/2/2〜 |
| 0082 | TOPIX-17 建設・資材 | 2009/2/2〜 |
| 0083 | TOPIX-17 素材・化学 | 2009/2/2〜 |
| 0084 | TOPIX-17 医薬品 | 2009/2/2〜 |
| 0085 | TOPIX-17 自動車・輸送機 | 2009/2/2〜 |
| 0086 | TOPIX-17 鉄鋼・非鉄 | 2009/2/2〜 |
| 0087 | TOPIX-17 機械 | 2009/2/2〜 |
| 0088 | TOPIX-17 電機・精密 | 2009/2/2〜 |
| 0089 | TOPIX-17 情報通信・サービスその他 | 2009/2/2〜 |
| 008A | TOPIX-17 電力・ガス | 2009/2/2〜 |
| 008B | TOPIX-17 運輸・物流 | 2009/2/2〜 |
| 008C | TOPIX-17 商社・卸売 | 2009/2/2〜 |
| 008D | TOPIX-17 小売 | 2009/2/2〜 |
| 008E | TOPIX-17 銀行 | 2009/2/2〜 |
| 008F | TOPIX-17 金融（除く銀行） | 2009/2/2〜 |
| 0090 | TOPIX-17 不動産 | 2009/2/2〜 |
| 0091 | JASDAQ INDEX | 2008/5/7〜2022/4/1 |
| 0500 | 東証プライム市場指数 | 2022/6/27〜 |
| 0501 | 東証スタンダード市場指数 | 2022/6/27〜 |
| 0502 | 東証グロース市場指数 | 2022/6/27〜 |
| 0503 | JPXプライム150指数 | （四本値）2023/7/3〜 （終値のみ）2023/5/29〜 |
| 0504 | JPXスタートアップ急成長100指数 | （四本値）2026/3/9〜 （終値のみ）2022/7/28〜 |
| 8100 | TOPIX バリュー | 2009/2/9〜 |
| 812C | TOPIX500 バリュー | 2009/2/9〜 |
| 812D | TOPIXSmall バリュー | 2009/2/9〜 |
| 8200 | TOPIX グロース | 2009/2/9〜 |
| 822C | TOPIX500 グロース | 2009/2/9〜 |
| 822D | TOPIXSmall グロース | 2009/2/9〜 |
| 8501 | 東証REIT オフィス指数 | （四本値）2010/3/8〜 （終値のみ）2010/3/1〜 |
| 8502 | 東証REIT 住宅指数 | （四本値）2010/3/8〜 （終値のみ）2010/3/1〜 |
| 8503 | 東証REIT 商業・物流等指数 | （四本値）2010/3/8〜 （終値のみ）2010/3/1〜 |
| 6000 | 配当込みTOPIX 終値 | 2010/1/4〜 |
| B507 | 配当込みJPX日経インデックス400 終値 | 2013/11/18〜 |
| 6096 | 税引後配当込みJPX日経インデックス400 終値 | 2015/10/26〜 |
| 6095 | 税引後配当込み TOPIX 終値 | 2015/10/26〜 |
| 6028 | 配当込みTOPIX Core30 終値 | （Premium）2010/1/4〜 |
| 6029 | 配当込みTOPIX Large70 終値 | （Premium）2010/1/4〜 |
| 602A | 配当込みTOPIX 100 終値 | （Premium）2010/1/4〜 |
| 602B | 配当込みTOPIX Mid400 終値 | （Premium）2010/1/4〜 |
| 602C | 配当込みTOPIX 500 終値 | （Premium）2010/1/4〜 |
| 602D | 配当込みTOPIX Small 終値 | （Premium）2010/1/4〜 |
| 602E | 配当込みTOPIX 1000 終値 | （Premium）2010/1/4〜 |
| 6040 | 配当込み東証業種別 水産・農林業 終値 | （Premium）2010/1/4〜 |
| 6041 | 配当込み東証業種別 鉱業 終値 | （Premium）2010/1/4〜 |
| 6042 | 配当込み東証業種別 建設業 終値 | （Premium）2010/1/4〜 |
| 6043 | 配当込み東証業種別 食料品 終値 | （Premium）2010/1/4〜 |
| 6044 | 配当込み東証業種別 繊維製品 終値 | （Premium）2010/1/4〜 |
| 6045 | 配当込み東証業種別 パルプ・紙 終値 | （Premium）2010/1/4〜 |
| 6046 | 配当込み東証業種別 化学 終値 | （Premium）2010/1/6〜 |
| 6047 | 配当込み東証業種別 医薬品 終値 | （Premium）2010/1/4〜 |
| 6048 | 配当込み東証業種別 石油・石炭製品 終値 | （Premium）2010/1/4〜 |
| 6049 | 配当込み東証業種別 ゴム製品 終値 | （Premium）2010/1/4〜 |
| 604A | 配当込み東証業種別 ガラス・土石製品 終値 | （Premium）2010/1/4〜 |
| 604B | 配当込み東証業種別 鉄鋼 終値 | （Premium）2010/1/4〜 |
| 604C | 配当込み東証業種別 非鉄金属 終値 | （Premium）2010/1/4〜 |
| 604D | 配当込み東証業種別 金属製品 終値 | （Premium）2010/1/4〜 |
| 604E | 配当込み東証業種別 機械 終値 | （Premium）2010/1/4〜 |
| 604F | 配当込み東証業種別 電気機器 終値 | （Premium）2010/1/4〜 |
| 6050 | 配当込み東証業種別 輸送用機器 終値 | （Premium）2010/1/4〜 |
| 6051 | 配当込み東証業種別 精密機器 終値 | （Premium）2010/1/4〜 |
| 6052 | 配当込み東証業種別 その他製品 終値 | （Premium）2010/1/4〜 |
| 6053 | 配当込み東証業種別 電気・ガス業 終値 | （Premium）2010/1/4〜 |
| 6054 | 配当込み東証業種別 陸運業 終値 | （Premium）2010/1/4〜 |
| 6055 | 配当込み東証業種別 海運業 終値 | （Premium）2010/1/4〜 |
| 6056 | 配当込み東証業種別 空運業 終値 | （Premium）2010/1/4〜 |
| 6057 | 配当込み東証業種別 倉庫・運輸関連業 終値 | （Premium）2010/1/4〜 |
| 6058 | 配当込み東証業種別 情報・通信業 終値 | （Premium）2010/1/4〜 |
| 6059 | 配当込み東証業種別 卸売業 終値 | （Premium）2010/1/4〜 |
| 605A | 配当込み東証業種別 小売業 終値 | （Premium）2010/1/4〜 |
| 605B | 配当込み東証業種別 銀行業 終値 | （Premium）2010/1/4〜 |
| 605C | 配当込み東証業種別 証券・商品先物取引業 終値 | （Premium）2010/1/4〜 |
| 605D | 配当込み東証業種別 保険業 終値 | （Premium）2010/1/4〜 |
| 605E | 配当込み東証業種別 その他金融業 終値 | （Premium）2010/1/4〜 |
| 605F | 配当込み東証業種別 不動産業 終値 | （Premium）2010/1/4〜 |
| 6060 | 配当込み東証業種別 サービス業 終値 | （Premium）2010/1/4〜 |
| 6080 | 配当込みTOPIX-17 食品 終値 | （Premium）2010/1/4〜 |
| 6081 | 配当込みTOPIX-17 エネルギー資源 終値 | （Premium）2010/1/4〜 |
| 6082 | 配当込みTOPIX-17 建設・資材 終値 | （Premium）2010/1/4〜 |
| 6083 | 配当込みTOPIX-17 素材・化学 終値 | （Premium）2010/1/4〜 |
| 6084 | 配当込みTOPIX-17 医薬品 終値 | （Premium）2010/1/4〜 |
| 6085 | 配当込みTOPIX-17 自動車・輸送機 終値 | （Premium）2010/1/4〜 |
| 6086 | 配当込みTOPIX-17 鉄鋼・非鉄 終値 | （Premium）2010/1/4〜 |
| 6087 | 配当込みTOPIX-17 機械 終値 | （Premium）2010/1/4〜 |
| 6088 | 配当込みTOPIX-17 電機・精密 終値 | （Premium）2010/1/4〜 |
| 6089 | 配当込みTOPIX-17 情報通信・サービスその他 終値 | （Premium）2010/1/4〜 |
| 608A | 配当込みTOPIX-17 電力・ガス 終値 | （Premium）2010/1/4〜 |
| 608B | 配当込みTOPIX-17 運輸・物流 終値 | （Premium）2010/1/4〜 |
| 608C | 配当込みTOPIX-17 商社・卸売 終値 | （Premium）2010/1/4〜 |
| 608D | 配当込みTOPIX-17 小売 終値 | （Premium）2010/1/4〜 |
| 608E | 配当込みTOPIX-17 銀行 終値 | （Premium）2010/1/4〜 |
| 608F | 配当込みTOPIX-17 金融（除く銀行） 終値 | （Premium）2010/1/4〜 |
| 6090 | 配当込みTOPIX-17 不動産 終値 | （Premium）2010/1/4〜 |
| B100 | 配当込みTOPIX バリュー 終値 | （Premium）2010/1/4〜 |
| B200 | 配当込みTOPIX グロース 終値 | （Premium）2010/1/4〜 |
| B12C | 配当込みTOPIX500 バリュー 終値 | （Premium）2010/1/4〜 |
| B22C | 配当込みTOPIX500 グロース 終値 | （Premium）2010/1/4〜 |
| B12D | 配当込みTOPIXSmall バリュー 終値 | （Premium）2010/1/4〜 |
| B22D | 配当込みTOPIXSmall グロース 終値 | （Premium）2010/1/4〜 |
| 6075 | 配当込みREIT 終値 | （Premium）2010/1/4〜 |
| B500 | 配当込み配当フォーカス100 終値 | （Premium）2010/3/1〜 |
| B501 | 配当込み東証REIT オフィス指数 終値 | （Premium）2010/3/1〜 |
| B502 | 配当込み東証REIT 住宅指数 終値 | （Premium）2010/3/1〜 |
| B503 | 配当込み東証REIT 商業・物流等指数 終値 | （Premium）2010/3/1〜 |
| 7000 | 配当込み東証プライム市場指数 終値 | （Premium）2022/4/4〜 |
| 7001 | 配当込み東証スタンダード市場指数 終値 | （Premium）2022/4/4〜 |
| 7002 | 配当込み東証グロース市場指数 終値 | （Premium）2022/4/4〜 |
| 6503 | 配当込みJPXプライム150指数 終値 | （Premium）2023/5/29〜 |
| 6504 | 配当込みJPXスタートアップ急成長100指数 終値 | （Premium）2022/7/28〜 |
---
Source: https://jpx-jquants.com/ja/spec/idx-bars-daily
# 指数四本値(/indices/bars/daily)
`GET` /v2/indices/bars/daily
## APIの概要
各種指数の四本値データを取得することができます。
現在配信している指数につきましては、[こちらのページ](https://jpx-jquants.com/ja/spec/idx-bars-daily/indexcodes)を参照ください。
### 本APIの留意点
> **Info**
>
> - 2022年4月の東証市場区分再編によりマザーズ市場は廃止されていますが、一定のルールに基づき東証マザーズ指数の構成銘柄の入替を行い、2023年11月6日より指数名称を「東証グロース市場250指数」に変更されています。詳細は[こちら](https://www.jpx.co.jp/news/6030/20230428-01.html)をご参照ください。
> - 2020年10月1日のデータは東京証券取引所の株式売買システムの障害により終日売買停止となった関係で、四本値は前営業日（2020年10月1日）の終値が収録されています。
> - 一部の指数についてはPremiumプランのみ取得可能です。
> - 一部の指数については、終値のみを提供します。
### 提供していない指数・項目
配信対象の指数は[配信対象指数コード](https://jpx-jquants.com/ja/spec/idx-bars-daily/indexcodes)を参照ください。以下の指数・項目は提供しておりません。
> **Info**
>
> - 日経平均株価（現物指数）は提供しておりません。
> - 指数四本値のレスポンスに売買代金・売買高は含まれません。
## 日次の指数四本値データを取得します
`GET` `https://api.jquants.com/v2/indices/bars/daily`
データの取得では、指数コード（code）または日付（date）の指定が必須となります。
### パラメータ及びレスポンス
データの取得する際には、指数コード（code）または日付（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, from /to: – → 指定された銘柄について全期間分のデータ
- code: ✓, date: ✓, from /to: – → 指定された銘柄について指定された日付のデータ
- code: ✓, date: –, from /to: ✓ → 指定された銘柄について指定された期間分のデータ
- code: –, date: ✓, from /to: – → 配信している指数全てについて指定された日付のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------ |
| code | string | Optional | 指数コード（e.g. 0000 or 0028） 配信対象の指数コードについては[配信対象指数コード](https://jpx-jquants.com/ja/spec/idx-bars-daily/indexcodes)を参照してください。 |
| date | string | Optional | from と to を指定しないとき（e.g. 20210907 or 2021-09-07） |
| from | string | Optional | from の指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | to の指定（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/indices/bars/daily
**cURL**
```bash
curl -G https://api.jquants.com/v2/indices/bars/daily \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/indices/bars/daily", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/indices/bars/daily",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | --------------------------------------------------------------------------- |
| Date | string | Required | 日付（YYYY-MM-DD） |
| Code | string | Required | 指数コード 配信対象の指数コードは[こちらのページ](https://jpx-jquants.com/ja/spec/idx-bars-daily/indexcodes)を参照ください。 |
| O | number | Required | 始値（※） |
| H | number | Required | 高値（※） |
| L | number | Required | 安値（※） |
| C | number | Required | 終値 |
※ 終値のみ提供の指数についてはNullが設定されます。
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-12-01",
"Code": "0028",
"O": 1199.18,
"H": 1202.58,
"L": 1195.01,
"C": 1200.17
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/jquants-cli
# J-Quants CLI
J-Quants API V2 を利用して日本株式市場のデータを取得できる CLI ツール `jquants` の使い方を説明します。
> **Note**
>
> セットアップ・グローバルオプション・代表的な使い方を中心に解説しています。サブコマンドのオプション一覧は `jquants <グループ> <サブコマンド> --help` で確認できます。
## 前提条件
- **アカウント登録:** J-Quants API V2 を利用するには[アカウント登録](https://jpx-jquants.com/register)が必要です。
- **プラン選択:** データ取得には Free / Light / Standard / Premium のいずれかのプランを選択してください。なお、プランによってアクセスできるエンドポイントが異なりますので、ご注意ください。
## インストール
### Homebrew（macOS / Linux）
```bash
brew install J-Quants/tap/jquants
```
> **Note**
>
> Homebrew 6.0.0 以降では、セキュリティ強化のためサードパーティ tap の formula を利用する際に明示的な信頼（trust）が必要になりました。tap が信頼されていない旨のエラーが表示された場合は、以下のコマンドで formula を信頼してから再度インストールしてください。
>
> ```bash
> brew trust --formula J-Quants/tap/jquants
> ```
>
> 詳細は [Homebrew 公式ドキュメント（Tap Trust）](https://docs.brew.sh/Tap-Trust)を参照してください。
### GitHub Releases
[Releases ページ](https://github.com/J-Quants/jquants-cli/releases)から各プラットフォーム向けのビルド済みバイナリをダウンロードし、`PATH` の通ったディレクトリに配置してください。
| OS | アーキテクチャ | ファイル |
| ------- | --------------------- | ----------------------------------------------------- |
| macOS | Intel (x86\_64) | `jquants-{version}-x86_64-apple-darwin.tar.gz` |
| macOS | Apple Silicon (ARM64) | `jquants-{version}-aarch64-apple-darwin.tar.gz` |
| Linux | x86\_64 (musl) | `jquants-{version}-x86_64-unknown-linux-musl.tar.gz` |
| Linux | ARM64 (musl) | `jquants-{version}-aarch64-unknown-linux-musl.tar.gz` |
| Windows | x86\_64 | `jquants-{version}-x86_64-pc-windows-msvc.zip` |
## 認証(セットアップ)
### 推奨: OAuth2 ブラウザログイン
```bash
jquants login
```
実行するとブラウザが自動で開き、J-Quants アカウントでログインすると API Key が `~/.config/jquants/credentials.json` に保存されます。以降は API Key を明示的に指定する必要はありません。
### API Key を直接指定（代替手段）
環境変数または `.env` ファイルで設定できます。
```bash {{ title: "環境変数" }}
export JQUANTS_API_KEY=your_api_key_here
```
```ini {{ title: ".env ファイル" }}
# .env ファイル（プロジェクトルートに配置）
JQUANTS_API_KEY=your_api_key_here
```
API Key は [J-Quants Dashboard](https://jpx-jquants.com/dashboard/api-keys) から取得してください。
**認証優先順位:** `~/.config/jquants/credentials.json` の api\_key → `JQUANTS_API_KEY` 環境変数 → エラー
> **Note**
>
> - `credentials.json` や `JQUANTS_API_KEY` をリポジトリにコミットしないでください。
> - `.env` ファイルは `.gitignore` に追加し、バージョン管理から除外してください。
### ログアウト
```bash
jquants logout
```
ブラウザでログインセッションをクリアし、`~/.config/jquants/credentials.json` を削除します。
## AI Agent 連携
本ツールには AI Agent（Claude Code 等）向けの Skills ファイルが同梱されています。以下のコマンドでインストールしてください。
```bash {{ title: "npx" }}
npx skills add J-Quants/jquants-cli
```
```bash {{ title: "jquants CLI（カレントディレクトリ）" }}
# カレントディレクトリに配置
jquants skills add
```
```bash {{ title: "jquants CLI（ディレクトリ指定）" }}
# .claude/skills/jquants-cli-usage/ が作成される
jquants skills add --dir .claude/skills
```
## 基本的な使い方
### グローバルオプションの位置
`--output`、`--save`、`--fields` はすべて**サブコマンドの前**に指定する必要があります。
```bash {{ title: "正しい書き方" }}
# ✅ 正しい
jquants --output csv eq daily --code 86970
jquants --output json --save out.json eq master
```
```bash {{ title: "誤った書き方" }}
# ❌ 誤り（サブコマンドの後ろは無効）
jquants eq daily --code 86970 --output csv
```
### 出力フォーマット
`--output`（`-o`）フラグで出力形式を選択します。
| フォーマット | 説明 |
| --------- | ------------------------------ |
| `table` | テーブル形式（デフォルト）。列名は省略表記 |
| `json` | JSON 形式。全フィールドを完全な名前で出力 |
| `csv` | CSV 形式。パイプ時も自動で切り替わる |
| `parquet` | Apache Parquet 形式。`--save` が必須 |
```bash
jquants eq daily --code 86970 # テーブル表示（デフォルト）
jquants --output json eq daily --code 86970 # JSON 出力（全フィールド）
jquants --output csv eq master # CSV 出力
jquants --output parquet --save out.parquet eq daily --code 86970 # Parquet 保存
```
> **Note**
>
> `--output parquet` を使う場合は **`--save` が必須**です。`--save` なしで指定するとエラーになります。
### フィールド選択
`--fields`（`-f`）で取得するフィールドを絞り込めます。フィールド名は JSON / CSV のキー名（API のフィールド名）を使用します。テーブル表示の省略列名とは異なります。
```bash
# 銘柄コード・日付・調整済み終値のみ取得
jquants -f Date,Code,AdjC eq daily --code 86970
# 複数フィールドを CSV で保存
jquants --output csv --save prices.csv -f Date,Code,Open,High,Low,Close,Volume eq daily --code 86970
```
### フィールド名の確認方法
`jquants schema ` でフィールド一覧を確認できます（例: `jquants schema eq.daily`）。\
存在しないフィールド名を `-f` に指定すると、「利用可能フィールド」がエラーメッセージに一覧表示されます。
### ファイル保存
`--save ` でファイルに保存します。`--output` と組み合わせて使用します。
```bash
jquants --output csv --save master.csv eq master
jquants --output json --save daily.json eq daily --code 86970
jquants --output parquet --save daily.parquet eq daily --code 86970
```
> **Note**
>
> `--output table`（デフォルト）は `--save` と組み合わせることができません。ファイル保存には `csv`・`json`・`parquet` のいずれかを指定してください。保存完了時は stderr に `Saved: ` と表示されます。
### パイプ接続時の自動 CSV 切替
stdout がパイプ先に接続されている場合（TTY 非検出）、`--output table` でも自動的に CSV 形式で出力されます。
```bash
jquants eq master | head -5
jquants eq master | awk -F, '{print $3}'
jquants eq daily --code 86970 | python3 script.py
```
## コマンドリファレンス
### eq — 株式
株価・株式銘柄一覧・バリュエーション指標・投資部門別データを取得します。
| サブコマンド | 内容 |
| ------------------- | -------------------- |
| `master` | 銘柄マスタ（銘柄名・市場・業種など） |
| `daily` | 株価四本値（日次・調整済み OHLCV） |
| `am` | 前場四本値 |
| `minute` | 分足 OHLCV |
| `earnings-calendar` | 決算発表予定日（3・9月期決算会社のみ） |
| `investor-types` | 投資部門別売買状況 |
| `trades` | 株価ティック（歩み値・バルク取得） |
| `valuation` | バリュエーション指標 |
### mkt — 市場
売買内訳・信用残高・空売り・取引カレンダーなどの市場データを取得します。
| サブコマンド | 内容 |
| ------------------- | -------------------------------- |
| `breakdown` | 売買内訳 |
| `margin-alert` | 日々公表信用取引残高 |
| `margin-interest` | 信用取引週末残高 |
| `calendar` | 取引カレンダー（営業日・休業日） |
| `short-ratio` | 業種別空売り比率（フィルタは 33 業種コード `--s33`） |
| `short-sale-report` | 空売り残高報告（公表日 `--disc-date` など） |
### edinet — EDINET 書類
有価証券報告書・大量保有報告書など EDINET 提出書類由来のデータを取得します。**利用には Standard プラン以上の契約が必要です。**
| サブコマンド | 内容 |
| --------------------------- | --------------- |
| `major-shareholders` | 大株主状況（有価証券報告書） |
| `cross-shareholdings` | 政策保有株式（有価証券報告書） |
| `large-volume-shareholders` | 大量保有報告書 |
> **Note**
>
> - `--edinet-code` と `--code` は同時指定できません。すべてのオプションを省略すると、実行日に提出された書類のデータが返ります。
> - ネスト項目（`Hldrs`・`Report` など）はテーブル表示では件数に省略されます。全データは `--output json` で取得してください。
### fins — 財務
財務諸表・配当情報・決算発表予定日・財務サマリーを取得します。
| サブコマンド | 内容 |
| --------------- | ------------------------------------------------------------------- |
| `details` | 財務諸表（BS / PL / CF）。全フィールドは `--output json` 推奨 |
| `dividend` | 配当情報 |
| `earnings-date` | 決算発表予定日（全上場銘柄。`--code` / `--date` / `--scheduled-date` のいずれか 1 つ必須） |
| `summary` | 財務サマリー |
### idx — 指数
TOPIX および各種指数の日次データを取得します。
| サブコマンド | 内容 |
| ------------- | ------------ |
| `daily-topix` | TOPIX 日次バー |
| `daily` | 指数コード指定の日次バー |
### deriv — デリバティブ
先物・オプションの日次データを取得します。
| サブコマンド | 内容 |
| ------------- | --------------- |
| `futures` | 先物四本値 |
| `options` | オプション四本値 |
| `options-225` | 日経 225 オプション四本値 |
### td — TDnet 適時開示
TDnet（適時開示）のインデックス・開示ファイル・一括データを取得します。**利用には TDnet アドオンの契約が必要です。**
| サブコマンド | 内容 |
| ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `list` | 適時開示インデックス一覧（`--date` または `--code` を指定。`--code` は過去 5 年、`--from`/`--to` で期間指定、`--disc-items` で公開項目コードを AND 絞り込み） |
| `files` | 適時開示ファイル（PDF / XBRL）のダウンロード URL 取得（`--disc-no` 必須。URL の有効期限は 15 分、`--docs` で種類指定〈g=PDF全文 / s=サマリPDF / x=XBRL〉、`--download` で直接取得） |
| `bulk` | 適時開示の一括 CSV ダウンロード URL（過去 5 年・gzip。URL の有効期限は 15 分、`--download` で直接取得） |
### bulk — バルクダウンロード
複数銘柄・長期間などを GZ 圧縮 CSV で一括取得するためのコマンドです。
| サブコマンド | 内容 |
| ------ | ----------------------- |
| `list` | ダウンロード可能ファイル一覧 |
| `get` | ダウンロード URL の表示またはファイル取得 |
## シェル補完の設定
`jquants completions` でシェル補完スクリプトを生成できます。
```bash {{ title: "Bash" }}
jquants completions bash > ~/.config/bash/completions/jquants.bash
# ~/.bashrc に追記
source ~/.config/bash/completions/jquants.bash
```
```bash {{ title: "Zsh" }}
mkdir -p ~/.zfunc
jquants completions zsh > ~/.zfunc/_jquants
# ~/.zshrc に追記
fpath=(~/.zfunc $fpath)
autoload -Uz compinit && compinit
```
```bash {{ title: "Fish" }}
jquants completions fish > ~/.config/fish/completions/jquants.fish
```
```powershell {{ title: "PowerShell" }}
jquants completions powershell | Out-File -FilePath $PROFILE -Append
```
## よくある間違いと対処法
| 間違い | 正しい書き方 | 理由 |
| ------------------------------------------------ | ---------------------------------------------------------------------------- | --------------------------------------------- |
| `jquants eq daily --code 86970 --output csv` | `jquants --output csv eq daily --code 86970` | `--output` はサブコマンドの前に置く |
| `jquants --save out.csv eq daily --code 86970` | `jquants --output csv --save out.csv eq daily --code 86970` | `--save` には `--output csv` または `json` が必要 |
| `jquants --output table --save out.txt eq daily` | `jquants --output csv --save out.csv eq daily` | `--output table` は `--save` と組み合わせ不可 |
| `jquants --output parquet eq daily --code 86970` | `jquants --output parquet --save out.parquet eq daily --code 86970` | Parquet は `--save` が必須 |
| `jquants fins details --code 86970` でデータが省略される | `jquants --output json fins details --code 86970` | FS フィールドはテーブルでは「N items」と省略される。全データは JSON で取得 |
| 全銘柄ループで `eq daily --code X` を繰り返す | `jquants bulk get --endpoint /equities/bars/daily --date YYYY-MM --download` | 大量データはバルクダウンロードを使用 |
| バルクの GZ ファイルをそのまま読もうとする | ダウンロード後に `gunzip *.gz` で解凍 | バルクファイルは GZ 圧縮されている |
| `jquants login` を実行せずに API コマンドを実行 | 最初に `jquants login` を実行する | 認証情報がないと API エラーになる |
---
Source: https://jpx-jquants.com/ja/spec/mcp-server
# MCPサーバー
J-Quants APIの公式MCPサーバは、生成AIがJ-Quants APIを正しく利用できるよう最適化されています。\
MCPサーバを導入することで、AIにコード生成を任せながら、簡単にJ-Quantsデータへアクセスできます。\
本ガイドでは、J-Quants公式MCPサーバをAIクライアントに導入する手順を説明します。
## 全体の流れ
1. **必須要件の確認**: Python 3.10以上と uv がインストールされていることを確認します。
2. **MCPサーバーのインストール**: uvx コマンドでMCPサーバーをインストールします。
3. **AIクライアントへの設定**: Claude DesktopまたはCursorにMCPサーバーを登録します。
4. **利用開始**: AIに質問するだけで、J-Quants APIのエンドポイント情報やサンプルコードを取得できます。
## 必須要件
MCPサーバーを利用するには、以下の環境が必要です。
- **Python 3.10以上**
- **[uv](https://github.com/astral-sh/uv)** (推奨) または pip
> **Note**
>
> - uvは高速なPythonパッケージマネージャーです。まだインストールしていない場合は、以下のコマンドでインストールできます。
```bash {{ title: "macOS / Linux" }}
curl -LsSf https://astral.sh/uv/install.sh | sh
```
```bash {{ title: "Windows (PowerShell)" }}
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
## インストール
以下のコマンドでMCPサーバーをインストールします。\
`uv tool` を使用する方法を推奨しますが、`pip` でもインストール可能です。
```bash {{ title: "uv tool（推奨）" }}
# GitHubから直接インストール
uv tool install git+https://github.com/J-Quants/j-quants-doc-mcp.git
# またはローカルにクローンしてインストール
git clone https://github.com/J-Quants/j-quants-doc-mcp.git
cd j-quants-doc-mcp
uv tool install .
```
```bash {{ title: "pip" }}
# GitHubから直接インストール
pip install git+https://github.com/J-Quants/j-quants-doc-mcp.git
# またはローカルにクローンしてインストール
git clone https://github.com/J-Quants/j-quants-doc-mcp.git
cd j-quants-doc-mcp
pip install .
```
[GitHubリポジトリを見る →](https://github.com/J-Quants/j-quants-doc-mcp)
## AIクライアントへの設定
### Claude Desktop
`claude_desktop_config.json` に以下を追加してください。
```json {{ title: "uv toolでインストールした場合" }}
{
"mcpServers": {
"j-quants-doc-mcp": {
"command": "uvx",
"args": ["j-quants-doc-mcp"]
}
}
}
```
```json {{ title: "pipでインストールした場合" }}
{
"mcpServers": {
"j-quants-doc-mcp": {
"command": "j-quants-doc-mcp",
"args": []
}
}
}
```
**設定ファイルの場所:**
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
### Cursor
1. メニューバー「Cursor」→「Preferences」→「Cursor Settings」を開きます。
2. 左のメニュー「Tools & MCP」を選択し、「New MCP Server」をクリックします。
3. 開かれたJSONファイル（`mcp.json`）に以下を追加します。
```json {{ title: "uv toolでインストールした場合" }}
{
"mcpServers": {
"j-quants-doc-mcp": {
"command": "uvx",
"args": ["j-quants-doc-mcp"]
}
}
}
```
```json {{ title: "pipでインストールした場合" }}
{
"mcpServers": {
"j-quants-doc-mcp": {
"command": "j-quants-doc-mcp",
"args": []
}
}
}
```
**設定ファイルの場所:**
- macOS: `~/.cursor/mcp.json`
- Windows: `%USERPROFILE%\.cursor\mcp.json`
> **Note**
>
> - 設定後、AIクライアントを再起動してください。MCPサーバーが正しく認識されると、AIがJ-Quants APIに関する質問に回答できるようになります。
## アップデート
既にインストール済みの場合、最新版へのアップデートは以下の方法で行えます。
```bash {{ title: "uv toolを使用している場合" }}
# GitHubから直接インストールした場合
uv tool upgrade j-quants-doc-mcp
# ローカルクローンからインストールした場合
cd j-quants-doc-mcp
git pull
uv tool upgrade j-quants-doc-mcp
```
```bash {{ title: "pipを使用している場合" }}
# GitHubから直接インストールした場合
pip install --upgrade git+https://github.com/J-Quants/j-quants-doc-mcp.git
# ローカルクローンからインストールした場合
cd j-quants-doc-mcp
git pull
pip install --upgrade .
```
> **Note**
>
> - アップデート後、Claude DesktopやCursorを再起動することで新しいバージョンが反映されます。
## トラブルシューティング
### Claude DesktopまたはCursorで認識されない
1. 設定ファイルのJSONが正しい形式か確認してください。
2. AIクライアント（Claude Desktop / Cursor）を再起動してください。
### 生成されたコードが実行できない
生成されたPythonコードを実行するには、以下の依存関係をインストールしてください。
```bash {{ title: "依存関係のインストール" }}
pip install httpx python-dotenv
```
> **Note**
>
> - 環境変数が正しく設定されているか確認してください。
---
Source: https://jpx-jquants.com/ja/spec/migration-v1-v2
# V1 API から V2 API への変更点
J-Quants API V2 では、使いやすさの改善等を目的として、認証方式を含むいくつかの重要な仕様変更が行われています。
V1 API をご利用中のお客様は、以下の変更点をご確認の上、V2 API への移行をお願いいたします。
> **Note**
>
> 2025/12/22以降にご登録された方はV2のみご利用いただけます。移行の必要はございません。
## 認証認可
認証方式が「トークン方式」から「APIキー方式」に変更されました。
| 項目 | V1 API | V2 API |
| :---------- | :---------------------------------------------------- | :--------------------------------------------- |
| **API利用方法** | `token/auth_user` 等で ID Token / Refresh Token を発行して利用 | ダッシュボードから発行した **APIキー** (`x-api-key` ヘッダー) を利用 |
| **認可の期限** | ID Token / Refresh Token に有効期限あり | APIキー自体には有効期限なし（再発行・削除は可能） |
## プラン・データ提供範囲
| 項目 | V1 API | V2 API |
| :------------------ | :-------------------------- | :------------- |
| **Premiumプランの期間制限** | 無制限 | **過去20年分** まで |
| **上場銘柄一覧（貸借信用区分）** | Standard, Premium プランのみ取得可能 | **全プラン** で取得可能 |
## レートリミット
プランごとに API リクエスト数の上限（レートリミット）が設定されました。
| プラン | 上限 (リクエスト / 分) |
| :----------- | :------------- |
| **Free** | 5 |
| **Light** | 60 |
| **Standard** | 120 |
| **Premium** | 500 |
## エンドポイント・パラメータの変更
V1 API から V2 API への移行に伴い、エンドポイントのパスとパラメータを変更しています。
### エンドポイントの対応表
| データセット | V1 エンドポイント | V2 エンドポイント |
| :----------------- | :------------------------------------ | :--------------------------------------- |
| **トークン発行** | `/v1/token/auth_user` | **廃止** (APIキーを使用) |
| **トークンリフレッシュ** | `/v1/token/auth_refresh` | **廃止** (APIキーを使用) |
| **株価四本値** | `/v1/prices/daily_quotes` | `/v2/equities/bars/daily` |
| **前場四本値** | `/v1/prices/prices_am` | `/v2/equities/bars/daily/am` |
| **決算発表予定日** | `/v1/fins/announcement` | `/v2/equities/earnings-calendar` |
| **投資部門別情報** | `/v1/markets/trades_spec` | `/v2/equities/investor-types` |
| **上場銘柄一覧** | `/v1/listed/info` | `/v2/equities/master` |
| **先物四本値** | `/v1/derivatives/futures` | `/v2/derivatives/bars/daily/futures` |
| **オプション四本値** | `/v1/derivatives/options` | `/v2/derivatives/bars/daily/options` |
| **日経225オプション四本値** | `/v1/option/index_option` | `/v2/derivatives/bars/daily/options/225` |
| **売買内訳データ** | `/v1/markets/breakdown` | `/v2/markets/breakdown` |
| **取引カレンダー** | `/v1/markets/trading_calendar` | `/v2/markets/calendar` |
| **日々公表信用取引残高** | `/v1/markets/daily_margin_interest` | `/v2/markets/margin-alert` |
| **信用取引週末残高** | `/v1/markets/weekly_margin_interest` | `/v2/markets/margin-interest` |
| **業種別空売り比率** | `/v1/markets/short_selling` | `/v2/markets/short-ratio` |
| **空売り残高報告** | `/v1/markets/short_selling_positions` | `/v2/markets/short-sale-report` |
| **指数四本値** | `/v1/indices` | `/v2/indices/bars/daily` |
| **TOPIX指数四本値** | `/v1/indices/topix` | `/v2/indices/bars/daily/topix` |
| **財務諸表(BS/PL/CF)** | `/v1/fins/fs_details` | `/v2/fins/details` |
| **財務情報** | `/v1/fins/statements` | `/v2/fins/summary` |
| **配当金情報** | `/v1/fins/dividend` | `/v2/fins/dividend` |
## レスポンス形式
| 項目 | V1 API | V2 API |
| :---------- | :--------- | :---------------------------- |
| **レスポンス構造** | APIによって異なる | 原則としてデータを `"data"` キーの配列として返却 |
```json {{ title: "レスポンス例" }}
{
"data": [
{ ... },
{ ... }
],
"pagination_key": "..."
}
```
### カラム名の変更例（株価四本値）
V2 API では、レスポンスのカラム名が短縮形に変更されている場合があります。以下は株価四本値の例です。
| 項目 | V1 API カラム名 | V2 API カラム名 |
| :--------- | :----------------- | :---------- |
| **日付** | `Date` | `Date` |
| **銘柄コード** | `Code` | `Code` |
| **始値** | `Open` | `O` |
| **高値** | `High` | `H` |
| **安値** | `Low` | `L` |
| **終値** | `Close` | `C` |
| **出来高** | `Volume` | `Vo` |
| **売買代金** | `TurnoverValue` | `Va` |
| **調整後始値** | `AdjustmentOpen` | `AdjO` |
| **調整後高値** | `AdjustmentHigh` | `AdjH` |
| **調整後安値** | `AdjustmentLow` | `AdjL` |
| **調整後終値** | `AdjustmentClose` | `AdjC` |
| **調整後出来高** | `AdjustmentVolume` | `AdjVo` |
| **調整係数** | `AdjustmentFactor` | `AdjFactor` |
---
Source: https://jpx-jquants.com/ja/spec/mkt-breakdown
# 売買内訳データ(/markets/breakdown)
`GET` /v2/markets/breakdown
## APIの概要
東証上場銘柄の東証市場における銘柄別の日次売買代金・売買高（立会内取引に限る）について、信用取引や空売りの利用に関する発注時のフラグ情報を用いて細分化したデータです。
### 本APIの留意点
> **Info**
>
> - 当該銘柄のコーポレートアクションが発生した場合も、遡及して約定株数の調整は行われません。
> - 2020/10/1は東京証券取引所の株式売買システムの障害により終日売買停止となった関係で、データが存在しません。
## 銘柄別の日次売買代金・売買高のデータを取得します
`GET` `https://api.jquants.com/v2/markets/breakdown`
データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。
### パラメータ及びレスポンス
データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, from /to: – → 指定された銘柄について全期間分のデータ
- code: ✓, date: ✓, from /to: – → 指定された銘柄について指定された日付のデータ
- code: ✓, date: –, from /to: ✓ → 指定された銘柄について指定された期間分のデータ
- code: –, date: ✓, from /to: – → 全上場銘柄について指定された日付のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式等の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| from | string | Optional | from の指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | to の指定（e.g. 20210907 or 2021-09-07） |
| date | string | Optional | from と to を指定しないときの日付（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/markets/breakdown
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/breakdown \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/breakdown", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/breakdown",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ----------------------------------------------- |
| Date | string | Required | 売買日（YYYY-MM-DD） |
| Code | string | Required | 銘柄コード |
| LongSellVa | number | Required | 実売りの約定代金 売りの約定代金の内訳 |
| ShrtNoMrgnVa | number | Required | 空売り（信用新規売りを除く）の約定代金 売りの約定代金の内訳 |
| MrgnSellNewVa | number | Required | 信用新規売り（新たな信用売りポジションを作るための売り注文）の約定代金 売りの約定代金の内訳 |
| MrgnSellCloseVa | number | Required | 信用返済売り（既存の信用買いポジションを閉じるための売り注文）の約定代金 売りの約定代金の内訳 |
| LongBuyVa | number | Required | 現物買いの約定代金 買いの約定代金の内訳 |
| MrgnBuyNewVa | number | Required | 信用新規買い（新たな信用買いポジションを作るための買い注文）の約定代金 買いの約定代金の内訳 |
| MrgnBuyCloseVa | number | Required | 信用返済買い（既存の信用売りポジションを閉じるための買い注文）の約定代金 買いの約定代金の内訳 |
| LongSellVo | number | Required | 実売りの約定株数 売りの約定株数の内訳 |
| ShrtNoMrgnVo | number | Required | 空売り（信用新規売りを除く）の約定株数 売りの約定株数の内訳 |
| MrgnSellNewVo | number | Required | 信用新規売り（新たな信用売りポジションを作るための売り注文）の約定株数 売りの約定株数の内訳 |
| MrgnSellCloseVo | number | Required | 信用返済売り（既存の信用買いポジションを閉じるための売り注文）の約定株数 売りの約定株数の内訳 |
| LongBuyVo | number | Required | 現物買いの約定株数 買いの約定株数の内訳 |
| MrgnBuyNewVo | number | Required | 信用新規買い（新たな信用買いポジションを作るための買い注文）の約定株数 買いの約定株数の内訳 |
| MrgnBuyCloseVo | number | Required | 信用返済買い（既存の信用売りポジションを閉じるための買い注文）の約定株数 買いの約定株数の内訳 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2015-04-01",
"Code": "13010",
"LongSellVa": 115164000.0,
"ShrtNoMrgnVa": 93561000.0,
"MrgnSellNewVa": 6412000.0,
"MrgnSellCloseVa": 23009000.0,
"LongBuyVa": 185114000.0,
"MrgnBuyNewVa": 35568000.0,
"MrgnBuyCloseVa": 17464000.0,
"LongSellVo": 415000.0,
"ShrtNoMrgnVo": 337000.0,
"MrgnSellNewVo": 23000.0,
"MrgnSellCloseVo": 83000.0,
"LongBuyVo": 667000.0,
"MrgnBuyNewVo": 128000.0,
"MrgnBuyCloseVo": 63000.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/mkt-cal/holiday-division
# 休日区分
| 項目 | 値 |
| ------------ | - |
| 非営業日 | 0 |
| 営業日 | 1 |
| 東証半日立会日 | 2 |
| 非営業日(祝日取引あり) | 3 |
---
Source: https://jpx-jquants.com/ja/spec/mkt-cal
# 取引カレンダー(/markets/calendar)
`GET` /v2/markets/calendar
## APIの概要
東証およびOSEにおける営業日、休業日、ならびにOSEにおける祝日取引の有無の情報を取得できます。\
配信データは以下のページで公表している内容と同様です。
- 休業日一覧: [https://www.jpx.co.jp/corporate/about-jpx/calendar/index.html](https://www.jpx.co.jp/corporate/about-jpx/calendar/index.html)
- 祝日取引実施日: [https://www.jpx.co.jp/derivatives/rules/holidaytrading/index.html](https://www.jpx.co.jp/derivatives/rules/holidaytrading/index.html)
### 本APIの留意点
> **Info**
>
> - 原則として、毎年3月末頃をめどに翌年1年間の営業日および祝日取引実施日（予定）を更新します。
## 営業日のデータを取得します
`GET` `https://api.jquants.com/v2/markets/calendar`
データの取得では、休日区分（hol\_div）または日付（from/to）の指定が可能です。
### パラメータ及びレスポンス
データの取得では、休日区分（hol\_div）または日付（from/to）の指定が可能です。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- hol\_div: ✓, from /to: – → 指定された休日区分について全期間分のデータ
- hol\_div: ✓, from /to: ✓ → 指定された休日区分について指定された期間分のデータ
- hol\_div: –, from /to: ✓ → 指定された期間分のデータ
- hol\_div: –, from /to: – → 全期間分のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | --------------------------------------------------------------------- |
| hol\_div | string | Optional | 休日区分 指定可能な値の一覧は[こちら](https://jpx-jquants.com/ja/spec/mkt-cal/holiday-division)をご確認ください。 |
| from | string | Optional | from の指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | to の指定（e.g. 20210907 or 2021-09-07） |
### APIコールサンプルコード
/v2/markets/calendar
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/calendar \
-H "x-api-key: {{apiKey}}" \
-d hol_div="{{hol_div}}" \
-d from="{{from}}" \
-d to="{{to}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/calendar", {
params: {
hol_div: '{{hol_div}}',
from: '{{from}}',
to: '{{to}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/calendar",
params={
"hol_div": "{{hol_div}}",
"from": "{{from}}",
"to": "{{to}}",
},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------------------------------------------ |
| Date | string | Required | 日付（YYYY-MM-DD） |
| HolDiv | string | Required | 休日区分 [休日区分](https://jpx-jquants.com/ja/spec/mkt-cal/holiday-division)を参照 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2015-04-01",
"HolDiv": "1"
}
]
}
```
---
Source: https://jpx-jquants.com/ja/spec/mkt-margin-alert/margin-trading-classification
# 東証信用貸借規制区分
| コード | 説明 |
| --- | -------------------------------- |
| 001 | 日本証券金融が実施する貸株注意喚起銘柄および貸株申込制限措置銘柄 |
| 002 | 東京証券取引所が定める日々公表銘柄 |
| 003 | 東京証券取引所が定める規制銘柄 |
| 004 | 東京証券取引所が定める規制銘柄（2次規制） |
| 005 | 東京証券取引所が定める規制銘柄（3次規制） |
| 006 | 東京証券取引所が定める規制銘柄（4次規制） |
| 101 | 東京証券取引所が定める規制解除銘柄 |
| 102 | 東京証券取引所が定める監理銘柄 |
---
Source: https://jpx-jquants.com/ja/spec/mkt-margin-alert
# 日々公表信用取引残高(/markets/margin-alert)
`GET` /v2/markets/margin-alert
## APIの概要
日々公表銘柄に指定された個別銘柄の日々の信用取引残高を取得することができます。\
各銘柄についての信用取引残高（株数）を取得できます。
配信データは下記のページで公表している内容と同一です。\
[https://www.jpx.co.jp/markets/statistics-equities/margin/index.html](https://www.jpx.co.jp/markets/statistics-equities/margin/index.html)
### 本APIの留意点
> **Info**
>
> - 当該銘柄のコーポレートアクションが発生した場合であっても、遡及して約定株数の調整は行われません。
> - 東京証券取引所または日本証券金融が、日次の信用取引残高を公表する必要があると認めた銘柄のみが収録されます。
> - 過誤訂正により過去の日々公表信用取引残高データが訂正された場合は、本APIでは以下のとおりデータを提供します。
> - 訂正前と訂正後のデータのいずれも提供します。訂正が生じた場合には、申込日を同一とするレコードが追加されます。公表日が新しいデータが訂正後、公表日が古いデータが訂正前のデータと識別することが可能です。
## 日々公表信用取引残高を取得します
`GET` `https://api.jquants.com/v2/markets/margin-alert`
データの取得では、銘柄コード（code）または公表日（date）の指定が必須となります。
### パラメータ及びレスポンス
データの取得では、銘柄コード（code）または公表日（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, from /to: – → 指定された銘柄について全期間分のデータ
- code: ✓, date: ✓, from /to: – → 指定された銘柄について指定された公表日のデータ
- code: ✓, date: –, from /to: ✓ → 指定された銘柄について指定された期間分のデータ
- code: –, date: ✓, from /to: – → 全上場銘柄について指定された公表日のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| from | string | Optional | from の指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | to の指定（e.g. 20210907 or 2021-09-07） |
| date | string | Optional | from と to を指定しないときの公表日（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/markets/margin-alert
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/margin-alert \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/margin-alert", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/margin-alert",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ------------- | --------------- | -------- | --------------------------------------------------------------------- |
| PubDate | string | Required | 公表日 |
| Code | string | Required | 銘柄コード |
| AppDate | string | Required | 申込日（YYYY-MM-DD） 信用取引残高の基準となる時点を表します。 |
| PubReason | map | Required | [公表の理由](https://jpx-jquants.com/ja/spec/mkt-margin-alert/publish-reason) |
| ShrtOut | number | Required | 売合計信用残高 |
| ShrtOutChg | number / string | Required | 前日比 売合計信用残高（単位：株） 前日に公表されていない銘柄の場合、「-」を出力します。 |
| ShrtOutRatio | number / string | Required | 上場比 売合計信用残高（単位：％） 売合計信用残高 ÷ 上場株数 × 100 ETF の場合、「」を出力します。 |
| LongOut | number | Required | 買合計信用残高 |
| LongOutChg | number / string | Required | 前日比 買合計信用残高（単位：株） 前日に公表されていない銘柄の場合、「-」を出力します。 |
| LongOutRatio | number / string | Required | 上場比 買合計信用残高（単位：％） 買合計信用残高 ÷ 上場株数 × 100 ETF の場合、「」を出力します。 |
| SLRatio | number | Required | 取組比率（単位：％） 売合計信用残高 ÷ 買合計信用残高 × 100 |
| ShrtNegOut | number | Required | 一般信用取引売残高 売合計信用残高のうち、一般信用によるものです。 |
| ShrtNegOutChg | number / string | Required | 前日比 一般信用取引売残高（単位：株） 前日に公表されていない銘柄の場合、「-」を出力します。 |
| ShrtStdOut | number | Required | 制度信用取引売残高 売合計信用残高のうち、制度信用によるものです。 |
| ShrtStdOutChg | number / string | Required | 前日比 制度信用取引売残高（単位：株） 前日に公表されていない銘柄の場合、「-」を出力します。 |
| LongNegOut | number | Required | 一般信用取引買残高 買合計信用残高のうち、一般信用によるものです。 |
| LongNegOutChg | number / string | Required | 前日比 一般信用取引買残高（単位：株） 前日に公表されていない銘柄の場合、「-」を出力します。 |
| LongStdOut | number | Required | 制度信用取引買残高 買合計信用残高のうち、制度信用によるものです。 |
| LongStdOutChg | number / string | Required | 前日比 制度信用取引買残高（単位：株） 前日に公表されていない銘柄の場合、「-」を出力します。 |
| TSEMrgnRegCls | string | Required | [東証信用貸借規制区分](https://jpx-jquants.com/ja/spec/mkt-margin-alert/margin-trading-classification) |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2024-02-08",
"Code": "13260",
"AppDate": "2024-02-07",
"PubReason":
{
"Restricted": "0",
"DailyPublication": "0",
"Monitoring": "0",
"RestrictedByJSF": "0",
"PrecautionByJSF": "1",
"UnclearOrSecOnAlert": "0"
},
"ShrtOut": 11.0,
"ShrtOutChg": 0.0,
"ShrtOutRatio": "*",
"LongOut": 676.0,
"LongOutChg": -20.0,
"LongOutRatio": "*",
"SLRatio": 1.6,
"ShrtNegOut": 0.0,
"ShrtNegOutChg": 0.0,
"ShrtStdOut": 11.0,
"ShrtStdOutChg": 0.0,
"LongNegOut": 192.0,
"LongNegOutChg": -20.0,
"LongStdOut": 484.0,
"LongStdOutChg": 0.0,
"TSEMrgnRegCls": "001"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/mkt-margin-alert/publish-reason
# 公表の理由
日々公表銘柄の公開理由の各項目の説明です。\
日々公表銘柄に指定されている理由をフラグを用いて示します。
例えば、次のケースでは、東京証券取引所が定める信用取引の規制措置銘柄と、日本証券金融における貸株申込制限措置銘柄に選定されていることを意味します。
```bash
{
"Restricted": 1,
"DailyPublication": 0,
"Monitoring": 0,
"RestrictedByJSF": 1,
"PrecautionByJSF": 0,
"UnclearOrSecOnAlert": 0
}
```
## 各項目の説明
| 変数名 | 意味 |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Restricted | 1 の場合、[東京証券取引所が定める信用取引の規制措置銘柄](https://www.jpx.co.jp/markets/equities/margin-reg/index.html)に選定されていることを意味します。0 の場合、非該当です。 |
| DailyPublication | 1 の場合、[東京証券取引所が定める日々公表銘柄](https://www.jpx.co.jp/markets/equities/margin-daily/index.html)に選定されていることを意味します。0 の場合、非該当です。 |
| Monitoring | 1 の場合、[東京証券取引所が定める特別注意銘柄](https://www.jpx.co.jp/listing/measures/alert/index.html)に選定されていることを意味します。0 の場合、非該当です。 |
| RestrictedByJSF | 1 の場合、[日本証券金融が定める貸株申込制限措置銘柄](https://www.taisyaku.jp/brand/)に選定されていることを意味します。0 の場合、非該当です。 |
| PrecautionByJSF | 1 の場合、[日本証券金融が定める貸株注意喚起銘柄](https://www.taisyaku.jp/brand/)に選定されていることを意味します。0 の場合、非該当です。 |
| UnclearOrSecOnAlert | 1 の場合、[東京証券取引所が定める不明確情報等により注意喚起の対象となった銘柄、特別注意銘柄等](https://www.jpx.co.jp/markets/equities/alerts/index.html)に選定されていることを意味します。0 の場合、非該当です。 |
---
Source: https://jpx-jquants.com/ja/spec/mkt-margin-int-daily
# 信用取引残高
`GET` /v2/markets/margin-interest (scheduled for September 28, 2026)
## APIの概要
全銘柄の信用取引残高（株数・金額）を日次で取得できます。
### 本APIの留意点
> **Info**
>
> - 本APIは2026年9月28日に新仕様での提供を開始予定です。
> - 毎営業日に、Date（申込日付）が前営業日となる信用取引残高を配信します。
> - 名称が類似している[日々公表信用取引残高(/markets/margin-alert)](https://jpx-jquants.com/ja/spec/mkt-margin-alert)は、日々公表銘柄等に指定された銘柄を対象とした残高データであり、本APIとは異なるデータです。
> - 日次の信用取引残高データは2026年9月25日申込分以降で提供されます。2026年9月24日以前は週末時点（通常は金曜日付）のデータのみの収録となります（年末年始など、営業日が2日以下の週のデータは提供されません）。
> - 金額項目（ShrtVal 等の6項目）は2026年9月25日申込分以降のデータでのみ提供されます。それ以前の日付では null が設定されます。
> - 公表日（PubDate）は2026年9月25日申込分以降のデータでのみ提供されます。それ以前の日付では null が設定されます。
> - 公表日（published\_date）での検索では、公表日が収録されていない過去データは返却されません。
> - 当該銘柄のコーポレートアクションが発生した場合も、遡及して株数の調整は行われません。
> - 東証上場銘柄でない銘柄（地方取引所単独上場銘柄）についてはデータの収録対象外となっております。
## 信用取引残高を取得します
`GET` `https://api.jquants.com/v2/markets/margin-interest` (scheduled for September 28, 2026)
データの取得では、銘柄コード（code）、申込日付（date）、公表日（published\_date）のいずれかの指定が必須となります。
### パラメータ及びレスポンス
データの取得では、銘柄コード（code）、申込日付（date）、公表日（published\_date）のいずれかの指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, from /to: –, published\_date: – → 指定された銘柄について全期間分のデータ
- code: ✓, date: ✓, from /to: –, published\_date: – → 指定された銘柄について指定された申込日付のデータ
- code: ✓, date: –, from /to: ✓, published\_date: – → 指定された銘柄について指定された期間分のデータ
- code: –, date: ✓, from /to: –, published\_date: – → 全上場銘柄について指定された申込日付のデータ
- code: –, date: –, from /to: –, published\_date: ✓ → 全上場銘柄について指定された公表日のデータ
- code: ✓, date: –, from /to: –, published\_date: ✓ → 指定された銘柄について指定された公表日のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code**、**date**、**published\_date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式等の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| from | string | Optional | from の指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | to の指定（e.g. 20210907 or 2021-09-07） |
| date | string | Optional | from と to を指定しないときの申込日付（e.g. 20210907 or 2021-09-07） |
| published\_date | string | Optional | 公表日の指定（e.g. 20260928 or 2026-09-28） 申込日付の指定（date / from / to）と同時に指定することはできません（同時に指定した場合は 400 エラーとなります）。 |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/markets/margin-interest
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/margin-interest \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/margin-interest", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/margin-interest",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ---------- | ------ | -------- | ------------------------------------------------------------------------------------------------------ |
| PubDate | string | Required | 公表日（YYYY-MM-DD） 2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
| Date | string | Required | 申込日付 信用取引残高の基準となる時点を表します。 （YYYY-MM-DD） |
| Code | string | Required | 銘柄コード |
| IssType | string | Required | 銘柄区分 1: 信用銘柄、2: 貸借銘柄、3: その他 |
| ShrtVol | number | Required | 売合計信用取引残高（株数） |
| LongVol | number | Required | 買合計信用取引残高（株数） |
| ShrtNegVol | number | Required | 売一般信用取引残高（株数） 売合計信用取引残高（株数）のうち、一般信用によるものです。 |
| LongNegVol | number | Required | 買一般信用取引残高（株数） 買合計信用取引残高（株数）のうち、一般信用によるものです。 |
| ShrtStdVol | number | Required | 売制度信用取引残高（株数） 売合計信用取引残高（株数）のうち、制度信用によるものです。 |
| LongStdVol | number | Required | 買制度信用取引残高（株数） 買合計信用取引残高（株数）のうち、制度信用によるものです。 |
| ShrtVal | number | Required | 売合計信用取引残高（金額） 2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
| LongVal | number | Required | 買合計信用取引残高（金額） 2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
| ShrtNegVal | number | Required | 売一般信用取引残高（金額） 売合計信用取引残高（金額）のうち、一般信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
| LongNegVal | number | Required | 買一般信用取引残高（金額） 買合計信用取引残高（金額）のうち、一般信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
| ShrtStdVal | number | Required | 売制度信用取引残高（金額） 売合計信用取引残高（金額）のうち、制度信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
| LongStdVal | number | Required | 買制度信用取引残高（金額） 買合計信用取引残高（金額）のうち、制度信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2026-09-28",
"Date": "2026-09-25",
"Code": "86970",
"IssType": "2",
"ShrtVol": 257400.0,
"LongVol": 225000.0,
"ShrtNegVol": 242800.0,
"LongNegVol": 81900.0,
"ShrtStdVol": 14600.0,
"LongStdVol": 143100.0,
"ShrtVal": 514800000.0,
"LongVal": 450000000.0,
"ShrtNegVal": 485600000.0,
"LongNegVal": 163800000.0,
"ShrtStdVal": 29200000.0,
"LongStdVal": 286200000.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/mkt-margin-int
# 信用取引週末残高(/markets/margin-interest)
`GET` /v2/markets/margin-interest
## APIの概要
週末時点での、各銘柄についての信用取引残高（株数）を取得できます。
配信データは下記のページで公表している内容と同一です。\
[https://www.jpx.co.jp/markets/statistics-equities/margin/index.html](https://www.jpx.co.jp/markets/statistics-equities/margin/index.html)
### 本APIの留意点
> **Info**
>
> - 本APIは2026年9月28日に新仕様での提供を開始予定です。新仕様の詳細は[こちら](https://jpx-jquants.com/ja/spec/mkt-margin-int-daily)をご覧ください。
> - 当該銘柄のコーポレートアクションが発生した場合も、遡及して株数の調整は行われません。
> - 年末年始など、営業日が2日以下の週はデータが提供されません。
> - 東証上場銘柄でない銘柄（地方取引所単独上場銘柄）についてはデータの収録対象外となっております。
## 信用取引週末残高を取得します
`GET` `https://api.jquants.com/v2/markets/margin-interest`
データの取得では、銘柄コード（code）または申込日付（date）の指定が必須となります。
### パラメータ及びレスポンス
データの取得では、銘柄コード（code）または申込日付（date）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, date: –, from /to: – → 指定された銘柄について全期間分のデータ
- code: ✓, date: ✓, from /to: – → 指定された銘柄について指定された申込日付のデータ
- code: ✓, date: –, from /to: ✓ → 指定された銘柄について指定された期間分のデータ
- code: –, date: ✓, from /to: – → 全上場銘柄について指定された申込日付のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| code | string | Optional | 銘柄コード（e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式等の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| from | string | Optional | from の指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | to の指定（e.g. 20210907 or 2021-09-07） |
| date | string | Optional | from と to を指定しないときの申込日付（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/markets/margin-interest
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/margin-interest \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/margin-interest", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/margin-interest",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ---------- | ------ | -------- | ---------------------------------------------- |
| Date | string | Required | 申込日付 信用取引残高基準となる時点を表します。（通常は金曜日付） （YYYY-MM-DD） |
| Code | string | Required | 銘柄コード |
| ShrtVol | number | Required | 売合計信用残高 |
| LongVol | number | Required | 買合計信用残高 |
| ShrtNegVol | number | Required | 一般信用取引売残高 売合計信用残高のうち、一般信用によるものです。 |
| LongNegVol | number | Required | 一般信用取引買残高 買合計信用残高のうち、一般信用によるものです。 |
| ShrtStdVol | number | Required | 制度信用取引売残高 売合計信用残高のうち、制度信用によるものです。 |
| LongStdVol | number | Required | 制度信用取引買残高 買合計信用残高のうち、制度信用によるものです。 |
| IssType | string | Required | 銘柄区分 1: 信用銘柄、2: 貸借銘柄、3: その他 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-03-24",
"Code": "86970",
"ShrtVol": 123456.0,
"LongVol": 234567.0,
"ShrtNegVol": 11111.0,
"LongNegVol": 22222.0,
"ShrtStdVol": 33333.0,
"LongStdVol": 44444.0,
"IssType": "1"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/mkt-short-ratio
# 業種別空売り比率(/markets/short-ratio)
`GET` /v2/markets/short-ratio
## APIの概要
日々の業種（セクター）別の空売りの売買代金を取得できます。\
配信データは下記のページで公表している内容と同様です。\
[https://www.jpx.co.jp/markets/statistics-equities/short-selling/index.html](https://www.jpx.co.jp/markets/statistics-equities/short-selling/index.html)\
Webページでの公表値は百万円単位に丸められておりますが、APIでは円単位のデータとなります。
### 本APIの留意点
> **Info**
>
> - 取引高が存在しない（売買されていない）日の日付（date）を指定した場合は、値は空です。
> - 2020/10/1は東京証券取引所の株式売買システムの障害により終日売買停止となった関係で、データが存在しません。
## 日々の業種（セクター）別の空売りの売買代金を取得します
`GET` `https://api.jquants.com/v2/markets/short-ratio`
データの取得では、33業種コード（s33）または日付（date）の指定が必須となります。
### パラメータ及びレスポンス
データの取得では、日付（date）または33業種コード（s33）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- s33: –, date: ✓, from/to: – → 全業種コードについて指定された日付のデータ
- s33: ✓, date: –, from/to: – → 指定された業種コードについて、全期間分のデータ
- s33: ✓, date: –, from/to: ✓ → 指定された業種コードについて指定された期間分のデータ
- s33: ✓, date: ✓, from/to: – → 指定された業種コードについて指定された日付のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **s33** または **date** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------- |
| s33 | string | Optional | 33業種コード（e.g. 0050 or 50） |
| from | string | Optional | fromの指定（e.g. 20210901 or 2021-09-01） |
| to | string | Optional | toの指定（e.g. 20210907 or 2021-09-07） |
| date | string | Optional | \*fromとtoを指定しないとき（e.g. 20210907 or 2021-09-07） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/markets/short-ratio
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/short-ratio \
-H "x-api-key: {{apiKey}}" \
-d s33="{{s33}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/short-ratio", {
params: {
s33: '{{s33}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/short-ratio",
params={"s33": "{{s33}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ------------- | ------ | -------- | ----------------------------------------------------------- |
| Date | string | Required | 日付（YYYY-MM-DD） |
| S33 | string | Required | 33業種コード（[33業種コード及び業種名](https://jpx-jquants.com/ja/spec/eq-master/sector33code)を参照） |
| SellExShortVa | number | Required | 実注文の売買代金 |
| ShrtWithResVa | number | Required | 価格規制有りの空売り売買代金 |
| ShrtNoResVa | number | Required | 価格規制無しの空売り売買代金 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2022-10-25",
"S33": "0050",
"SellExShortVa": 1333126400.0,
"ShrtWithResVa": 787355200.0,
"ShrtNoResVa": 149084300.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/mkt-short-sale
# 空売り残高報告(/markets/short-sale-report)
`GET` /v2/markets/short-sale-report
## APIの概要
「有価証券の取引等の規制に関する内閣府令」に基づき、取引参加者より報告を受けたもののうち、残高割合が0.5％以上のものについての情報を取得できます。
配信データは下記のページで公表している内容と同一ですが、より長いヒストリカルデータを利用可能です。\
[https://www.jpx.co.jp/markets/public/short-selling/index.html](https://www.jpx.co.jp/markets/public/short-selling/index.html)
### 本APIの留意点
> **Info**
>
> - 取引参加者から該当する報告が行われなかった日にはデータは提供されません。
> - 「有価証券の取引等の規制に関する内閣府令について」はこちらをご覧ください。[https://www.jpx.co.jp/markets/public/short-selling/01.html](https://www.jpx.co.jp/markets/public/short-selling/01.html)
## 空売り残高報告データを取得します
`GET` `https://api.jquants.com/v2/markets/short-sale-report`
データの取得では、銘柄コード（code）、公表日（disc\_date）、計算日（calc\_date）のいずれかの指定が必須となります。
### パラメータ及びレスポンス
データの取得では、銘柄コード（code）、公表日（disc\_date）、計算日（calc\_date）のいずれかの指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- code: ✓, disc\_date: –, disc\_date\_from/disc\_date\_to: –, calc\_date: – → 指定された銘柄について全期間分のデータ
- code: ✓, disc\_date: ✓, disc\_date\_from/disc\_date\_to: –, calc\_date: – → 指定された銘柄について指定日（公表日）のデータ
- code: ✓, disc\_date: –, disc\_date\_from/disc\_date\_to: ✓, calc\_date: – → 指定された銘柄について指定された期間のデータ
- code: ✓, disc\_date: –, disc\_date\_from/disc\_date\_to: –, calc\_date: ✓ → 指定された銘柄について指定日（計算日）のデータ
- code: –, disc\_date: ✓, disc\_date\_from/disc\_date\_to: –, calc\_date: – → 指定日（公表日）の全ての銘柄のデータ
- code: –, disc\_date: –, disc\_date\_from/disc\_date\_to: –, calc\_date: ✓ → 指定日（計算日）の全ての銘柄のデータ
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **code** / **disc\_date** / **calc\_date** のいずれか一つ以上の指定が必須です。
| Parameter | Type | Required | Description |
| ---------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------- |
| code | string | Optional | 4桁もしくは5桁の銘柄コード（e.g. 8697 or 86970） 4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| disc\_date | string | Optional | 公表日の指定（e.g. 20240301 or 2024-03-01） |
| disc\_date\_from | string | Optional | 公表日のfromの指定（e.g. 20240301 or 2024-03-01） |
| disc\_date\_to | string | Optional | 公表日のtoの指定（e.g. 20240301 or 2024-03-01） |
| calc\_date | string | Optional | 計算日の指定（e.g. 20240301 or 2024-03-01） |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |
### APIコールサンプルコード
/v2/markets/short-sale-report
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/short-sale-report \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d calc_date="{{calc_date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/short-sale-report", {
params: {
code: '{{code}}',
calc_date: '{{calc_date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/short-sale-report",
params={"code": "{{code}}", "calc_date": "{{calc_date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ------------- | ------ | -------- | --------------------------------------------------------------- |
| DiscDate | string | Required | 日付（公表日, YYYY-MM-DD） |
| CalcDate | string | Required | 日付（計算日, YYYY-MM-DD） |
| Code | string | Required | 銘柄コード 5桁コード |
| SSName | string | Required | 商号・名称・氏名 取引参加者から報告されたものをそのまま記載しているため、日本語名称または英語名称が混在しています。 |
| SSAddr | string | Required | 住所・所在地 |
| DICName | string | Required | 委託者・投資一任契約の相手方の商号・名称・氏名 |
| DICAddr | string | Required | 委託者・投資一任契約の相手方の住所・所在地 |
| FundName | string | Required | 信託財産・運用財産の名称 |
| ShrtPosToSO | number | Required | 空売り残高割合 |
| ShrtPosShares | number | Required | 空売り残高数量 |
| ShrtPosUnits | number | Required | 空売り残高売買単位数 |
| PrevRptDate | string | Required | 直近計算年月日（YYYY-MM-DD） |
| PrevRptRatio | number | Required | 直近空売り残高割合 |
| Notes | string | Required | 備考 |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"DiscDate": "2024-08-01",
"CalcDate": "2024-07-31",
"Code": "13660",
"SSName": "個人",
"SSAddr": "",
"DICName": "",
"DICAddr": "",
"FundName": "",
"ShrtPosToSO": 0.0053,
"ShrtPosShares": 140000,
"ShrtPosUnits": 140000,
"PrevRptDate": "2024-07-22",
"PrevRptRatio": 0.0043,
"Notes": ""
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/ja/spec/pagination
# レスポンスのページングについて
APIのレスポンスが大容量になった場合、レスポンスに`pagination_key`が設定される場合があります。`pagination_key`が設定された場合、次のクエリにおいて検索条件を変更せずに`pagination_key`を設定してリクエストを実行することで後続のデータを取得することが可能です。レスポンスの形式は各APIのサンプルコードを参照ください。
/v2/method
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
r_get = requests.get(
"https://api.jquants.com/v2/method?query=param",
headers=headers,
)
data = r_get.json()["data"]
while "pagination_key" in r_get.json():
pagination_key = r_get.json()["pagination_key"]
r_get = requests.get(
f"https://api.jquants.com/v2/method?query=param&pagination_key={pagination_key}",
headers=headers,
)
data += r_get.json()["data"]
```
- クエリに対する全ての該当データを返却するまで、`pagination_key`がレスポンスメッセージに設定されます。`pagination_key`がレスポンスメッセージに設定されない場合はクエリに対する全ての該当データが返却されたことを意味します。
- ページングの都度、`pagination_key`の値は変わります。
- 総件数を返却する項目は提供していません。全件を取得するには、`pagination_key`が返却されなくなるまでリクエストを繰り返してください。
- ページングの途中でデータの更新が行われた場合、取得結果全体の完全な一貫性は保証されません。
---
Source: https://jpx-jquants.com/ja/spec/quickstart
# クイックスタート
J-Quants API を使い始めるまでの流れと、始めるとどんな体験になるかを紹介します。
## 全体の流れ
1. [J-Quants Webサイト](https://jpx-jquants.com/register)からユーザ登録します（無料）。
2. サブスクリプションプランを選びます。無料の Free プランから始められます。
3. ログイン後のダッシュボードにある[クイックスタートガイド](https://jpx-jquants.com/dashboard/quickstart)が、あなたに合った始め方を手順つきで案内します。
> **Note**
>
> APIを利用するためにはFreeプランも含めたいずれかのサブスクリプションプランへの登録が必要です。ユーザ登録とサブスクリプションプランの違いについては
> [FAQ](https://jpx-jquants.com/help/plan)
> を参照ください。
## 始め方は3通り
| 始め方 | 向いている人 |
| ------------------------- | --------------------------------- |
| AIと一緒に進める（おすすめ） | Claude や ChatGPT などのAIツールを普段使っている |
| Colabでコードを組む | Python でコードを書きながらAPIを学びたい |
| ブラウザからファイルをDL（Lightプラン以上） | 画面からCSVを取得して Excel などで使いたい |
いずれもログイン後のダッシュボードにある[クイックスタートガイド](https://jpx-jquants.com/dashboard/quickstart)が手順を案内します。それぞれ、始めるとこんな体験になります。
### AIと一緒に進める（おすすめ）
数コマンドのセットアップを済ませたら、あとは Claude や ChatGPT などのAIツールに日本語で頼むだけです。
```text {{ title: "AIへの依頼例（Lightプラン以上）" }}
J-Quants CLI で過去5年分の株価データを ~/jquants-data にダウンロードして、
毎日夕方に自動で最新分が貯まるように設定して。
```
毎日データが手元に積み上がり、「昨日、出来高が急増した銘柄は？」「決算発表の翌日、株価はどう動きやすい？」といった質問を、自分のデータに日本語で聞けるようになります。
### Colabでコードを組む
環境構築不要のPythonノートブックで、APIを直接叩きながら学べます。
[](https://colab.research.google.com/github/J-Quants/jquants-api-quick-start/blob/master/jquants-api-quick-start-v2.ipynb)
### ブラウザからファイルをDL（Lightプラン以上）
インストール不要。ダッシュボードのダウンロード画面からCSVを取得して、Excel などでそのまま使えます。
## プラン別にできること
取得できるデータの種類と期間はプランによって異なります。
- [データ仕様・提供範囲の一覧](https://jpx-jquants.com/spec/data-spec)
- [料金プラン](https://jpx-jquants.com/ja/#pricing)
## APIを直接使う開発者の方へ
自分のプログラムから HTTP で直接呼び出せます。APIキーはダッシュボードの **\[API Keys]** 画面から発行してください（CLIの `jquants login` を使う場合は自動発行されるため不要です）。
/v2/equities/bars/daily
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/bars/daily \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/bars/daily', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/bars/daily",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
```
株価四本値の詳細を見る
---
Source: https://jpx-jquants.com/ja/spec/rate-limits
# レートリミットについて
J-Quants API には、サービスの安定稼働を目的としてレートリミット（利用頻度の制限）が設けられています。\
一定時間内に上限を超えるリクエストを送信した場合、一時的に API の利用が制限されます。
## プランごとのレートリミット
ご契約のプランによって、1分間あたりのリクエスト数上限が異なります。
| プラン | 上限 (リクエスト / 分) |
| :----------- | :------------- |
| **Free** | 5 |
| **Light** | 60 |
| **Standard** | 120 |
| **Premium** | 500 |
※ 上記は基本となる制限値であり、システムの状況等により調整される場合があります。
## エンドポイントごとのレートリミット
以下のエンドポイントについては、プランにかかわらず個別の制限が適用されます。
| エンドポイント | 上限 (リクエスト / 分) |
| :-------------------------------------- | :------------- |
| **財務情報** (`/v2/fins/summary`) | 60 |
| **財務諸表(BS/PL/CF)** (`/v2/fins/details`) | 60 |
## アドオンごとのレートリミット
アドオンをご契約いただいている場合、アドオン専用のAPIに対して別途レートリミットが適用されます。
| アドオン | 上限 (リクエスト / 分) |
| :--------------- | :------------- |
| **株価 分足・ティック** | 60 |
| **TDnet/適時開示情報** | 100 |
※ アドオン専用APIには、プランのレートリミットとは独立した制限が適用されます。
## 制限を超過した場合
レートリミットを超えてリクエストを行った場合、API は HTTP ステータスコード `429 Too Many Requests` を返します。
### 一時的なアクセス制限
レートリミットを**大幅に超過**してリクエストを継続した場合、5 分程度アクセスが完全に遮断されることがあります。\
この間はすべてのリクエストがエラーとなりますので、アプリケーション側で適切な間隔を空けてリトライする等の制御を実装することを推奨します。
## ベストプラクティス
- **効率的な取得**:
- 必要なデータのみを取得するようにクエリパラメータを活用し、無駄なリクエストを削減してください。
- 多くのAPIでは日付のみの指定で全銘柄のデータを取得いただけます。 1銘柄ずつx全日付での取得を避けてください。
- 過去データの一括取得には[ファイルダウンロード機能](https://jpx-jquants.com/ja/spec/bulk)をご活用ください。
- **エラーハンドリング**: ステータスコード `429` が返ってきた場合は、直ちに再試行するのではなく、一定時間待機してからリクエストを再開してください。
---
Source: https://jpx-jquants.com/ja/spec/release
# リリース
## 2026年
**2026.09.14** \[新機能] \[更新]
### バリュエーション指標APIの提供開始
- 決算短信の開示内容と株価から算出した日次のバリュエーション指標を配信する[バリュエーション指標API](https://jpx-jquants.com/ja/spec/eq-valuation)の提供を開始しました。全プランでご利用いただけます。
- 提供する指標は EPS・FwdEPS・BPS・ROE・FwdROE・PER・FwdPER・PBR の8項目です。実績値は直近12ヶ月（TTM）の純利益、予想値は進行期の予想純利益をもとに算出しています。
- あわせて時価総額（`MktCap`、百万円単位）を収録しています。株価 × 自己株式を控除した株式数で算出しているため、自己株式を含む株式数を用いる[株価四本値](https://jpx-jquants.com/ja/spec/eq-bars-daily)の時価総額とは値が一致しない場合があります。
- Lightプラン以上では、ファイルダウンロード（CSVダウンロード／Bulk API）にも対応しています。
### 【予告】株価四本値APIから時価総額（`MktCap`）を削除します
- [バリュエーション指標API](https://jpx-jquants.com/ja/spec/eq-valuation)の時価総額は、自己株式を控除した株式数を用いて算出しています。
- これに伴い、自己株式を含む株式数で算出している[株価四本値](https://jpx-jquants.com/ja/spec/eq-bars-daily)の時価総額（`MktCap`）は今後削除する予定です。削除の時期は決まり次第あらためてご案内します。
- 時価総額は[バリュエーション指標API](https://jpx-jquants.com/ja/spec/eq-valuation)でご提供しますので、参照先の切り替えをご検討ください。両APIで株式数の定義が異なるため、値が一致しない場合があります。
### 大量保有報告書（EDINET）APIに訂正報告書データを追加し、レスポンス項目として訂正元書類の書類管理番号・報告義務発生日を追加
- [大量保有報告書（EDINET）API](https://jpx-jquants.com/ja/spec/edinet-large-volume-shareholders)のデータに訂正報告書（書類種別コード`360`）を追加しました。
- 訂正報告書は訂正元の書類を置き換えず、別のレコードとして追加されます。
- あわせてレスポンス項目に訂正元書類の書類管理番号（`ParDocId`）を追加しました。大量保有書類種別コード（`LargeHldgTypeCode`）に訂正報告書(`6`)を追加しました。
- レスポンス項目に報告義務発生日（`RptOblgDate`）を追加しました。
**2026.08.24** \[更新]
### 【予告】信用取引週末残高APIの日次化・金額項目の追加（2026年9月28日）
- 2026年9月28日に、[信用取引週末残高API](https://jpx-jquants.com/ja/spec/mkt-margin-int)のデータ提供を週次から日次に変更します。毎営業日に、前営業日の申込データを配信します。
- 日次データは2026年9月25日申込分以降で提供されます。2026年9月24日以前は従来どおり週末時点（通常は金曜日付）のデータのみの収録となります。
- レスポンスに金額6項目（"ShrtVal", "LongVal", "ShrtNegVal", "LongNegVal", "ShrtStdVal", "LongStdVal"）を追加します。
- 金額項目は2026年9月25日申込分以降のデータでのみ提供されます。それ以前の日付ではキーは返却されますが値が null となるため、null を考慮した実装をお願いします。
- レスポンスに公表日（"PubDate"）を追加します（項目順の先頭）。あわせて、公表日（published\_date）でのデータ検索が可能になります。
- 公表日は2026年9月25日申込分以降のデータでのみ提供されます。それ以前の日付ではキーは返却されますが値が null となるため、null を考慮した実装をお願いします。
- レスポンス項目の並び順が変更され、"IssType"（銘柄区分）が "Code" の直後となります。JSON の項目順序に依存しない実装を推奨します。
- 新仕様の詳細は[信用取引残高（新仕様）](https://jpx-jquants.com/ja/spec/mkt-margin-int-daily)のページをご覧ください。
**2026.08.17** \[更新]
### 大株主状況（EDINET）APIに半期報告書・四半期報告書データを追加し、レスポンス項目として当会計期間開始日、終了日を追加
- [大株主状況（EDINET）API](https://jpx-jquants.com/ja/spec/edinet-major-shareholders)のデータに **半期報告書** と **四半期報告書** を追加しました。
- あわせてレスポンスに以下の2項目を追加しました。
- `CurPerSt`（当会計期間開始日）
- `CurPerEn`（当会計期間終了日）
**2026.08.10** \[更新]
### 株価四本値に時価総額・権利落種類を追加
- [株価四本値](https://jpx-jquants.com/ja/spec/eq-bars-daily)のレスポンスに時価総額（`MktCap`）と権利落種類（`ExRT`）を追加しました。全プランで取得できます。
- 時価総額は「終値（調整前）× 上場株式数」で算出し、百万円単位（百万円未満を四捨五入）で収録します。
- 権利落種類は権利落ち日のコーポレートアクション種類をコードで示します（`1`：株式分割、`2`：株式併合、`3`：ライツイシュー）。該当がない日はNullとなります。
**2026.08.03** \[新機能] \[更新]
### 決算発表予定日APIをリリース
- 全プランで取得可能な[決算発表予定日API](https://jpx-jquants.com/ja/spec/fin-earnings-date)をリリースしました。
- 東証上場会社等から東証に対して報告された決算発表予定日を取得できます。
- 銘柄コード・公表日・決算発表予定日のいずれかで検索できます。なお、決算発表予定日による検索では、一度報告された予定日が訂正された場合、現在有効な予定日のみを取得することができます。
- Freeプランは12週間の遅延提供（過去2年分）、Lightプラン以上はプランに応じた期間（5年/10年/20年）でご利用いただけます。
- Lightプラン以上では、ファイルダウンロード（CSVダウンロード／Bulk API）にも対応しています。
- あわせて、従来の翌営業日分のみを提供するAPIの表示名を[決算発表予定日（3・9月期決算会社のみ）](https://jpx-jquants.com/ja/spec/eq-earnings-cal)に変更しました（機能・レスポンスの変更はありません）。
### 財務情報APIに自己資本・自己資本利益率を追加
- 全プランで取得可能な[財務情報API](https://jpx-jquants.com/ja/spec/fin-summary)のレスポンスに、自己資本（連結："ShEq", 非連結："NCShEq"）と自己資本利益率（連結："ROE", 非連結："NCROE"）を追加しました。
- 既存のレスポンス項目・挙動に変更はありません。
**2026.07.13** \[新機能]
### 大量保有報告書（EDINET）APIをリリース
- StandardプランおよびPremiumプランで取得可能な[大量保有報告書（EDINET）API](https://jpx-jquants.com/ja/spec/edinet-large-volume-shareholders)をリリースしました。
- EDINETに提出された大量保有報告書・変更報告書（書類種別コード350）から、提出者・共同保有者ごとの保有株券等の数・株券等保有割合・取得資金の内訳、最近60日間の取得又は処分の状況などを取得できます。
- 発行者（保有対象銘柄）のEDINETコード・銘柄コード・提出日で検索できます。
- 本APIはファイルダウンロード（CSVダウンロード／Bulk API）には対応しておりません。
**2026.07.06** \[新機能]
### 大株主状況・政策保有株式（EDINET）APIをリリース
- StandardプランおよびPremiumプランで取得可能な[大株主状況（EDINET）API](https://jpx-jquants.com/ja/spec/edinet-major-shareholders)をリリースしました。
- 有価証券報告書「大株主の状況」から、大株主の氏名・住所・保有株式数・保有株式割合を取得できます。
- 同じくStandardプランおよびPremiumプランで取得可能な[政策保有株式（EDINET）API](https://jpx-jquants.com/ja/spec/edinet-cross-shareholdings)をリリースしました。
- 有価証券報告書「4 株式の保有状況」から、提出会社・連結最大保有会社・連結第二最大保有会社の3スコープごとに、上場/非上場別の保有株式数とその増減、特定投資株式・みなし保有株式の銘柄明細、注釈テキストを取得できます。
- 特定投資株式・みなし保有株式の銘柄ごとにEdinetCode, SecCodeを付与しています。
- これらのAPIはファイルダウンロード（CSVダウンロード／Bulk API）には対応しておりません。
**2026.06.29** \[更新] \[修正]
### 株価四本値の株価調整対象にライツイシューを追加
- [株価四本値](https://jpx-jquants.com/ja/spec/eq-bars-daily)の株価調整対象に、株式分割・株式併合に加えて新たに「ライツイシュー」を追加しました。
- これに伴い、過去のライツイシューについて正しく調整されていなかった調整済み株価・出来高を修正しました。一部銘柄で過去の調整済みの値が変わります。
- 修正対象(銘柄コード)：17730, 33180, 37500, 38320, 38560, 45410, 57210, 63970, 69930, 77780, 94780
**2026.06.08** \[新機能]
### 財務情報・財務諸表を随時更新に（PremiumプランのAPIのみ）
- Premiumプランをご利用の方について、[財務情報](https://jpx-jquants.com/ja/spec/fin-summary)・[財務諸表(BS/PL/CF)](https://jpx-jquants.com/ja/spec/fin-details)のAPIを随時更新にアップデートしました。（CSVの更新は2回/日のままです）
- `date` に当日を指定してAPIを呼び出した後、レスポンスに含まれる `cursor` を次のリクエストに指定することで、前回取得以降の差分データを取得できます。
- 詳しくは[cursorを使った差分取得](https://jpx-jquants.com/ja/spec/cursor)を参照ください。
**2026.05.26** \[新機能] \[更新]
### 上場銘柄一覧に商品区分を追加
- [上場銘柄一覧](https://jpx-jquants.com/ja/spec/eq-master)のレスポンスに商品区分（ProdCat）を追加しました。
- ETF・REIT等の区別が可能になります。
- 詳しくは[商品区分コード及び商品区分名](https://jpx-jquants.com/ja/spec/eq-master/product-category)を参照ください。
**2026.05.18** \[新機能]
### TDnet/適時開示情報の取得が可能に
- TDnet/適時開示情報アドオンを追加しました。適時開示情報の一覧・ファイル・一括ダウンロードが利用可能です。
- [適時開示インデックス一覧](https://jpx-jquants.com/ja/spec/td-list)
- [適時開示ファイル取得](https://jpx-jquants.com/ja/spec/td-files)
- [適時開示インデックス一括ダウンロード](https://jpx-jquants.com/ja/spec/td-bulk)
**2026.04.13** \[新機能]
### 先物四本値で配信対象先物を拡大
- [先物四本値](https://jpx-jquants.com/ja/spec/drv-bars-daily-fut)で新たに以下の先物データを取得できるようになりました。
- 米ドル/日本円先物
- 中国オフショア人民元/日本円先物
- ユーロ/日本円先物
- 詳しくは[先物商品区分コード](https://jpx-jquants.com/ja/spec/drv-bars-daily-fut/derivative-product-category)を参照ください。
### J-Quants CLI ツールをリリース
- J-Quants API V2 を利用して日本株式市場のデータを取得できるCLIツール `jquants` をリリースしました。
- Homebrew またはバイナリダウンロードでインストールできます。
- 詳しくは[J-Quants CLI](https://jpx-jquants.com/ja/spec/jquants-cli)を参照ください。
**2026.04.06** \[新機能]
### 指数四本値で配信対象指数を拡大
- [指数四本値](https://jpx-jquants.com/ja/spec/idx-bars-daily)で新たに以下の指数を取得できるようになりました。
- 配当込み指数
- JPXスタートアップ急成長100指数
- 詳しくは[配信対象指数コード](https://jpx-jquants.com/ja/spec/idx-bars-daily/indexcodes)を参照ください。
**2026.03.30** \[新機能]
### 取引カレンダーをファイルダウンロードで取得可能
- [取引カレンダー](https://jpx-jquants.com/ja/spec/mkt-cal)のデータをファイルダウンロード（Bulk API）で取得できるようになりました。
- [ダウンロード可能ファイル一覧API](https://jpx-jquants.com/ja/spec/bulk-list)のエンドポイントに `/markets/calendar` が追加されました。[ファイルダウンロード用URL取得API](https://jpx-jquants.com/ja/spec/bulk-get)でエンドポイントに `/markets/calendar` を指定することで、CSV形式のファイルをダウンロードいただけます。
**2026.03.09** \[新機能] \[更新]
### 最新の日付でファイルをダウンロード
- 一つの画面で、その日更新されるデータをダウンロードできるようになりました。APIをご利用でない方も毎日のファイルを簡単にダウンロードできるようになります。
- ログイン後、[最新クイックDL](https://jpx-jquants.com/ja/dashboard/downloads/quick)から各種データのDLをお試しください。
- [ダウンロード可能ファイル一覧API](https://jpx-jquants.com/ja/spec/bulk-list)に、日付のクエリパラメータを追加しました。APIでもその日更新のデータを一回のリクエストで取得できます。
**2026.02.09** \[新機能]
API仕様書の画面に、Markdown形式でページを閲覧いただけるボタンを追加しました。
**2026.01.23** \[修正]
[データ修正履歴](https://jpx-jquants.com/ja/spec/fix-data-info)を更新しました。
**2026.01.19** \[新機能]
株価分足・ティックデータを取得可能になりました。また、Lightプラン以上でCSV形式のファイルダウンロードが可能になりました。
## 2025年
**2025.12.22** \[更新]
LPサイトおよびログイン後画面をリニューアルしました。いままでのメールアドレス・パスワードを引き続きご利用いただけます。[こちらからサインイン](https://jpx-jquants.com/login)してください。また、APIの利用方法が新しくなります。詳しくは[V1 API から V2 API への変更点](https://jpx-jquants.com/ja/spec/migration-v1-v2)をご覧ください。
**2025.10.17** \[新機能]
キャッシュ・フロー計算書を[財務諸表](https://jpx-jquants.com/ja/spec/fin-details)に追加しました。
**2025.08.22** \[新機能]
Standardプラン及びPremiumプランで取得可能な日々公表信用取引残高APIをリリースしました。
**2025.07.18** \[更新]
配当金情報APIの提供データの更新タイミングが変更になりました。
**2025.05.30** \[新機能]
Standardプラン及びPremiumプランで取得可能な空売り残高報告APIをリリースしました。
**2025.05.02** \[修正]
データ修正履歴を更新しました。
**2025.01.27** \[更新]
上場銘柄一覧APIのAPI概要について追記しました。上場銘柄一覧API、株価四本値API、指数四本値API、TOPIX四本値API及び業種別空売り比率APIの提供データの更新タイミングが変更になりました。
## 2024年
**2024.12.03** \[更新]
投資部門別情報APIの留意点に過誤訂正があった際のデータ更新タイミングについて追記しました。
**2024.11.05** \[更新]
株価四本値API、指数四本値API、TOPIX四本値API及び業種別空売り比率APIの提供データの更新タイミングが変更になりました。
**2024.09.20** \[修正]
データ修正履歴を更新しました。
**2024.08.26** \[更新]
現時点で判明している制約事項を更新しました。
**2024.08.20** \[更新]
決算発表予定日の留意事項を更新しました。
**2024.08.16** \[新機能]
Premiumプランで取得可能な先物、オプションの四本値を取得できる新規のAPIをリリースしました。
**2024.08.02** \[修正]
データ修正履歴を更新しました。
**2024.07.22** \[更新]
四半期開示見直し対応に伴い、[財務情報API](https://jpx-jquants.com/ja/spec/fin-summary)の項目に"SignificantChangesInTheScopeOfConsolidation"（期中における連結範囲の重要な変更）が追加されます。
**2024.06.17** \[修正]
データ修正履歴を更新しました。
**2024.03.28** \[新機能]
指数四本値APIに業種別や市場別等の指数を追加しました。取引カレンダーAPIの[提供データの更新タイミング](https://jpx-jquants.com/ja/spec/data-update)が変更になりました。
**2024.02.28** \[修正]
データ修正履歴を更新しました。
## 2023年
**2023.12.20** \[新機能]
各種指数四本値を取得できる新規のAPI(/indices)をStandardとPremiumプラン向けに追加いたしました。
**2023.11.28** \[修正]
株価四本値のデータ項目概要におけるAfternoonTurnoverValueに関する記載漏れを修正しました。
**2023.11.07** \[修正]
データ修正履歴を更新しました。
**2023.10.27** \[更新]
APIからのレスポンスをGzip化するように変更しております。利用パターンによっては解凍処理が必要となる場合がございます。詳細は[こちらのページ](https://jpx-jquants.com/ja/spec/gzip-compression)を参照ください。
**2023.09.22** \[修正]
データ修正履歴を更新しました。
**2023.08.29** \[修正]
財務諸表(BS/PL)の[プランごとに利用可能なAPIとデータ期間](https://jpx-jquants.com/ja/spec/data-spec)を訂正しました。
**2023.08.28** \[新機能]
Premiumプランで取得可能な決算短信の詳細な情報を取得できる新規のAPIをリリースしました。
**2023.06.30** \[新機能]
上場銘柄一覧に、StandardとPremiumプランで取得可能な貸借信用区分を追加しました。
**2023.06.16** \[新機能]
株価四本値にストップ高・ストップ安のフラグを追加しました。データ量の増加に伴いページング対応が必要となる場合があります。ページング方法は[こちらのページ](https://jpx-jquants.com/ja/spec/pagination)を参照ください。
**2023.06.12** \[更新]
今後のリリース予定を更新しました。6月16日にメンテナンス作業に伴う株価四本値APIの利用制限を予定しておりますのでご確認ください。
**2023.06.09** \[更新]
現時点で判明している制約事項を更新しました。
**2023.05.12** \[更新]
今後のリリース予定を更新しました。
**2023.05.08** \[新機能]
営業日カレンダーを取得できる新規のAPIをリリースしました。
**2023.04.27** \[新機能]
ページング機能をリリースしました。今後のリリース予定を更新しました。また、5月10日にメンテナンス作業に伴うAPIの利用制限を予定しておりますので御確認ください。
**2023.04.03** \[重要]
J-Quants API（有償版）を正式にリリースしました。
---
Source: https://jpx-jquants.com/ja/spec/response-status
# レスポンスステータス
J-Quants API へのリクエスト結果は、HTTP ステータスコードで示されます。
処理に成功した場合は `200` が返され、エラーが発生した場合は `400` 番台または `500` 番台のエラーコードが返されます。
エラーレスポンスの Body には、エラーの詳細を示す JSON オブジェクトが含まれる場合があります。
## ステータスコード一覧
| ステータスコード | 名称 | 説明 |
| :------- | :-------------------- | :--------------------------------------------------------------------------------------- |
| **200** | OK | リクエストは成功しました。 |
| **210** | No Content (Partial) | 取得可能時間外または存在しない銘柄コード等の理由で、データが取得できませんでした（前場四本値 API など一部の API で使用されます）。 |
| **400** | Bad Request | リクエストパラメータが不正、または必須パラメータが欠如しています。 |
| **403** | Forbidden | アクセス権限がありません。契約プランに含まれていないデータへのアクセス等の可能性があります。 誤ったapi keyの設定や誤ったリソースパスの指定の場合も403が返却されます。 |
| **429** | Too Many Requests | リクエスト回数が制限（レートリミット）を超過しました。一定時間待機してから再試行してください。 |
| **500** | Internal Server Error | サーバー内部でエラーが発生しました。時間を置いて再試行してください。 |
## 該当データが0件の場合
検索条件に該当するデータが存在しない場合もエラーにはならず、ステータスコード `200` で `data` に空配列が設定されたレスポンスが返却されます。
```json
{
"data": []
}
```
## エラーメッセージの例
エラー時には以下のような JSON 形式で詳細が返却されます。
```json
{
"message": "This API requires at least 1 parameter as follows; date, code"
}
```
---
Source: https://jpx-jquants.com/ja/spec/td-bulk
# TDnet/適時開示インデックス一括ダウンロード(/td/bulk)
`GET` /v2/td/bulk
## APIの概要
過去5年分の適時開示のインデックス情報を収録したCSVファイル（gzip圧縮）のダウンロードURLと最終更新日時を取得できます。\
取得したURLを使用してCSVファイルをダウンロードできます。URLの有効期限は15分です。
### 本APIの留意点
> **Info**
>
> - 本APIはTDnet/適時開示情報アドオンが必要です。
> - CSVには過去5年分の開示情報が含まれます。
> - ダウンロードURLの有効期限は15分です。
> - CSVファイルはgzip形式で圧縮されています。
> - ファイルの更新を通知するWebhookは提供していません。
## 適時開示インデックスの一括ダウンロードURLを取得します
`GET` `https://api.jquants.com/v2/td/bulk`
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
クエリパラメータはありません。
### APIコールサンプルコード
/v2/td/bulk
**cURL**
```bash
curl -G https://api.jquants.com/v2/td/bulk \
-H "x-api-key: {{apiKey}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/td/bulk')
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/td/bulk",
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ---------------------------------------------------- |
| lastUpdated | string | Required | CSVファイルの最終更新日時（ISO 8601形式、e.g. 2025-04-01T08:00:00Z） |
| url | string | Required | CSVファイル（gzip圧縮）のダウンロードURL |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"lastUpdated": "2025-04-01T08:00:00Z",
"url": "https://example.com/download-url-bulk-csv"
}
```
## CSVデータ項目
| Parameter | Type | Required | Description |
| ---------- | ------ | -------- | ------------------------------------------------------ |
| DiscNo | string | Required | 開示番号（14桁） |
| Code | string | Required | 銘柄コード |
| Name | string | Required | 会社名 |
| DiscDate | string | Required | 開示日（YYYY-MM-DD） |
| DiscTime | string | Required | 開示時刻（HH:MM） |
| Title | string | Required | 開示タイトル |
| DiscStatus | string | Required | 取扱属性（null: 新規開示情報、'revision': 訂正開示情報、'delete': 削除開示情報） |
| RevNo | string | Required | 開示履歴番号（1～99） |
| DiscItems | string | Required | 公開項目コード（`\|` 区切り） |
| Docs | string | Required | 添付書類種別（`\|` 区切り）（g: 全文情報PDF、s: サマリ情報PDF、x: XBRL関連ファイル） |
## CSVデータサンプル
```csv
DiscNo,Code,Name,DiscDate,DiscTime,Title,DiscStatus,RevNo,DiscItems,Docs
20250401130100,86970,日本取引所グループ,2025-04-01,08:00,2025年3月期 決算短信〔日本基準〕（連結）,,1,11101,g|s|x
20250401130200,86970,日本取引所グループ,2025-04-01,09:00,2025年3月期 有価証券報告書,,1,11102,g|x
```
---
Source: https://jpx-jquants.com/ja/spec/td-files
# TDnet/適時開示ファイル取得(/td/files)
`GET` /v2/td/files
## APIの概要
開示番号（discNo）に対応するファイルのダウンロードURLを取得できます。\
取得したURLを使用してPDFやXBRLファイルをダウンロードできます。URLの有効期限は15分です。
### 本APIの留意点
> **Info**
>
> - 本APIはTDnet/適時開示情報アドオンが必要です。
> - データ取得可能期間は過去5年間です。
> - ダウンロードURLの有効期限は15分です。
## 適時開示ファイルのダウンロードURLを取得します
`GET` `https://api.jquants.com/v2/td/files`
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
| discNo | string | Required | 開示番号（14桁）（e.g. 20250401130100） |
| docs | string | Optional | 取得するファイルの種類（カンマ区切りで複数指定可能） g: 全文情報PDF、s: サマリ情報PDF、x: XBRL関連ファイル 省略時は全種類を返却します（e.g. g or g,s,x） |
### APIコールサンプルコード
/v2/td/files
**cURL**
```bash
curl -G https://api.jquants.com/v2/td/files \
-H "x-api-key: {{apiKey}}" \
-d discNo="{{discNo}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/td/files', {
params: {
discNo: '{{discNo}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/td/files",
params={"discNo": "{{discNo}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| ---------------- | ------ | -------- | -------------------- |
| discNo | string | Required | 開示番号（14桁） |
| files | object | Required | ファイルのダウンロードURL一覧 |
| files.pdf | string | Required | 全文情報PDFのダウンロードURL |
| files.summaryPdf | string | Required | サマリ情報PDFのダウンロードURL |
| files.xbrl | string | Required | XBRL関連ファイルのダウンロードURL |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"discNo": "20250401130100",
"files": {
"pdf": "https://example.com/download-url-pdf",
"summaryPdf": "https://example.com/download-url-summary",
"xbrl": "https://example.com/download-url-xbrl"
}
}
```
---
Source: https://jpx-jquants.com/ja/spec/td-list
# TDnet/適時開示インデックス一覧(/td/list)
`GET` /v2/td/list
## APIの概要
適時開示のインデックス情報（開示番号・日時・タイトルなど）の一覧を取得できます。\
日付またはコードを指定してデータを取得します。
### 本APIの留意点
> **Info**
>
> - 本APIはTDnet/適時開示情報アドオンが必要です。
> - データ取得可能期間は過去5年間です。
> - 開示情報の更新を通知するWebhookは提供していません。当日の差分取得には[cursorを使った差分取得](https://jpx-jquants.com/ja/spec/cursor)をご利用ください。
> - 適時開示情報が訂正・削除された場合、現仕様では以下のように振る舞います。
> - 適時開示ファイルの題目が訂正された場合、当APIで取得される情報にその訂正内容は反映されません。
> - 適時開示ファイル自体が訂正された場合、新規の開示番号が割り振られ新規レコードとして扱われます。
> - 適時開示情報が削除された場合でも、当APIはその適時開示情報を取得可能です。
> - 現仕様では、DiscStatusは常にNull、RevNoは常に1が格納されます。
## 適時開示インデックス一覧を取得します
`GET` `https://api.jquants.com/v2/td/list`
データの取得では、日付（date）または銘柄コード（code）の指定が必須となります。
### パラメータ及びレスポンス
データの取得では、日付（date）または銘柄コード（code）の指定が必須となります。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
- date: ✓, code: –, from/to: – → 指定された日付の開示一覧
- date: –, code: ✓, from/to: – → 指定された銘柄の開示一覧（直近5年間）
- date: –, code: ✓, from/to: ✓ → 指定された銘柄の指定期間の開示一覧
### cursorを使った開示情報の取得
cursorを使ったリアルタイム差分取得の仕様については、[cursorを使った差分取得](https://jpx-jquants.com/ja/spec/cursor)をご参照ください。
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー |
### Query Parameters
> **Note**
>
> **date** または **code** のいずれか一つの指定が必須です。
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| date | string | Optional | 開示日（e.g. 20250401 or 2025-04-01） |
| code | string | Optional | 銘柄コード（e.g. 13010 or 1301） |
| from | string | Optional | 取得開始日（e.g. 20250301 or 2025-03-01） code と組み合わせて使用します。to と必ずペアで指定してください。 |
| to | string | Optional | 取得終了日（e.g. 20250401 or 2025-04-01） code と組み合わせて使用します。from と必ずペアで指定してください。 |
| discItems | string | Optional | 公開項目コードで絞り込む（カンマ区切りで複数指定可能、AND条件）（e.g. 11101 or 11101,11102） 公開項目コードの一覧は[TDnet API仕様書の付録1](https://www.jpx.co.jp/markets/paid-info-listing/tdnet/co3pgt0000005o97-att/tdnetapi_specifications.pdf)を参照してください。 |
| cursor | string | Optional | 本日どの開示情報まで取得したかを保持するカーソル 前回のレスポンスで返却された cursor を指定することで前回のリクエスト以降に配信されたデータを取得できます。pagination\_key と同時指定不可。 |
| pagination\_key | string | Optional | ページネーションキー 前回のレスポンスで返却された pagination\_key を指定します。cursor と同時指定不可。 |
### APIコールサンプルコード
/v2/td/list
**cURL**
```bash
curl -G https://api.jquants.com/v2/td/list \
-H "x-api-key: {{apiKey}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/td/list', {
params: {
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/td/list",
params={"date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### データ項目概要
| Parameter | Type | Required | Description |
| --------------- | --------- | -------- | ------------------------------------------------------------------ |
| DiscNo | string | Required | 開示番号（14桁） |
| Code | string | Required | 銘柄コード |
| Name | string | Required | 会社名 |
| DiscDate | string | Required | 開示日（YYYY-MM-DD） |
| DiscTime | string | Required | 開示時刻（HH:MM） |
| Title | string | Required | 開示タイトル |
| DiscStatus | string | Required | 取扱属性（null: 新規開示情報、'revision': 訂正開示情報、'delete': 削除開示情報） |
| RevNo | number | Required | 開示履歴番号（1～99） |
| DiscItems | string\[] | Required | 公開項目コードのリスト |
| Docs | string\[] | Required | 書類タイプのリスト（g: 全文情報PDF、s: サマリ情報PDF、x: XBRL関連ファイル） |
| cursor | string | Required | 本日どの開示情報まで取得したかを保持するためのコード（dateに当日を指定し、かつページネーションなしで全件取得できた場合のみ返却） |
| pagination\_key | string | Required | ページネーションキー |
### レスポンスサンプル
```bash {{ title: "200:OK" }}
{
"data": [
{
"DiscNo": "20250401130100",
"Code": "86970",
"Name": "日本取引所グループ",
"DiscDate": "2025-04-01",
"DiscTime": "08:00",
"Title": "2025年3月期 決算短信〔日本基準〕（連結）",
"DiscStatus": null,
"RevNo": 1,
"DiscItems": ["11101"],
"Docs": ["g", "s", "x"]
}
],
"cursor": "eyJkIjoiMjAyNS0wNC0wMSIsInQiOiIyMDI1LTA0LTAxVDA4OjAwOjAwWiMyMDI1MDQwMTEzMDEwMCJ9"
}
```
---
Source: https://jpx-jquants.com/ja/help/about
# サービスについて (FAQ)
## J-Quants APIはどのようなことができるサービスですか？
J-Quants APIでは、ヒストリカルの株価（四本値）や出来高、財務数値といった金融データをAPIで取得できるサービスです。個人の方にとって入手が難しかった、整形された金融データを取得しやすくすることを目指しています。機関投資家と同等のデータセットを個人にもお届けする、データを民主化するサービスです。
## J-Quants APIではどのようなデータが提供されていますか？
現在提供されているデータは[提供データ一覧](https://jpx-jquants.com/ja/#dataset)をご覧ください。
## J-Quants APIの使い方がわかりません。はじめに何をすればよいですか？
はじめての方は[クイックスタートガイド](https://jpx-jquants.com/ja/spec/quickstart)をご参照ください。基本的な流れは以下のとおりです。詳細は[API仕様書](https://jpx-jquants.com/ja/spec/data-spec)もあわせてご確認ください。
- アカウント作成・サインイン
- ダッシュボードの「API Keys」画面からAPIキーを発行・取得
- 各データエンドポイントへのリクエストヘッダーに `x-api-key: ` を付与してリクエスト
## APIではなく、CSVなどファイル形式でデータを取得することは可能ですか？
CSVのダウンロードが可能です（Freeプランの方は取引カレンダーのみご利用いただけます）。[ファイルダウンロードについて](https://jpx-jquants.com/ja/spec/bulk)からご確認ください。
## J-Quants APIで提供されていないデータはどこで入手できますか？
J-Quants APIで提供していないデータやご利用形態については、[J-Quants DataCube](https://dc.jpx-jquants.com) または [J-Quants Pro](https://pro.jpx-jquants.com) で提供している場合があります。提供有無や詳細は各サービスのサイトにてご確認ください。
- データ提供期間外のデータ → J-Quants DataCube
- 法人利用・学術研究利用 → J-Quants Pro
## データの更新タイミングはいつですか？
データ種別によって異なります。詳細は[データ更新スケジュール](https://jpx-jquants.com/ja/spec/data-update)や[各エンドポイントの仕様書](https://jpx-jquants.com/ja/spec/data-spec)をご確認ください。
- 株価四本値: 営業日の大引け後に当日分が更新
- 財務情報: 18:00と24:30に更新（PremiumプランのAPIは随時更新）
- 銘柄一覧（equities/master）: 翌営業日時点の情報は17時半以降に取得可能
## APIのレート制限（リクエスト上限）はありますか？
プランごとに1分あたりのリクエスト数上限が設定されています。レート制限を超えた場合は 429 Too Many Requests エラーが返されます。時間をおいてから再度リクエストしてください。詳細は[レートリミットについて](https://jpx-jquants.com/ja/spec/rate-limits)をご確認ください。
- Free: 5回/分
- Light: 60回/分
- Standard: 120回/分
- Premium: 500回/分
## リクエストパラメータに日付を指定するとエラーになります。
日付パラメータは YYYYMMDD 形式（例: 20240101）または YYYY-MM-DD 形式（例: 2024-01-01）で、実在するカレンダー上の日付を指定してください。存在しない日付（例: 20240230）を指定するとエラーになります。
## 403エラーで「invalid or expired」というメッセージが返されます。
APIキーが正しく送信できていない可能性があります。以下の点をご確認ください。
- `x-api-key` ヘッダーと `Authorization` ヘッダーを同時に送信していないか（同時送信はできません。V2では `x-api-key` ヘッダーのみを使用してください）
- APIキーに余分な空白や改行が混入していないか
- エラーの切り分けとして、ステータスコードもご確認ください。400エラーはリクエストパラメータの誤り、429エラーはレート制限の超過が原因であり、403とは原因が異なります
## ユーザー登録したのに確認メールが届きません。
すでにユーザー登録が完了している場合があります。[サインインページ](https://jpx-jquants.com/ja/login)からメールアドレス・パスワードでサインインをお試しください。メールが見当たらない場合は、迷惑メールボックスもご確認ください。
## V1のAPIエンドポイントは使えますか？
J-Quants APIはV1からV2に切り替わり、認証方式が「トークン方式」から「APIキー方式」に変更されました。V1は閉鎖済みのため、すべてのユーザーはV2のみご利用いただけます。V2では `x-api-key` ヘッダーにAPIキーを付与してリクエストしてください。詳細は[V1→V2の変更点](https://jpx-jquants.com/ja/spec/migration-v1-v2)や[クイックスタートガイド（V2認証）](https://jpx-jquants.com/ja/spec/quickstart)をご参照ください。
## V1で使っていたエンドポイントのV2対応エンドポイントを教えてください。
主要エンドポイントのV1→V2対応関係は以下のとおりです（一部抜粋）。なおV2ではレスポンスのカラム名も短縮形に変更されている項目があります（例：株価の `Open` → `O`、`Close` → `C`）。完全な対応表は[V1→V2の変更点](https://jpx-jquants.com/ja/spec/migration-v1-v2)でご確認いただけます。
- 株価四本値: /v1/prices/daily_quotes → /v2/equities/bars/daily
- 上場銘柄一覧: /v1/listed/info → /v2/equities/master
- 財務情報: /v1/fins/statements → /v2/fins/summary
- 財務諸表(BS/PL/CF): /v1/fins/fs_details → /v2/fins/details
- 取引カレンダー: /v1/markets/trading_calendar → /v2/markets/calendar
- 業種別空売り比率: /v1/markets/short_selling → /v2/markets/short-ratio
- 指数四本値: /v1/indices → /v2/indices/bars/daily
## V1のサンプルコード（`auth_user` / `auth_refresh` を使うもの）が動かなくなりました。
V1の `/v1/token/auth_user`・`/v1/token/auth_refresh` エンドポイントは廃止されました。V2ではダッシュボードで発行したAPIキーをリクエストヘッダー `x-api-key` に指定する方式に変更されています。お手元のサンプルコードの認証部分を以下のように書き換えてください。詳細は[V1→V2の変更点](https://jpx-jquants.com/ja/spec/migration-v1-v2)や[クイックスタートガイド](https://jpx-jquants.com/ja/spec/quickstart)もご参照ください。
- 旧（V1）: auth_user でリフレッシュトークン取得 → auth_refresh でIDトークン取得 → Authorization: Bearer を付与
- 新（V2）: ダッシュボードからAPIキー取得 → x-api-key: を付与
---
Source: https://jpx-jquants.com/ja/help/usage
# 利用目的・ライセンス (FAQ)
## J-Quants APIはどのような用途で利用できますか？
J-Quants APIは個人の方の私的利用に限定したサービスです。法人による利用や、個人の方であってもデータの第三者配信やデータを利用したアプリの提供などは、営利・非営利を問わず利用は禁止されています。法人でのご利用や外部配信は [J-Quants Pro](https://pro.jpx-jquants.com)をご利用ください。
## 私的利用とはどのような利用を指しますか？
私的利用とは、ご自身の投資分析のための利用やポートフォリオ管理等を指します。本データを用いて投資分析した結果を、継続反復して第三者に提供・配信する行為は私的利用に該当しません。第三者から提供されるポートフォリオ管理等サービスに本データを利用することは可能ですが、本データを第三者が閲覧できる状態である時には私的利用には該当しませんのでご注意ください。
## 社内限定・非営利目的であれば法人でも利用できますか？
できません。社内限定・非営利目的であっても、法人でのJ-Quants APIのご利用はできません。法人でのご利用は[J-Quants Pro](https://pro.jpx-jquants.com)をご検討ください。
## ブログやインターネット記事にJ-Quants APIのデータを利用することはできますか？
ご自身の分析結果や分析手法を公開いただくことは構いません。ただし、J-Quants APIで取得したデータそのものを閲覧できる形で配布・シェアすることは禁止されていますのでご注意ください。また、本データを用いて投資分析した結果を継続反復して第三者に提供・配信する行為は私的利用に該当しません。
## 取得データの分析結果（グラフ等）をWebサイトやSNSで公開できますか？
生データの直接配布・シェアは禁止されていますが、分析結果（チャート・グラフ・レポート等）の共有は可能です。ただし、分析結果を「継続反復的に」公開・共有される場合は私的利用と認められません。（例：YouTube等での反復継続的な配信は私的利用に非該当）なお、非公開の個人利用の範囲であれば、出典の表記は不要です。書籍等の商業出版に分析結果を利用される場合は、個別の確認が必要ですのでお問い合わせください。
## 分析結果をYouTube動画で公開してもよいですか？広告収益がある場合は営利目的になりますか？
ご自身の分析結果・手法の公開は差し支えありません。ただし、生データを視聴者が閲覧できる形での表示はお控えください。また、分析結果を継続反復して第三者に提供・配信する行為は私的利用に該当しません。YouTube広告収益のみをもって直ちに「営利目的」とはなりませんが、上記条件を満たすことが前提です。
## J-Quants APIを組み込んだアプリを他のユーザーに公開・配布することはできますか？
以下のケースは私的利用には該当しないため、禁止されています。
- J-Quantsデータそのものや分析結果をユーザー間で共有・公開する機能を設ける場合
- アプリ運営者側のサーバーにJ-Quants由来のデータが蓄積・中継される構成となる場合
以下の2点を満たす設計であれば、規約上問題ございません。
- アプリを利用する各ユーザーが、それぞれ個別にJ-Quants APIを契約し、各自のAPIキーを使ってデータを取得する構成であること
- 取得したデータおよび分析結果が、そのユーザー本人以外に開示されない構成であること
なお、各ユーザーが自身のAPIキーを利用する構成でアプリを提供する場合は、以下の点にご留意ください。
- アプリの紹介ページおよび利用規約に、各ユーザーが個別にJ-Quants APIを契約し各自のAPIキーでデータを取得する構成であることを記載してください
- J-Quantsのロゴの使用や、「公式」「提携」「Powered by」等の当社との関係を示唆する表現は禁止されています
## 卒論の執筆には利用できますか？
学術利用に関しては、学生の方の自身の卒業論文の執筆に限って利用することは可能ですが、授業・ゼミ等でのクラス・集団による利用、教職員の方による授業・指導を目的とする利用、および研究者としての論文執筆・学会発表等を目的とした利用は禁止されています。これら利用をご予定の方につきましては[J-Quants Pro](https://pro.jpx-jquants.com)をご利用ください。
## 契約期間中、取得したデータを外部クラウドなどに保存してもよいですか？
ご本人のみが閲覧可能な状態であれば、ご本人が管理する外部クラウドへの保存も可能です。保存するデータの数・保存場所について個別の指定はありませんが、第三者が閲覧できない状態を維持できるよう、アクセス制御や暗号化などの管理はご自身の責任で適切に行ってください。なお、解約（退会）やプランのダウングレード後には、保存したデータおよびその複製物、元データを復元（リバースエンジニアリング）できる派生物の削除をお願いいたします。元データを復元できない派生物は、外部に配信・公開しない限り削除は不要です。
## 取得したデータを生成AIに入力して分析することはできますか？
以下の4つの条件をすべて満たす場合には、私的利用の範囲内としてご利用いただけます。各条件を満たしているか（生成AIサービス側の規約・学習利用設定・データの取扱い）はご自身でご確認のうえ、判断に迷う場合はお問い合わせください。
- ご自身の分析目的での利用であること
- 入力したデータがAIの学習に二次利用されない設定であること
- 入力したデータを第三者が閲覧できないこと
- 生成された結果を配信・公開しないこと
## サブスクリプションのキャンセルまたは退会後に、データを利用することは可能ですか？
できません。J-Quants APIはデータ販売ではなく、データを利用するサービスですので、サブスクリプションのキャンセルまたは退会後は、それまでに取得したデータおよびその複製物、ならびに元データを復元（リバースエンジニアリング）できる派生物をすべて削除していただく必要があります。なお、元データを復元できない派生物（学習済みモデルの重み等）は、外部に配信・公開しない限り削除は不要です。
## プラン変更後、変更前のプランのデータを利用することは可能ですか？
J-Quants APIはデータ販売ではなく、データを利用するサービスですので、プラン変更後にはそれまで上位プランで取得したデータ利用はできません。上位プランで取得したデータおよびその複製物、元データを復元（リバースエンジニアリング）できる派生物の削除をお願いいたします。なお、元データを復元できない派生物は、外部に配信・公開しない限り削除は不要です。
## 解約（退会）やプランのダウングレード後は、取得データから作成したモデルや集計値も削除する必要がありますか？
解約（退会）やプランのダウングレード後には、取得したデータおよびその複製物、元データを復元（リバースエンジニアリング）できる派生物の削除をお願いいたします。なお、元データを復元できない派生物は、外部に配信・公開しない限り削除は不要です。
---
Source: https://jpx-jquants.com/ja/help/plan
# プラン・変更・キャンセルと退会 (FAQ)
## 各プランの料金や利用可能なデータを教えてください。
各プランの料金や利用可能なデータについては[プラン別データ仕様](https://jpx-jquants.com/ja/spec/data-spec)をご確認ください。Freeプラン（無料）でも一部のデータをお試しいただけます。
## どのようなサブスクリプションプランがありますか？
①無料プラン、②ライトプラン、③スタンダードプラン、④プレミアムプランの4つのベースプランをご用意しています。またベースプランでは取得できない追加データを取得できるアドオンプランもございます。アドオンプランの追加には、ライトプラン以上の有料プランのご利用が必要です。詳しくは[プラン表](https://jpx-jquants.com/ja/#pricing)をご覧ください。
有償プランのご利用には、サインアップ時にクレジットカードの登録が必要となります。
## ユーザ登録とサブスクリプションプラン選択の違いを教えてください。
J-Quantsへの登録ではサンプルデータを取得できるようになりますが、日々のデータを取得するためにはプランを選択する必要があります。
## 無料プランでは当日の株価を取得できないのでしょうか？
できません。無料プランではデータは12週間遅延して配信されます。
## 無料プランの利用期限について教えてください。
無料プランは1年間に限って利用可能のため、お客様の無料プランは1年後に自動で解約されます。
1年後に解約された無料プランは、再度ご登録いただくことで利用可能です。
## アドオンプランだけを利用することは可能ですか？
アドオンプランのご利用には、ライトプラン以上のご利用が必要です。アドオンプラン単体でのご利用はできません。
## 支払いはどのように行いますか？
全て月額プランであり、毎月の利用料がクレジットカードから引き落とされます。
支払いはストライプジャパンを利用して行われます。
お客様のクレジットカード情報はストライプジャパンにて取り扱われ、当社が閲覧することはありません。
## クレジット残高の金額はどのようにして確認できますか？
サブスクリプションプラン変更により発生・使用したクレジットは、領収書・請求書上でご確認いただけます。領収書・請求書は、ダッシュボードの「Billing」画面から遷移できるStripeカスタマーポータルにてご確認ください。
## 覚えのない請求がありました。
ご契約状況を確認いたしますので、お問い合わせフォームより以下の情報をお知らせください。
- ご登録のメールアドレス
- 請求が確認された日付・金額
- 現在のご契約プラン
## クレジットカードで決済が通りません（認証エラーが出ます）。
J-Quants APIの決済はStripe社を利用しています。以下をご確認ください。上記をご確認いただいても解消しない場合は、別のカードをお試しいただくか、カード会社に直接お問い合わせください。
- カード情報（番号・有効期限・セキュリティコード）が正確か
- カードの利用限度額に余裕があるか
- カード会社でオンライン決済の制限が設定されていないか
- 3Dセキュア認証が求められる場合はSMS認証等を完了してください
## プランの変更は可能ですか？
プランの変更はいつでも可能です。ベースプランの変更については、上位プランへのアップグレードは回数制限はありませんが、下位プランへのダウングレードは月に1回のみです。
ベースプランの中でサブスクリプションプランを変更した場合には、即時に反映され、新プランとの差額が日割りで請求されます。
有料プランの請求サイクル期間中に下位プランに変更された場合には、残りの期間に応じたクレジット残高が払い出されます。クレジット残高は次回以降の有料プランのお支払いにご利用いただけます。
## プランをダウングレードしたら即時切り替わり、上位プランの残り期間が使えなくなりました。
プランのダウングレードは変更手続き完了時点で即時適用されます。残り期間に応じたクレジット残高が払い出され、次回以降のお支払いにご利用いただけます。次月から下位プランをご希望の場合は「ダウングレード」ではなく「キャンセル」を選択し、請求期間終了後に改めてお申込みいただくことをお勧めします。
## プランのキャンセル方法を教えてください。
ダッシュボードの「Subscription」画面から「プランのキャンセル」を選択してください。キャンセルは請求期間終了時に適用され、それまでは現プランを継続利用できます。
## サブスクリプションのキャンセルは可能ですか？
キャンセルはいつでも可能です。プランは請求期間の終了時にキャンセルされますので、キャンセルを指示した日から請求期間の終了日までは引き続きご利用いただけます。なお、日割りでの返金は行われません。
## プランをキャンセルしましたが、キャンセルを取り消して利用を継続したいです。
プランキャンセルのお申し込み後、キャンセル適用日以前でしたらキャンセルを取り消すことが可能です。ダッシュボードの「Subscription」画面にて「キャンセルを取り消す」ボタンを選択いただくと、プランのキャンセルを取り消すことができます。取り消し後は、通常の請求サイクルにてプランが更新されます。
## ベースプラン解約後もアドオンプランを利用できますか？
アドオンプランは有料のベースプランの契約が必要です。
有料のベースプランのキャンセルが適用された場合、または有料のベースプランからFreeプランへ変更された場合、アドオンプランは次回更新日に自動でキャンセルされます。
アドオンプランのキャンセル適用日までは引き続きご利用いただけます。
## 退会とサブスクリプションプランのキャンセルの違いはなんですか？
サブスクリプションプランのキャンセルでは、サブスクリプションプランを利用できなくなりますが、J-Quants APIにはユーザ情報が残っており、J-Quants APIサイトにログイン可能な状態となります。
退会はJ-Quants APIの全てのサービスからユーザ情報を消去しますので、J-Quants APIサイトへのログインもできなくなります。
## 退会するにはどうすればよいですか？
以下の手順で退会手続きを行ってください。退会するとJ-Quants APIの個人情報が削除され、支払済み請求書等の情報にもアクセスできなくなります。なお、「キャンセル」はプランのみ停止でユーザー情報は残りますが、「退会」はすべての情報が消去されます。
- J-Quants APIサイトへログイン
- ダッシュボードの「Profile」画面を開く
- 画面下部の「退会手続きを進める」ボタンより手続きを実施
## 退会はいつでも可能ですか？
退会はいつでも可能です。退会される場合、J-Quants APIで利用する個人情報が消去されます。退会後には支払い済請求書など、一切の情報にアクセスできなくなりますのでご注意ください。退会は、ログイン後の「Profile」画面下部の「退会手続きを進める」ボタンより退会可能です。
退会されると保持しているクレジット残高も無くなりますのでご注意ください。
---
Source: https://jpx-jquants.com/ja/help/payment
# お支払い・請求 (FAQ)
## クレジットカードがないと登録できませんか？
クレジットカードでのお支払いのみ可能です。なお、無料プランもStripe Checkout経由での登録となりますが、無料プランの登録にカード情報の入力は不要です。
## クレジットカードの登録画面（認証画面）が開かず、登録できません。
クレジットカードの認証画面はポップアップとして表示されるため、ブラウザのポップアップブロック機能で表示が妨げられている可能性があります。以下をお試しください。
- ブラウザのポップアップブロックを当サイト（jpx-jquants.com）に対して許可
- Chrome / Safari / Firefox など別のブラウザでお試し
- 別のデバイス（PC / スマートフォン）でお試し
- それでも解消しない場合は、別のカードでお試しください
## 請求サイクルについて教えてください。
月額利用料は、有料プラン登録日を起点とした1ヶ月ごとのサイクルで請求されます。初回の支払いは有料プラン登録時に実施され、次回支払いは翌月の同日となります（翌月に同日がない場合は、翌月末日となります）。
例えば、4/25にご契約いただいた場合、有効期間は4月末までではなく、翌月の同日である5/25までとなります。次回の請求も5/25に行われ、以降毎月25日が請求日となります。
## クレジットカードの支払いにかかる確認メールが届きました。
不正利用防止のため、クレジットカード会社からカードの利用にかかる確認メールが届く場合がございます。J-Quants APIにサインイン後、ポータルからクレジットカードの確認を行なってください。
## クレジットカードの支払いに失敗したところ、プランが解約されました。
お支払いができない場合、プランは自動解約されます。お手数ですが、再度プラン登録をお願いいたします。
## 領収書はどこで確認・ダウンロードできますか？
お支払い完了後にStripeから送信されるメールに領収書リンクが記載されています。ダッシュボードの「Billing」画面の請求履歴からもダウンロードいただけます。
## 適格請求書（インボイス）は発行してもらえますか？
適格請求書（インボイス）の発行については、お問い合わせフォームよりご連絡ください。確認のうえ、ご案内いたします。
---
Source: https://jpx-jquants.com/ja/help/account
# アカウント管理 (FAQ)
## アカウントの作成はなぜ必要ですか？
アカウントはJ-Quants APIを利用するために必要です。作成したアカウントでログイン後に、サンプルデータの取得やプランの購入ができるようになります。
## アカウントの作成は有料ですか？
アカウントの作成は無料です。
## パスワードを忘れてしまいました。
[パスワード再設定ページ](https://jpx-jquants.com/ja/login)からパスワードの再設定をお願いします。Google連携によるアカウントの場合、Webサイトへのログイン・データ取得ともにパスワード不要です。
## MFAの認証コードがメールで届きません。
以下をご確認ください。
- 迷惑メール（スパム）フォルダの確認
- no-reply@jpx-jquants.com からのメールを受信できるよう、メールソフトやドメイン受信設定をご確認
- 認証コードの有効期限は10分間です。期限切れの場合は、ログイン画面の「確認コードを再送信」ボタンから再送信してください
- 認証アプリ（TOTP）に切り替えると、メール遅延の影響を受けずに認証可能です（プロフィール画面 » 多要素認証（MFA）の変更 から設定可能）
## MFA（多要素認証）が必須になっていますが、これを解除できますか？
MFA認証はセキュリティ確保のため、解除（無効化）することはできません。ご利用にあたっては以下の点をご確認ください。
- 既定ではEmail OTP方式が設定されており、ログイン時にご登録のメールアドレス宛に6桁の認証コードが自動送信されます
- 認証メールの件名：「【J-Quants API】多要素認証コードのご案内 / Your Multi-Factor Authentication Code」
- 送信元：no-reply@jpx-jquants.com
- 認証アプリ（Google Authenticator等のTOTP方式）に変更したい場合は、ダッシュボードのプロフィール画面「多要素認証（MFA）の変更」からご設定いただけます
## メールアドレスを変更したいのですが、可能ですか？
メールアドレスの変更はサインイン後、ダッシュボードの「Profile」画面から行えます。ただし、Google連携アカウントからメールアドレス・パスワードによるアカウントへの変更はシステム上対応しておりません。
## 個人利用向けと知らず法人メールアドレスで登録してしまいました。アカウントを削除できますか？
退会手続きはご自身でダッシュボードの「Profile」画面下部の「退会手続きを進める」ボタンより実施いただけます。
## 無料プランを利用して1年後に自動で解約されました。アカウントは削除されますか？
無料プランは1年後に自動解約されますが、お客様のアカウントは削除されません。アカウントの削除は、ログイン後のプロフィール画面からお願いします。
---
Source: https://jpx-jquants.com/ja/help/data
# データ内容・仕様 (FAQ)
## 特定のデータ（平均出来高・配当利回り等）はどのエンドポイントで取得できますか？
J-Quants APIで提供しているデータとエンドポイントの一覧は[データ仕様・エンドポイント一覧](https://jpx-jquants.com/ja/spec/data-spec)でご確認ください。お探しのデータが見つからない場合はお問い合わせフォームよりお気軽にお問い合わせください。
## APIで一度に返却されるデータが上限を超えた場合の取得方法は？
レスポンスに `pagination_key` が含まれている場合、データが続きとして存在することを示します。次のリクエストで `pagination_key` クエリパラメータに前回のレスポンスの値を指定することで、続きのデータが取得できます。`pagination_key` が空または含まれなくなるまで繰り返すことで全件取得可能です。
## APIレスポンスの形式（カラム名）が以前と変わっています。
V2 APIではレスポンス構造とカラム名が変更されています。詳細は[V1→V2の変更点](https://jpx-jquants.com/ja/spec/migration-v1-v2)でご確認ください。
- レスポンス構造: 原則として `data` キーの配列形式で返却されます。ページネーション時は `pagination_key` も含まれます
- カラム名: 株価四本値などで短縮形が採用されています。例: Open → O、High → H、Low → L、Close → C、Volume → Vo、TurnoverValue → Va、AdjustmentFactor → AdjFactor
## 特定の銘柄でデータが欠損している、または誤ったデータが表示されています。
データの欠損・不整合についてご報告ありがとうございます。以下の情報をお問い合わせフォームよりお知らせください。データ修正の状況は[データ修正情報](https://jpx-jquants.com/ja/spec/fix-data-info)でも随時更新しております。
- 対象の銘柄コード
- 対象のエンドポイント（例：/v2/equities/bars/daily）
- 不具合の内容（例：特定日のデータ欠損、数値が異常 等）
- 確認された日付または期間
## 調整済み株価は過去のデータまでさかのぼって修正されますか？
株式分割・併合が発生した銘柄について、配信対象データの最も古いデータまで遡って調整済み株価が再計算されます。遡及期間に上限はありません。取得可能なデータ期間はプランによって異なります。詳細は[プラン別データ仕様](https://jpx-jquants.com/ja/spec/data-spec)をご確認ください。
## 無料プランでは直近12週間のデータは取得できませんが、この期間内に株式分割などが生じた場合には株価はどうなりますか？
株式分割が発生した場合には効力発生日から遡り、過去の株価が調整されます。そのため、12週間前時点と現在までの間に株式分割が発生した場合には、12週間前以前の株価も分割調整されます。詳しくは[プラン別データ仕様](https://jpx-jquants.com/ja/spec/data-spec)および[調整済み株価仕様](https://jpx-jquants.com/ja/spec/eq-bars-daily/adj)をご確認ください。
## 時価総額を計算するにはどうすればよいですか？
バリュエーション指標APIのレスポンスに時価総額（`MktCap`、百万円単位）が含まれているため、計算は不要です。時価総額は終値（売買が成立しなかった日は基準値段）×自己株式を控除した株式数で算出されています。株価四本値APIの時価総額は自己株式を含む株式数を用いるため、両者の値が一致しない場合があります。詳細は[バリュエーション指標](https://jpx-jquants.com/ja/spec/eq-valuation)をご確認ください。
## 上場廃止となった銘柄のデータは取得できますか？
取得できます。上場廃止銘柄であっても、上場していた期間のデータはそのまま残っており、上場していた期間内の日付・期間を指定すれば取得可能です。銘柄マスタ（/v2/equities/master）では上場していた時点の日付を `date` に指定すると取得できますが、上場廃止後の日付と `code` を併せて指定した場合はレスポンスが空になります。なお、上場日・上場廃止日の項目や上場廃止銘柄の一覧は提供していません。詳細は[銘柄マスタAPI仕様](https://jpx-jquants.com/ja/spec/eq-master)および[株価四本値（日足）](https://jpx-jquants.com/ja/spec/eq-bars-daily)をご確認ください。
## 財務情報API（fins/summary）の数値は累計値ですか？四半期単体の値ですか？
`Sales`（売上高）/ `OP`（営業利益）/ `OdP`（経常利益）/ `NP`（当期純利益）は期首からの累計値です（四半期単体の値ではありません）。例えば `CurPerType=3Q` の場合は9ヶ月間（1Q+2Q+3Q）の累計値です。JGAAP・IFRS・米国基準すべてで共通です。なお、`OdP`（経常利益）はIFRS・米国基準には存在しないため空欄となります。詳細は[財務情報API仕様](https://jpx-jquants.com/ja/spec/fin-summary)をご確認ください。
## 発行済み株式総数はどのエンドポイントで取得できますか？
期末の発行済株式数は財務情報API（/v2/fins/summary）から取得できます。ShOutFY（期末発行済株式数・自己株式含む）からTrShFY（期末自己株式数）を引くと自己株式を除く発行済株式数が算出できます。なお銘柄一覧（/v2/equities/master）には発行済み株式総数フィールドはありません。詳細は[財務情報API仕様](https://jpx-jquants.com/ja/spec/fin-summary)をご確認ください。
## 財務諸表詳細（fins/details）の勘定科目名が毎年変わります。新旧の対応付けはどうすればよいですか？
/v2/fins/detailsのキーはEDINET XBRLタクソノミの「冗長ラベル（英語）」を使用しており、タクソノミ改訂により変更される場合があります。会計基準が日本基準の場合は「勘定科目リスト」の各シートのE列「冗長ラベル（英語）」、IFRSの場合は「国際会計基準タクソノミ要素リスト」の各シートのD列「冗長ラベル（英語）」が本APIのキーに対応します。各リストの詳細は[EDINETタクソノミ関連ページ](https://disclosure2dl.edinet-fsa.go.jp/guide/static/disclosure/WZEK0110.html)でご確認ください。
## 指数四本値ではどの指数のデータが取得できますか？
配信対象の指数は[指数コード一覧](https://jpx-jquants.com/ja/spec/idx-bars-daily/indexcodes)に記載されています。指数によってデータ収録期間が異なりますのでご留意ください。
## 地方取引所やPTSのデータは取得可能ですか？今後の配信予定はありますか？
配信するデータは東京証券取引所に上場する銘柄のデータのみです。地方取引所やPTSのデータの配信予定はございません。
## 分足・ティックデータで先物のデータは取得できますか？
現在J-Quants APIでは先物の分足データは提供していません。アドオンの分足・ティックでは現物株のデータのみ取得可能です。詳細は[分足データ仕様](https://jpx-jquants.com/ja/spec/eq-bars-minute)をご確認ください。
## 分足データの更新タイミングはリアルタイムですか？
分足データは日次で更新されます。リアルタイムでの配信ではございません。詳しくは[データ更新スケジュール](https://jpx-jquants.com/ja/spec/data-update)をご確認ください。
## ISINコードやFIGIコードは取得できますか？
J-Quants APIではISINコードおよびFIGIコードは提供しておりません。利用可能なデータ項目については[銘柄マスタAPI仕様](https://jpx-jquants.com/ja/spec/eq-master)をご確認ください。
## 普通株式と優先株式を判別する方法はありますか？
銘柄コード（`Code`）は5桁で構成され、末尾の5桁目は株券の種類ごとに付番される「予備コード」です。この予備コードで判別でき、普通株式は「0」となります。また、J-Quants APIで4桁の銘柄コードを `code` に指定した場合、普通株式と優先株式の両方が上場している銘柄では普通株式のデータのみが取得されます。詳細は[銘柄マスタAPI仕様](https://jpx-jquants.com/ja/spec/eq-master)をご確認ください。なお、現在上場している優先株式等の一覧は、JPXウェブサイトの[銘柄一覧（優先株等）](https://www.jpx.co.jp/equities/products/preferred-stocks/issues/)に掲載されています。
---
Source: https://jpx-jquants.com/ja/help/incident
# サービス障害 (FAQ)
## サービスが利用できません。
障害が発生しているかなどについては[X（旧Twitter）@jpx_JQuants](https://x.com/jpx_JQuants)をご確認ください。
## Webサイトが表示されません。
障害情報が出ていない場合は、お使いの環境に起因している可能性があります。以下をお試しください。
- シークレットウィンドウ（プライベートブラウズ）で表示できるか確認
- VPN・プロキシをご利用の場合は接続を切り替えて確認。セキュリティソフトが通信を遮断していないか設定・ログを確認（設定を変更した場合は、確認後に必ず元に戻してください）
- ブラウザ拡張機能の無効化
- ブラウザキャッシュのクリア
- 別の回線（ネットワーク）で表示できるか確認
## 障害情報やメンテナンス情報はどこで確認できますか？
障害発生時やメンテナンス時の情報は[X（旧Twitter）@jpx_JQuants](https://x.com/jpx_JQuants)やJ-Quants APIサイトのお知らせ欄でご確認いただけます。緊急のお問い合わせは、状況がある程度ご確認できた上でお問い合わせフォームよりご連絡ください。
## サービス復旧までにかかる時間は？
速やかな復旧を目指しますが、障害の状況によっては復旧までお時間をいただく場合がございます。本サービスはヒストリカルのデータを配信するサービスのため、障害復旧の多くは翌営業日以降となることをご了承ください。
## サービスが停止した場合には返金されますか？
原則、返金は行いません。本サービスは低価格でのデータ配信を、高いサービス稼働率を保証しないことで実現していますことをご了承ください。
ただし、サービスの停止が長期間にわたる場合など、返金を行う場合の条件は[利用規約](https://jpx-jquants.com/ja/termsofservice)に定めております。詳細は利用規約をご確認ください。無料プランについては返金は行いません。
---
Source: J-Quants FAQ "auth" (no dedicated page; provided via the website chatbot at https://jpx-jquants.com/ja/help)
# API認証・ログイン (FAQ)
## Google連携でサインインしましたが、APIの認証（auth_user）でパスワードが違うと表示されます。
Google連携でサインインしたアカウントでもダッシュボードからAPIキーを発行できます。ダッシュボードの「API Keys」画面よりキーを発行し、`x-api-key` ヘッダーに付与してご利用ください。
## リフレッシュトークンの取得方法を教えてください。
V2 APIでは認証方式が「トークン方式」から「APIキー方式」に変更されました。メールアドレス・パスワードによる認証（`auth_user` / `auth_refresh`）は不要です。ダッシュボードでAPIキーを発行し、リクエストヘッダー `x-api-key` に指定してご利用ください。詳細は[クイックスタートガイド](https://jpx-jquants.com/ja/spec/quickstart)や[V1→V2の変更点](https://jpx-jquants.com/ja/spec/migration-v1-v2)もご参照ください。
## APIキーでリクエストすると401/403エラーが返ります。ブラウザではログインできます。
以下の点をご確認ください。
- リクエストヘッダーに `x-api-key: ` を指定しているか（`Authorization: Bearer ...` 方式はV1用で、V2では使用不可）
- 最新のAPIキーを使用しているか（新しいAPIキーを作成すると、既存のAPIキーは無効になります）
- APIキーをコピーする際に余分な空白や改行が混入していないか（APIキーの未指定・不正は403エラーとして返されます）
- 403エラーの場合は、ご利用プランで該当エンドポイントが利用可能か仕様書でご確認ください
## 特定のエンドポイントで403 Forbiddenエラーが返されます。
403エラーは以下の原因が考えられます。V1エンドポイント（`/v1/...`）はV2では利用できません。V2エンドポイント（`/v2/...`）をご使用ください。V1→V2の対応表は[V1→V2の変更点](https://jpx-jquants.com/ja/spec/migration-v1-v2)でご確認ください。また、ご契約中のプランで該当エンドポイントが利用可能か[プラン別データ仕様](https://jpx-jquants.com/ja/spec/data-spec)でもご確認ください。プラン変更直後の場合、反映に数分〜数十分かかる場合があります。
## IDトークンの有効期限はどのくらいですか？
V2 APIではAPIキー方式に変更されており、APIキー自体に有効期限はありません。万一APIキーが漏洩した場合や利用を停止したい場合は、ダッシュボードの「API Keys」画面から新しいAPIキーを作成してください（新しいAPIキーを作成すると、既存のAPIキーは無効になります）。詳しくは[クイックスタートガイド](https://jpx-jquants.com/ja/spec/quickstart)をご確認ください。
※ V1 API（旧版）は閉鎖済みです。まだ移行されていない場合はV2への移行をお願いいたします。
## リクエスト時に401 Unauthorizedエラーが返されます。
401エラーは、`Authorization` ヘッダーによるトークン認証に失敗した場合に発生します。APIキーの未指定・不正の場合は401ではなく403エラーが返ります。以下をご確認ください。
- V1の `Authorization: Bearer ` 方式を使っている場合、V2では使えませんのでAPIキー方式（`x-api-key` ヘッダー）に切り替えてください
- リクエストヘッダーに `x-api-key: ` を指定しているか
- 最新のAPIキーを使用しているか（新しいAPIキーを作成すると、既存のAPIキーは無効になります）
- APIキーをコピーする際に余分な空白や改行が混入していないか
## APIキーが漏洩した場合はどうすればよいですか？
ダッシュボードの「API Keys」画面から新しいAPIキーを作成してください。新しいAPIキーを作成すると、既存のAPIキーは無効になります。APIキーには有効期限はありませんが、いつでも再発行が可能です。なお、同時に複数のAPIキーを有効にすることはできません。詳しくは[クイックスタートガイド](https://jpx-jquants.com/ja/spec/quickstart)をご確認ください。
---
Source: J-Quants FAQ "website" (no dedicated page; provided via the website chatbot at https://jpx-jquants.com/ja/help)
# Webサイト・ダウンロード (FAQ)
## ダウンロードしたCSVファイルが文字化けします。
J-Quants APIのCSVファイルはUTF-8エンコーディングです。Excelで直接開くと文字化けする場合があります。Excelの場合は「データ」タブ → 「テキストまたはCSVから」を選択し、文字コードを「UTF-8」に設定して読み込んでください。
## Webサイトからデータがダウンロードできません。
FreeプランではCSVダウンロード機能は取引カレンダーを除きご利用いただけません。有料プランをご利用の場合、ダウンロード機能の不具合の可能性があります。以下の情報をお問い合わせフォームよりお知らせください。お急ぎの場合は[クイックスタートガイド](https://jpx-jquants.com/ja/spec/quickstart)を参照してAPI経由でのデータ取得もご検討ください。
- ご利用のブラウザ（Chrome, Safari等）
- エラーメッセージの有無と内容
- 対象の銘柄コードまたはデータ種別
# English Documentation
---
Source: https://jpx-jquants.com/en/spec
# About J-Quants API
## Welcome to J-Quants API
J-Quants API is a service for individuals that distributes financial data such as historical stock prices and corporate financial information via API. Users can obtain financial data in a formatted and easy-to-analyze form.
> **Note**
>
> **For users who registered on or after December 22, 2025**\
> Only the new version (V2) is available. Please see the [Quick Start](https://jpx-jquants.com/en/spec/quickstart) guide.
> **Note**
>
> **For users who have been using the service since before December 22, 2025**\
> J-Quants API has migrated from the old version (V1) to the new version (V2), and the old version (V1) was discontinued on June 1, 2026. Your subscription will be carried over after migrating to V2. Please see the changes between V1 and V2 [here](https://jpx-jquants.com/en/spec/migration-v1-v2).
---
Source: https://jpx-jquants.com/en/spec/bulk-get
# Get File Download URL (/bulk/get)
`GET` /v2/bulk/get
## Overview
You can obtain a signed URL for downloading a file.\
You can retrieve files in two ways: by specifying the Key obtained from [List of Downloadable Files](https://jpx-jquants.com/en/spec/bulk-list), or by specifying an endpoint and date combination.
> **Note**
>
> For information on decompression methods and restrictions for CSV files obtained via Bulk API, please see [File Download](https://jpx-jquants.com/en/spec/bulk).
### Attention
> **Info**
>
> - The obtained URL expires in 5 minutes. Please complete the download within the validity period.
> - The URL is temporary and cannot be reused.
> - Files are compressed in gzip format.
> - Specify either `key` or the combination of `endpoint` and `date`. You cannot specify all three at the same time.
## Retrieve file download URL
`GET` `https://api.jquants.com/v2/bulk/get`
In your request message, either "key" or the combination of "endpoint" and "date" must be specified.
### Parameter and Response
In your request message, either "key" or the combination of "endpoint" and "date" must be specified.\
Combination of parameter in the request and results are as below.
- key: ✓, endpoint: –, date: – → Download URL for the file matching the specified Key
- key: –, endpoint: ✓, date: ✓ → Download URL for the file matching the specified endpoint and date
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **key** or **endpoint** + **date** is required.
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| key | string | Optional | File key (Key obtained from /bulk/list). |
| endpoint | string | Optional | Endpoint name of the data to retrieve (e.g. /equities/bars/daily). Used in combination with `date`. For a list of available values, please see [here](https://jpx-jquants.com/en/spec/bulk-list/endpoints). |
| date | string | Optional | Target date (YYYY-MM, YYYYMM, YYYY-MM-DD, or YYYYMMDD). Used in combination with `endpoint`. |
> **Info**
>
> - By specifying `endpoint` and `date` together, you can get the download URL for the matching file.
### Sample Code
/v2/bulk/get
**cURL**
```bash
curl -G https://api.jquants.com/v2/bulk/get \
-H "x-api-key: {{apiKey}}" \
-d key="{{key}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/bulk/get", {
params: {
key: "{{key}}",
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/bulk/get",
params={"key": "{{key}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ---------------------------- |
| url | string | Required | Signed URL for file download |
### Response Sample
```bash {{ title: "200:OK" }}
{
"url": "https://example.presigned-url.com/..."
}
```
---
Source: https://jpx-jquants.com/en/spec/bulk-list/endpoints
# Available Endpoint List
## Overview
This is a list of values that can be specified for the `endpoint` parameter of the `/v2/bulk/list` API.
> **Note**
>
> Available data and periods vary depending on your subscription plan and add-ons. For details, please see [APIs and Data Storage Period by Subscription](https://jpx-jquants.com/en/spec/data-spec).
## Endpoint List
| Data Name | Endpoint String |
| -------------------------------- | ----------------------------------- |
| Listed Issues | /equities/master |
| Stock Prices (OHLC) | /equities/bars/daily |
| Valuation Indicators | /equities/valuation |
| Financial Information | /fins/summary |
| Earnings Announcement Dates | /fins/earnings-date |
| Investor Type | /equities/investor-types |
| TOPIX Prices (OHLC) | /indices/bars/daily/topix |
| Index Prices (OHLC) | /indices/bars/daily |
| Nikkei 225 Options Prices (OHLC) | /derivatives/bars/daily/options/225 |
| Futures Prices (OHLC) | /derivatives/bars/daily/futures |
| Options Prices (OHLC) | /derivatives/bars/daily/options |
| Weekly Margin Interest | /markets/margin-interest |
| Short Selling Ratio by Sector | /markets/short-ratio |
| Short Sale Balance Report | /markets/short-sale-report |
| Daily Margin Trading Information | /markets/margin-alert |
| Trading by Type of Investors | /markets/breakdown |
| Trading Calendar | /markets/calendar |
| Dividend Information | /fins/dividend |
| Financial Statements (BS/PL/CF) | /fins/details |
| Minute Stock Prices (OHLC) | /equities/bars/minute |
| Stock Prices (Tick) | /equities/trades |
## Usage Examples
/v2/bulk/list
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/bulk/list",
params={"endpoint": "{{endpoint}}"},
headers=headers,
)
files = resp.json()
# Get the latest file
if files["data"]:
latest_file = files["data"][0]
print(f"Key: {latest_file['Key']}")
print(f"Size: {latest_file['Size']} bytes")
print(f"LastModified: {latest_file['LastModified']}")
```
---
Source: https://jpx-jquants.com/en/spec/bulk-list
# List of Downloadable Files (/bulk/list)
`GET` /v2/bulk/list
## Overview
You can retrieve a list of files available for download in CSV format.\
You can get a list of files for a specific dataset by specifying an endpoint, or get a list of files across all accessible datasets for a specific date.\
You can use the obtained file list to download files with the [Get File Download URL API](https://jpx-jquants.com/en/spec/bulk-get).
> **Note**
>
> For information on decompression methods and restrictions for CSV files obtained via Bulk API, please see [File Download](https://jpx-jquants.com/en/spec/bulk).
### Attention
> **Info**
>
> - Files are compressed in gzip format.
> - File names include year and month information.
> - Either `endpoint` or `date` is required.
## Retrieve list of downloadable files
`GET` `https://api.jquants.com/v2/bulk/list`
In your request message, either "endpoint" or "date" must be specified.
### Parameter and Response
In your request message, either "endpoint" or "date" must be specified.\
Combination of parameter in the request and results are as below.
- endpoint: ✓, date: –, from /to: – → File list for the specified endpoint for the plan's full allowed period
- endpoint: ✓, date: –, from /to: ✓ → File list for the specified endpoint within the specified period
- endpoint: –, date: ✓, from /to: – → File list for the specified date across all accessible endpoints under your subscription
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **endpoint** or **date** is required.
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| endpoint | string | Optional | Endpoint name of the data to retrieve (e.g. /equities/bars/daily). For a list of available values, please see [here](https://jpx-jquants.com/en/spec/bulk-list/endpoints). |
| date | string | Optional | Target date (YYYY-MM, YYYYMM, YYYY-MM-DD, or YYYYMMDD). |
| from | string | Optional | Start date of the retrieval period (YYYY-MM, YYYYMM, YYYY-MM-DD, or YYYYMMDD). Only available when `endpoint` is specified. |
| to | string | Optional | End date of the retrieval period (YYYY-MM, YYYYMM, YYYY-MM-DD, or YYYYMMDD). Only available when `endpoint` is specified. |
> **Info**
>
> - When only `endpoint` is specified, all files within the plan's allowed period are returned. You can narrow the period using `from`/`to`.
> - When only `date` is specified, files for that date from all endpoints accessible under your subscription are returned.
> - When Trading Calendar (/markets/calendar) is specified as the `endpoint`, only the latest file will be returned, regardless of the `from`/`to` period. Additionally, Trading Calendar cannot be retrieved with a `date` specification.
### Sample Code
/v2/bulk/list
**cURL**
```bash
curl -G https://api.jquants.com/v2/bulk/list \
-H "x-api-key: {{apiKey}}" \
-d endpoint="{{endpoint}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/bulk/list", {
params: {
endpoint: "{{endpoint}}",
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/bulk/list",
params={"endpoint": "{{endpoint}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ------------ | ------ | -------- | --------------------------------------------- |
| Key | string | Required | File key (used when downloading file) |
| LastModified | string | Required | Last modified date and time (ISO 8601 format) |
| Size | number | Required | File size (bytes) |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Key": "equities/bars/daily/historical/2025/equities_bars_daily_202501.csv.gz",
"LastModified": "2025-11-07T20:48:51.295000+00:00",
"Size": 6933528
},
{
"Key": "equities/bars/daily/historical/2024/equities_bars_daily_202412.csv.gz",
"LastModified": "2025-01-07T18:30:15.123000+00:00",
"Size": 6845123
}
]
}
```
---
Source: https://jpx-jquants.com/en/spec/bulk
# File download
In addition to historical data, you can download same-day delivered data as CSV files.
This is useful if you prefer not to call the API directly—especially for beginners.
Available for users on the **Light plan or higher** (Trading Calendar is
available on the Free plan).
## How to use
1. Log in
2. From the navigation bar, select **Download** > Data you want
3. Select the files for the period you want and download them
## How to decompress
Downloaded files are in gzip format. If you use a programming language such as Python, you can process them as-is.
If you want to decompress them, try the following:
> **Note**
>
> - Some datasets (e.g., tick data) can be several GB after decompression.
> - After files are downloaded, any editing or processing of the data will be the user’s responsibility, as we do not provide support for these activities.
- **macOS / Linux**: you can decompress with the following command.
```text {{ title: "macOS / Linux" }}
gunzip .gz
```
- **Windows**: decompress using an app such as 7-Zip.
## Limitations
- Adjusted prices for stock splits/reverse splits are not provided in CSV files. If you need them, please refer to [How to calculate adjusted prices](https://jpx-jquants.com/en/spec/eq-bars-daily/adj) and calculate them yourself.
---
Source: https://jpx-jquants.com/en/spec/cursor
# Retrieving Differential Data Using Cursor
By calling the API with `date` set to today, you can retrieve the list of disclosures available at the time of the call. By passing the `cursor` from the previous response along with the `date` parameter in the next call, you can retrieve only the disclosures published after the ones you have already fetched.
If the response contains a `pagination_key`, it means not all results could be retrieved in a single request. Specify the `pagination_key` as a request parameter and re-fetch immediately to retrieve the remaining data.
---
Source: https://jpx-jquants.com/en/spec/data-spec
# APIs and Data Storage Period by Subscription
## APIs and Data Storage Period by Plan
| Data | Access Method | Free | Light | Standard | Premium | Data Period |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | ------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- | ----------------------------------------------- |
| Listed Issue Master | [API](https://jpx-jquants.com/spec/eq-master) / [CSV](https://jpx-jquants.com/dashboard/downloads/exchange-master?filter=equities/master)\* | 2 years History \[12 weeks delayed] | 5 years History | 10 years History | 20 years History | Since 2008/5/7 |
| Stock Prices (OHLC) | [API](https://jpx-jquants.com/spec/eq-bars-daily) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/bars/daily)\* | 2 years History \[12 weeks delayed] | 5 years History | 10 years History | 20 years History | Since 2008/5/7 |
| Valuation Indicators | [API](https://jpx-jquants.com/spec/eq-valuation) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/valuation)\* | 2 years History \[12 weeks delayed] | 5 years History | 10 years History | 20 years History | Since 2008/7/8 \*1 |
| Financial Data(Summary only) | [API](https://jpx-jquants.com/spec/fin-summary) / [CSV](https://jpx-jquants.com/dashboard/downloads/company-data/financial-statements?filter=fins/summary)\* | 2 years History \[12 weeks delayed] | 5 years History | 10 years History | 20 years History | Since 2008/7/7 |
| Earnings Announcement Dates | [API](https://jpx-jquants.com/spec/fin-earnings-date) / [CSV](https://jpx-jquants.com/dashboard/downloads/company-data/financial-statements?filter=fins/earnings-date)\* | 2 years History \[12 weeks delayed] | 5 years History | 10 years History | 20 years History | Since 2014/9/1 |
| Earnings Calendar (March/September fiscal year-end only) | [API](https://jpx-jquants.com/spec/eq-earnings-cal) | Available | Available | Available | Available | Recent data only |
| Trading Calendar | [API](https://jpx-jquants.com/spec/mkt-cal) / [CSV](https://jpx-jquants.com/dashboard/downloads/exchange-master?filter=markets/calendar) | 12 weeks ago to 2 years 12 weeks ago | To the end of the following year From 5 years ago | To the end of the following year From 10 years ago | To the end of the following year From 20 years ago | To the end of the following year Since 2008/1/1 |
| Trading by Type of Investors | [API](https://jpx-jquants.com/spec/eq-investor-types) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=equities/investor-types) | - | 5 years History | 10 years History | 20 years History | Since 2008/1/16 |
| TOPIX Prices (OHLC) | [API](https://jpx-jquants.com/spec/idx-bars-daily-topix) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/indices?filter=indices/bars/daily/topix) | - | 5 years History | 10 years History | 20 years History | Since 2008/5/7 |
| Indices (OHLC) | [API](https://jpx-jquants.com/spec/idx-bars-daily) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/indices?filter=indices/bars/daily) | - | - | 10 years History | 20 years History | Since 2008/5/7 |
| Index Option Prices (OHLC) | [API](https://jpx-jquants.com/spec/drv-bars-daily-opt-225) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/options?filter=derivatives/bars/daily/options/225) | - | - | 10 years History | 20 years History | Since 2008/5/7 |
| Futures (OHLC) | [API](https://jpx-jquants.com/spec/drv-bars-daily-fut) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/futures) | - | - | - | 20 years History | Since 2008/5/7 |
| Options (OHLC) | [API](https://jpx-jquants.com/spec/drv-bars-daily-opt) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/options?filter=derivatives/bars/daily/options) | - | - | - | 20 years History | Since 2008/5/7 |
| Margin Trading Outstandings | [API](https://jpx-jquants.com/spec/mkt-margin-int) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/margin-interest) | - | - | 10 years History | 20 years History | Since 2012/2/10 |
| Short Sale Value and Ratio by Sector | [API](https://jpx-jquants.com/spec/mkt-short-ratio) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/short-ratio) | - | - | 10 years History | 20 years History | Since 2008/11/5 |
| Outstanding Short Selling Positions Reported | [API](https://jpx-jquants.com/spec/mkt-short-sale) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/short-sale-report) | - | - | 10 years History | 20 years History | Since 2013/11/7 |
| Major Shareholders (EDINET) | [API](https://jpx-jquants.com/spec/edinet-major-shareholders) | - | - | 10 years History | 20 years History | Since 2016/6/1 |
| Cross-Shareholdings (EDINET) | [API](https://jpx-jquants.com/spec/edinet-cross-shareholdings) | - | - | 10 years History | 20 years History | Since 2020/3/31 |
| Large Volume Holding Reports (EDINET) | [API](https://jpx-jquants.com/spec/edinet-large-volume-shareholders) | - | - | 10 years History | 20 years History | Since 2021/7/1 |
| Margin Trading Outstanding (Issues Subject to Daily Publication) | [API](https://jpx-jquants.com/spec/mkt-margin-alert) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/margin-alert) | - | - | 10 years History | 20 years History | Since 2008/5/8 |
| Breakdown Trading Data | [API](https://jpx-jquants.com/spec/mkt-breakdown) / [CSV](https://jpx-jquants.com/dashboard/downloads/reference-data?filter=markets/breakdown) | - | - | - | 20 years History | Since 2015/4/1 |
| Morning Session Stock Prices (OHLC) | [API](https://jpx-jquants.com/spec/eq-bars-daily-am) | - | - | - | Available | Recent data only |
| Cash Dividend Data | [API](https://jpx-jquants.com/spec/fin-dividend) / [CSV](https://jpx-jquants.com/dashboard/downloads/company-data/dividends) | - | - | - | 20 years History | Since 2013/2/20 |
| Financial Statement Data (BS/PL/CF) | [API](https://jpx-jquants.com/spec/fin-details) / [CSV](https://jpx-jquants.com/dashboard/downloads/company-data/financial-statements?filter=fins/details) | - | - | - | 20 years History | Since 2009/1/13 |
> **Note**
>
> \* CSV downloads are not available for Free plan users (except Trading Calendar). Only API access is available. (Paid plan users can also download CSV files.)
>
> \*1 For the Valuation Indicators, the share counts and financial data required for the calculation are not fully available in the earliest part of the coverage (roughly 2008 to 2010), so more issues and items are recorded as Null during that period.
### Data Storage Period
> **Info**
>
> If you need data prior to the Data Storage Period, it may be available at [J-Quants DataCube](https://dc.jpx-jquants.com) (available to both individuals and corporations).
## APIs and Data Storage Period by Add-on
| Add-on | Data | Access Method | Data Storage Period |
| ------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------- |
| Stock Prices (minute-OHLC, Tick) | Minute Stock Prices (OHLC) | [API](https://jpx-jquants.com/spec/eq-bars-minute) / [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/bars/minute) | 2 years ago |
| Stock Prices (Tick) | [CSV](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/trades) | 2 years ago | |
| TDnet/Company Disclosure | TDnet/Company Disclosure Index List | [API](https://jpx-jquants.com/spec/td-list) | 5 years ago |
| TDnet/Company Disclosure Files | [API](https://jpx-jquants.com/spec/td-files) | 5 years ago | |
| TDnet/Company Disclosure Index CSV Download | [API](https://jpx-jquants.com/spec/td-bulk) | 5 years ago | |
## Notes on Provided Data
> **Note**
>
> - The bar types provided for time-series data differ by product: daily bars, minute bars, and tick data are provided for equities, while only daily bars are provided for indices, futures, and options. Weekly and monthly bars are not provided for any product. If you need weekly or monthly bars, please aggregate them from the daily data on your side.
> - The absence of a record for a given date does not mean that the value is zero (e.g., for outstanding-balance data, a missing record does not mean the balance is zero). A missing record means that data for that date is not provided for reasons such as not yet being aggregated or not being subject to disclosure.
---
Source: https://jpx-jquants.com/en/spec/data-update
# Update Timing of Provided Data
### Frequency and Timing of data updates
| Data | Frequency | Time | Remark |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Listed Issue Master](https://jpx-jquants.com/spec/eq-master) | Daily | Around 17:30 Around 8:00 on the next business day | Data for the next business day will be available after 17:30. Additionally, the data may be updated at 8:00 on the following business day to ensure it reflects the latest information. |
| [Stock Prices (OHLC)](https://jpx-jquants.com/spec/eq-bars-daily) | Daily | Around 16:30 | |
| [Valuation Indicators](https://jpx-jquants.com/spec/eq-valuation) | Daily | Around 16:30 | |
| [Financial Data(Summary only)](https://jpx-jquants.com/spec/fin-summary) | Near real-time : API (Premium plan) Daily : CSV / API (Other plans) | Around 18:00 (Preliminary) Around 24:30 (Final) | Disclosures are reflected sequentially as they are released. Some delay may occur before updates appear. \*Delays may be longer during periods when disclosures are concentrated, such as quarterly earnings season. |
| [Earnings Announcement Dates](https://jpx-jquants.com/spec/fin-earnings-date) | Daily | Around 10:05 | Updated every business day with the earnings announcement dates that listed companies have reported to the Tokyo Stock Exchange (newly reported or changed records are added). |
| [Earnings Calendar (March/September fiscal year-end only)](https://jpx-jquants.com/spec/eq-earnings-cal) | Irregular | Around 19:00 | Updated only if there is an update [here](https://www.jpx.co.jp/english/listing/event-schedules/financial-announcement/index.html). |
| [Trading Calendar](https://jpx-jquants.com/spec/mkt-cal) | Irregular | Irregular | The business days and holiday trading dates (tentative) for the following year will be updated around the end of March of each year. |
| [Trading by Type of Investors](https://jpx-jquants.com/spec/eq-investor-types) | Weekly (4th business day) | Around 18:00 | Usually Thursday, or later if there is a non-business day such as a national holiday. If the publication schedule differs from the usual schedule due to consecutive holidays, etc., it will be announced [here](https://www.jpx.co.jp/english/markets/statistics-equities/investor-type/index.html). |
| [Indices (OHLC)](https://jpx-jquants.com/spec/idx-bars-daily) | Daily | Around 16:30 | |
| [TOPIX Prices (OHLC)](https://jpx-jquants.com/spec/idx-bars-daily-topix) | Daily | Around 16:30 | |
| [Index Option Prices (OHLC)](https://jpx-jquants.com/spec/drv-bars-daily-opt-225) | Daily | Around 27:00 | |
| [Futures (OHLC)](https://jpx-jquants.com/spec/drv-bars-daily-fut) | Daily | Around 27:00 | |
| [Options (OHLC)](https://jpx-jquants.com/spec/drv-bars-daily-opt) | Daily | Around 27:00 | |
| [Margin Trading Outstandings](https://jpx-jquants.com/spec/mkt-margin-int) | Weekly (2nd business day) | Around 16:30 | Usually Tuesday, or later if there is a non-business day such as a holiday. If the publication schedule differs from the usual schedule due to consecutive holidays, etc., it will be announced [here](https://www.jpx.co.jp/english/markets/statistics-equities/margin/07.html). |
| [Short Sale Value and Ratio by Sector](https://jpx-jquants.com/spec/mkt-short-ratio) | Daily | Around 16:30 | |
| [Outstanding Short Selling Positions Reported](https://jpx-jquants.com/spec/mkt-short-sale) | Daily | Around 17:30 | |
| [Major Shareholders (EDINET)](https://jpx-jquants.com/spec/edinet-major-shareholders) | Near real-time | Weekdays 8:00-17:59 | Disclosures are reflected sequentially as they are released. Some delay may occur. |
| [Cross-Shareholdings (EDINET)](https://jpx-jquants.com/spec/edinet-cross-shareholdings) | Near real-time | Weekdays 8:00-17:59 | Disclosures are reflected sequentially as they are released. Some delay may occur. |
| [Large Volume Holding Reports (EDINET)](https://jpx-jquants.com/spec/edinet-large-volume-shareholders) | Near real-time | Weekdays 8:00-17:59 | Disclosures are reflected sequentially as they are released. Some delay may occur. |
| [Margin Trading Outstanding (Issues Subject to Daily Publication)](https://jpx-jquants.com/spec/mkt-margin-alert) | Daily | Around 16:30 | |
| [Breakdown Trading Data](https://jpx-jquants.com/spec/mkt-breakdown) | Daily | Around 18:00 | |
| [Morning Session Stock Prices (OHLC)](https://jpx-jquants.com/spec/eq-bars-daily-am) | Daily | Around 12:00 | Please use the [Stock Prices (OHLC)](https://jpx-jquants.com/spec/eq-bars-daily) for historical data of the Morning Session Stock Prices (OHLC). |
| [Cash Dividend Data](https://jpx-jquants.com/spec/fin-dividend) | Daily | 12:00-19:00 (Every hour at around 00 minutes) | The data content may not have changed. |
| [Financial Statement Data (BS/PL/CF)](https://jpx-jquants.com/spec/fin-details) | CSV : Daily API : Near real-time | Around 18:00 (Preliminary) Around 24:30 (Final) | Disclosures are reflected sequentially as they are released. Some delay may occur before updates appear. \*Delays may be longer during periods when disclosures are concentrated, such as quarterly earnings season. |
| [Minute Stock Prices (OHLC)](https://jpx-jquants.com/spec/eq-bars-minute) | Daily | Around 16:30 | |
| [Stock Prices (Tick)](https://jpx-jquants.com/en/spec/eq-trades) | Daily | Around 16:30 | |
| [TDnet/Company Disclosure Index List](https://jpx-jquants.com/en/spec/td-list) | Near real-time | Near real-time | Disclosures are reflected sequentially as they are released. Some delay may occur before updates appear. \*Delays may be longer during periods when disclosures are concentrated, such as quarterly earnings season. |
| [TDnet/Company Disclosure Files](https://jpx-jquants.com/en/spec/td-files) | Near real-time | Near real-time | Disclosures are reflected sequentially as they are released. Some delay may occur before updates appear. \*Delays may be longer during periods when disclosures are concentrated, such as quarterly earnings season. |
| [TDnet/Company Disclosure Index CSV Download](https://jpx-jquants.com/en/spec/td-bulk) | Daily | Around 26:00 | |
> **Note**
>
> - The update timing of data is subject to change without notice to the user.
> - Also, the update timing is not guaranteed and could be earlier or later depending on the situation.
### Confirming Update Completion and How Corrections Are Reflected
> **Note**
>
> - We do not provide an API that notifies you when a data update is complete, nor version numbers or ETags for the data.
> - Differential data retrieval using cursor is supported only for Financial Data, Financial Statement Data, and TDnet/Company Disclosure Index List. See [Retrieving Differential Data Using Cursor](https://jpx-jquants.com/en/spec/cursor) for details.
> - Data corrections are reflected by overwriting the existing data (previous versions are not retained and diffs are not provided). If you need to reliably incorporate corrections, we recommend periodically re-fetching the data you need, taking the update schedule above into account. Corrections are announced on the [Data Correction History and Known issues](https://jpx-jquants.com/en/spec/fix-data-info) page.
---
Source: https://jpx-jquants.com/en/spec/drv-bars-daily-fut/derivative-product-category
# Futures Product Category Codes
| Code | Product Category Name | Data Recording Period |
| -------- | ------------------------------------- | --------------------- |
| TOPIXF | TOPIX Futures | 2008/5/7〜 |
| TOPIXMF | Mini-TOPIX Futures | 2008/6/16〜 |
| MOTF | Mothers Futures | 2016/7/19〜 |
| NKVIF | Nikkei Average VI Futures | 2012/2/27〜 |
| NKYDF | Nikkei Average Dividend Index Futures | 2010/7/26〜 |
| NK225F | Nikkei 225 Futures | 2008/5/7〜 |
| NK225MF | Nikkei 225 mini Futures | 2008/5/7〜 |
| JN400F | JPX-Nikkei Index 400 Futures | 2014/11/25〜 |
| REITF | TSE REIT Index Futures | 2008/6/16〜 |
| DJIAF | Dow Jones Industrial Average Futures | 2012/5/28〜 |
| JGBLF | JGB Futures | 2008/5/7〜 |
| NK225MCF | Nikkei 225 Micro Futures | 2023/5/29〜 |
| TOA3MF | TONA 3-Month Interest Rate Futures | 2023/5/29〜 |
| USDJPYF | USD/JPY Futures | 2026/4/13〜 |
| CNHJPYF | CNH/JPY Futures | 2026/4/13〜 |
| EURJPYF | EUR/JPY Futures | 2026/4/13〜 |
---
Source: https://jpx-jquants.com/en/spec/drv-bars-daily-fut
# Futures Prices (OHLC) (/derivatives/bars/daily/futures)
`GET` /v2/derivatives/bars/daily/futures
## Overview
Information on the OHLC, settlement price, and theoretical price of Futures can be obtained through this API.\
Please refer to [Derivative Product Category Codes](https://jpx-jquants.com/en/spec/drv-bars-daily-fut/derivative-product-category) for the data that can be obtained.
## Attention
> **Info**
>
> - **About Issue Code**
> - Please refer to [Securities Code Related Materials](https://www.jpx.co.jp/english/sicc/securities-code/01.html) for the numbering rules of futures and options trading identification codes.
> - **About Trading Session**
> - Prior to February 10, 2011, Trading session consists of the night session, the morning session, and the afternoon session.
> - Morning session data for this period is not recorded, and afternoon session data is recorded as day session data. (Note that the whole day data reflects all sessions.)
> - After February 14, 2011, Trading session consists of the night session and the day session.
> - **About Holiday Trading**
> - Trading days for holiday trading are treated as the same trading day as the night session that starts on the weekday immediately preceding the holiday (business day before the holiday) and the day session on the weekday immediately following the holiday (business day after the holiday).
> - **About key items in response**
> - When emergency margin is triggered, data as of both the clearing price calculation and the emergency margin calculation are generated for the same trading day and issue. Therefore, it is possible to uniquely identify the record by combining Date, Code and EmMrgnTrgDiv (EmergencyMarginTriggerDivision).
## Get daily Futures prices (OHLC)
`GET` `https://api.jquants.com/v2/derivatives/bars/daily/futures`
"date" must be specified.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| category | string | Optional | Derivative Product Category |
| date | string | Required | Date (e.g. 20210901 or 2021-09-01) |
| contract\_flag | string | Optional | Central contract month flag |
| pagination\_key | string | Optional | 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
/v2/derivatives/bars/daily/futures
**cURL**
```bash
curl -G https://api.jquants.com/v2/derivatives/bars/daily/futures \
-H "x-api-key: {{apiKey}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/derivatives/bars/daily/futures", {
params: {
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/derivatives/bars/daily/futures",
params={"date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ------------ | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Code | string | Required | Issue code |
| ProdCat | string | Required | Derivative Product Category |
| Date | string | Required | Trading day (YYYY-MM-DD) |
| O | number | Required | Open price (whole day) |
| H | number | Required | High price (whole day) |
| L | number | Required | Low price (whole day) |
| C | number | Required | Close price (whole day) |
| MO | number / string | Required | Open price (morning session) If the stock is not eligible for morning/afternoon session, a blank character is set. |
| MH | number / string | Required | High price (morning session) If the stock is not eligible for morning/afternoon session, a blank character is set. |
| ML | number / string | Required | Low price (morning session) If the stock is not eligible for morning/afternoon session, a blank character is set. |
| MC | number / string | Required | Close price (morning session) If the stock is not eligible for morning/afternoon session, a blank character is set. |
| EO | number / string | Required | Open price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| EH | number / string | Required | High price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| EL | number / string | Required | Low price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| EC | number / string | Required | Close price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| AO | number | Required | Open price (day session) |
| AH | number | Required | High price (day session) |
| AL | number | Required | Low price (day session) |
| AC | number | Required | Close price (day session) |
| Vo | number | Required | Volume |
| OI | number | Required | Open interest |
| Va | number | Required | Trading value |
| CM | string | Required | Contract month (YYYY-MM) |
| VoOA | number | Required | Volume (only auction) (\*1) |
| EmMrgnTrgDiv | string | Required | Emergency margin trigger division 001: When emergency margin is triggered, 002: When settlement price is calculated. "001" is recorded only if the emergency margin was triggered after July 19, 2016. |
| LTD | string | Required | Last trading day (YYYY-MM-DD) (\*1) |
| SQD | string | Required | Special quotation day (YYYY-MM-DD) (\*1) |
| Settle | number | Required | Settlement price (\*1) |
| CCMFlag | string | Required | Flag of the central contract month (1: Central contract month, 0: Others) (\*1) |
\*1 Data after July 19, 2016 contains value for these fields.
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Code": "169090005",
"ProdCat": "TOPIXF",
"Date": "2024-07-23",
"O": 2825.5,
"H": 2853.0,
"L": 2825.5,
"C": 2829.0,
"MO": "",
"MH": "",
"ML": "",
"MC": "",
"EO": 2825.5,
"EH": 2850.0,
"EL": 2825.5,
"EC": 2845.0,
"AO": 2850.5,
"AH": 2853.0,
"AL": 2826.0,
"AC": 2829.0,
"Vo": 42910.0,
"OI": 479812.0,
"Va": 1217918971856.0,
"CM": "2024-09",
"VoOA": 40405.0,
"EmMrgnTrgDiv": "002",
"LTD": "2024-09-12",
"SQD": "2024-09-13",
"Settle": 2829.0,
"CCMFlag": "1"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/drv-bars-daily-opt-225
# Index Option Prices (OHLC) (/derivatives/bars/daily/options/225)
`GET` /v2/derivatives/bars/daily/options/225
## Overview
Information on the OHLC, settlement price, and theoretical price of Nikkei 225 Options can be obtained through this API.\
The data that can be obtained is only for Nikkei 225 Index Options (excluding Weekly Options and Flexible options).
## Attention
> **Info**
>
> - **About Subscription Plan**
> - This API is available with the Standard plan or higher.
> - **About Trading Session**
> - Prior to February 10, 2011, Trading session consists of the night session, the morning session, and the afternoon session.
> - Morning session data for this period is not recorded, and afternoon session data is recorded as day session data. (Note that the whole day data reflects all sessions.)
> - After February 14, 2011, Trading session consists of the night session and the day session.
> - **About key items in response**
> - When emergency margin is triggered, data as of both the clearing price calculation and the emergency margin calculation are generated for the same trading day and issue. Therefore, it is possible to uniquely identify the record by combining Date, Code and EmMrgnTrgDiv (EmergencyMarginTriggerDivision).
## Get daily Nikkei 225 Options prices (OHLC)
`GET` `https://api.jquants.com/v2/derivatives/bars/daily/options/225`
"date" must be specified.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| date | string | Required | Date (e.g. 20210901 or 2021-09-01) |
| pagination\_key | string | Optional | 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
/v2/derivatives/bars/daily/options/225
**cURL**
```bash
curl -G https://api.jquants.com/v2/derivatives/bars/daily/options/225 \
-H "x-api-key: {{apiKey}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/derivatives/bars/daily/options/225", {
params: {
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/derivatives/bars/daily/options/225",
params={"date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ------------ | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Date | string | Required | Trading day (YYYY-MM-DD) |
| Code | string | Required | Issue code |
| O | number | Required | Open price (whole day) |
| H | number | Required | High price (whole day) |
| L | number | Required | Low price (whole day) |
| C | number | Required | Close price (whole day) |
| EO | number / string | Required | Open price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| EH | number / string | Required | High price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| EL | number / string | Required | Low price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| EC | number / string | Required | Close price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| AO | number | Required | Open price (day session) |
| AH | number | Required | High price (day session) |
| AL | number | Required | Low price (day session) |
| AC | number | Required | Close price (day session) |
| Vo | number | Required | Volume |
| OI | number | Required | Open interest |
| Va | number | Required | Trading value |
| CM | string | Required | Contract month (YYYY-MM) |
| Strike | number | Required | Strike price |
| VoOA | number | Required | Volume (only auction) (\*1) |
| EmMrgnTrgDiv | string | Required | Emergency margin trigger division 001: When emergency margin is triggered, 002: When settlement price is calculated. "001" is recorded only if the emergency margin was triggered after July 19, 2016. |
| PCDiv | string | Required | Put Call division 1: Put, 2: Call |
| LTD | string | Required | Last trading day (YYYY-MM-DD) (\*1) |
| SQD | string | Required | Special quotation day (YYYY-MM-DD) (\*1) |
| Settle | number | Required | Settlement price (\*1) |
| Theo | number | Required | Theoretical price (\*1) |
| BaseVol | number | Required | Base volatility Average of the implied volatility of at-the-money put and call (\*1) |
| UnderPx | number | Required | Underlying price (\*1) |
| IV | number | Required | Implied volatility (\*1) |
| IR | number | Required | Interest rate for theoretical price calculation (\*1) |
\*1 Data after July 19, 2016 contains value for these fields.
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-03-22",
"Code": "130060018",
"O": 0.0,
"H": 0.0,
"L": 0.0,
"C": 0.0,
"EO": 0.0,
"EH": 0.0,
"EL": 0.0,
"EC": 0.0,
"AO": 0.0,
"AH": 0.0,
"AL": 0.0,
"AC": 0.0,
"Vo": 0.0,
"OI": 330.0,
"Va": 0.0,
"CM": "2025-06",
"Strike": 20000.0,
"VoOA": 0.0,
"EmMrgnTrgDiv": "002",
"PCDiv": "1",
"LTD": "2025-06-12",
"SQD": "2025-06-13",
"Settle": 980.0,
"Theo": 974.641,
"BaseVol": 17.93025,
"UnderPx": 27466.61,
"IV": 23.1816,
"IR": 0.2336
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/drv-bars-daily-opt/derivative-product-category
# Options Product Category Codes
| Product Category Code | Product Category Name | Data Recording Period |
| --------------------- | ----------------------- | --------------------- |
| TOPIXE | TOPIX Options | 2008/5/7〜 |
| NK225E | Nikkei 225 Options | 2008/5/7〜 |
| JGBLFE | JGB Futures Options | 2008/5/7〜 |
| EQOP | Securities Options | 2014/11/17〜 |
| NK225MWE | Nikkei 225 mini Options | 2023/5/29〜 |
---
Source: https://jpx-jquants.com/en/spec/drv-bars-daily-opt
# Options Prices (OHLC) (/derivatives/bars/daily/options)
`GET` /v2/derivatives/bars/daily/options
You can obtain Options data (OHLC, settlement price, etc.).
## Overview
Information on the OHLC, settlement price, and theoretical price of Options can be obtained through this API.\
Please refer to [Derivative Product Category Codes](https://jpx-jquants.com/en/spec/drv-bars-daily-opt/derivative-product-category) for the data that can be obtained.
## Attention
> **Info**
>
> - **About Subscription Plan**
> - This API is available only with the Premium plan.
> - **About Issue Code**
> - Please refer to [Securities Code Related Materials](https://www.jpx.co.jp/english/sicc/securities-code/01.html) for the numbering rules of futures and options trading identification codes.
> - **About Trading Session**
> - Prior to February 10, 2011, Trading session consists of the night session, the morning session, and the afternoon session.
> - Morning session data for this period is not recorded, and afternoon session data is recorded as day session data. (Note that the whole day data reflects all sessions.)
> - After February 14, 2011, Trading session consists of the night session and the day session.
> - **About Holiday Trading**
> - Trading days for holiday trading are treated as the same trading day as the night session that starts on the weekday immediately preceding the holiday (business day before the holiday) and the day session on the weekday immediately following the holiday (business day after the holiday).
> - **About key items in response**
> - When emergency margin is triggered, data as of both the clearing price calculation and the emergency margin calculation are generated for the same trading day and issue. Therefore, it is possible to uniquely identify the record by combining Date, Code and EmMrgnTrgDiv (EmergencyMarginTriggerDivision).
## Get daily Options prices (OHLC)
`GET` `https://api.jquants.com/v2/derivatives/bars/daily/options`
"date" must be specified.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| category | string | Optional | Derivative Product Category |
| code | string | Optional | Underlying securities code Set when specifying securities options in category |
| date | string | Required | Date (e.g. 20210901 or 2021-09-01) |
| contract\_flag | string | Optional | Central contract month flag |
| pagination\_key | string | Optional | 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
/v2/derivatives/bars/daily/options
**cURL**
```bash
curl -G https://api.jquants.com/v2/derivatives/bars/daily/options \
-H "x-api-key: {{apiKey}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/derivatives/bars/daily/options", {
params: {
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/derivatives/bars/daily/options",
params={"date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ------------ | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Code | string | Required | Issue code |
| ProdCat | string | Required | Derivative Product Category |
| UndSSO | string | Required | Underlying securities for securities options "-" is set for non-securities options |
| Date | string | Required | Trading day (YYYY-MM-DD) |
| O | number | Required | Open price (whole day) |
| H | number | Required | High price (whole day) |
| L | number | Required | Low price (whole day) |
| C | number | Required | Close price (whole day) |
| MO | number / string | Required | Open price (morning session) If the stock is not eligible for morning/afternoon session, a blank character is set. |
| MH | number / string | Required | High price (morning session) If the stock is not eligible for morning/afternoon session, a blank character is set. |
| ML | number / string | Required | Low price (morning session) If the stock is not eligible for morning/afternoon session, a blank character is set. |
| MC | number / string | Required | Close price (morning session) If the stock is not eligible for morning/afternoon session, a blank character is set. |
| EO | number / string | Required | Open price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| EH | number / string | Required | High price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| EL | number / string | Required | Low price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| EC | number / string | Required | Close price (night session) For the issue on the first day of trading, blank is set since there is no night session. |
| AO | number | Required | Open price (day session) |
| AH | number | Required | High price (day session) |
| AL | number | Required | Low price (day session) |
| AC | number | Required | Close price (day session) |
| Vo | number | Required | Volume |
| OI | number | Required | Open interest |
| Va | number | Required | Trading value |
| CM | string | Required | Contract month (YYYY-MM) For Nikkei 225 mini options, it shows weeks instead of months (e.g. 2024-51 is the 51st week of 2024). |
| Strike | number | Required | Strike price |
| VoOA | number | Required | Volume (only auction) (\*1) |
| EmMrgnTrgDiv | string | Required | Emergency margin trigger division 001: When emergency margin is triggered, 002: When settlement price is calculated. "001" is recorded only if the emergency margin was triggered after July 19, 2016. |
| PCDiv | string | Required | Put Call division 1: Put, 2: Call |
| LTD | string | Required | Last trading day (YYYY-MM-DD) (\*1) |
| SQD | string | Required | Special quotation day (YYYY-MM-DD) (\*1) |
| Settle | number | Required | Settlement price (\*1) |
| Theo | number | Required | Theoretical price (\*1) |
| BaseVol | number | Required | Base volatility (\*1) |
| UnderPx | number | Required | Underlying price (\*1) |
| IV | number | Required | Implied volatility (\*1) |
| IR | number | Required | Interest rate for theoretical price calculation (\*1) |
| CCMFlag | string | Required | Flag of the central contract month (1: Central contract month, 0: Others) (\*1) |
\*1 Data after July 19, 2016 contains value for these fields.
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Code": "140014505",
"ProdCat": "TOPIXE",
"UndSSO": "-",
"Date": "2024-07-23",
"O": 0.0,
"H": 0.0,
"L": 0.0,
"C": 0.0,
"MO": "",
"MH": "",
"ML": "",
"MC": "",
"EO": 0.0,
"EH": 0.0,
"EL": 0.0,
"EC": 0.0,
"AO": 0.0,
"AH": 0.0,
"AL": 0.0,
"AC": 0.0,
"Vo": 0.0,
"OI": 0.0,
"Va": 0.0,
"CM": "2025-01",
"Strike": 2450.0,
"VoOA": 0.0,
"EmMrgnTrgDiv": "002",
"PCDiv": "2",
"LTD": "2025-01-09",
"SQD": "2025-01-10",
"Settle": 377.0,
"Theo": 380.3801,
"BaseVol": 18.115,
"UnderPx": 2833.39,
"IV": 17.2955,
"IR": 0.3527,
"CCMFlag": "0"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/edinet-cross-shareholdings
# Cross-Shareholdings (EDINET)(/edinet/cross-shareholdings)
`GET` /v2/edinet/cross-shareholdings
## Overview
Retrieves, per scope (the reporting company itself, the consolidated group company with the largest holdings, and the second-largest holdings) disclosed in Section 4 "Status of Shares" of the Annual Securities Report (Form No.3), the listed / non-listed share counts and their changes, the specified investment / deemed holding records, and footnote text.
## Attention
> **Info**
>
> - Available from March 31, 2020 onward. Target document is the Annual Securities Report.
> - Available on the Standard plan or higher (Free / Light plans cannot use this API). Historical range: Standard up to 10 years, Premium up to 20 years.
> - Cross-shareholdings data is available via API only. File download (CSV / Bulk) is not supported.
> - The data provided by this API is refined using an LLM.
## Retrieve the cross-shareholdings status
`GET` `https://api.jquants.com/v2/edinet/cross-shareholdings`
`edinet_code` / `code` / `date` are all optional.\
The parameter combinations and response are as follows.
- edinet\_code/code: –, date: – → All reports submitted today
- edinet\_code/code: ✓, date: – → Reports for the specified EDINET code / issue code (within the plan's historical range)
- edinet\_code/code: –, date: ✓ → All reports submitted on the specified date
- edinet\_code/code: ✓, date: ✓ → The report for the specified EDINET code / issue code submitted on the specified date
※ Specifying both `edinet_code` and `code` at the same time returns an error (400).\
※ If no matching data exists, an empty array (`"data": []`) is returned.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| edinet\_code | string | Optional | EDINET code (e.g. E02367) |
| code | string | Optional | Issue code (e.g. 79740 or 7974) |
| date | string | Optional | Submission date (e.g. 20250620 or 2025-06-20) |
| pagination\_key | string | Optional | Pagination key string Specify the value returned by the previous call's pagination\_key. |
### Sample request code
/v2/edinet/cross-shareholdings
**cURL**
```bash
curl -G https://api.jquants.com/v2/edinet/cross-shareholdings \
-H "x-api-key: {{apiKey}}" \
-d edinet_code="{{edinet_code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/edinet/cross-shareholdings', {
params: {
edinet_code: '{{edinet_code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/edinet/cross-shareholdings",
params={"edinet_code": "{{edinet_code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Response fields
#### Document metadata (one object per filing)
| Parameter | Type | Required | Description |
| ------------- | ------ | -------- | ----------------------------------------------------------------------------------- |
| DocId | string | Required | EDINET document management number (`S` + 7 alphanumeric characters) |
| Code | string | Required | Issue code of the filer (5 digits) |
| EdinetCode | string | Required | EDINET code of the filer |
| FilerName | string | Required | Filer name (Japanese) |
| FilerNameEn | string | Required | Filer name (English) |
| DocTypeCode | string | Required | Document type code (`120` = Annual Securities Report) |
| SubDate | string | Required | Submission date (YYYY-MM-DD) |
| SubTime | string | Required | Submission time (HH:MM:SS) |
| PerSt | string | Required | Start date of the target fiscal year (YYYY-MM-DD) |
| PerEn | string | Required | End date of the target fiscal year (YYYY-MM-DD) |
| Report | object | Required | Holdings block for the reporting company itself. |
| Largest | object | Required | Holdings block for the consolidated group company with the largest holdings. |
| SecondLargest | object | Required | Holdings block for the consolidated group company with the second-largest holdings. |
#### Holder block (shared by `Report` / `Largest` / `SecondLargest`)
| Parameter | Type | Required | Description |
| ------------------- | ------ | -------- | ----------------------------------------------------------------- |
| HldrName | string | Required | Name of this holder |
| HldrCode | string | Required | Issue code of this holder (5 digits) |
| HldrEdinetCode | string | Required | EDINET code of this holder |
| ListedIss | number | Required | Listed: number of issues |
| ListedBookVal | number | Required | Listed: total carrying amount (JPY) |
| ListedIncIss | number | Required | Listed: number of issues whose share count increased |
| ListedIncAcqCost | number | Required | Listed: total acquisition cost for the increased shares (JPY) |
| ListedDecIss | number | Required | Listed: number of issues whose share count decreased |
| ListedDecSaleAmt | number | Required | Listed: total sale amount for the decreased shares (JPY) |
| ListedIncRsn | string | Required | Listed: reason for the increase in shares |
| NonListedIss | number | Required | Non-listed: number of issues |
| NonListedBookVal | number | Required | Non-listed: total carrying amount (JPY) |
| NonListedIncIss | number | Required | Non-listed: number of issues whose share count increased |
| NonListedIncAcqCost | number | Required | Non-listed: total acquisition cost for the increased shares (JPY) |
| NonListedDecIss | number | Required | Non-listed: number of issues whose share count decreased |
| NonListedDecSaleAmt | number | Required | Non-listed: total sale amount for the decreased shares (JPY) |
| NonListedIncRsn | string | Required | Non-listed: reason for the increase in shares |
| Spec | array | Required | Array of specified investment holding records |
| Deem | array | Required | Array of deemed holding records |
| SpecFn | string | Required | Footnote for specified investment holdings |
| DeemFn | string | Required | Footnote for deemed holdings |
#### Issue record (element of `Spec[]` / `Deem[]`)
| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------- |
| IsrName | string | Required | Name of the held entity |
| IsrCode | string | Required | Issue code of the held entity (5 digits, resolved by name from `IsrName`) |
| IsrEdinetCode | string | Required | EDINET code of the held entity (resolved by name from `IsrName`) |
| CurShs | number | Required | Number of shares in the current fiscal year |
| PriShs | number | Required | Number of shares in the prior fiscal year |
| CurBookVal | number | Required | Carrying amount in the current fiscal year (JPY) |
| PriBookVal | number | Required | Carrying amount in the prior fiscal year (JPY) |
| CurShsNotDisc | string | Required | Raw non-disclosure marker for the current-year share count (`*` / `＊` / `※` / `（注 N）`) |
| PriShsNotDisc | string | Required | Raw non-disclosure marker for the prior-year share count |
| CurBookValNotDisc | string | Required | Raw non-disclosure marker for the current-year carrying amount |
| PriBookValNotDisc | string | Required | Raw non-disclosure marker for the prior-year carrying amount |
| HoldRat | string | Required | Purpose / business alliance / quantitative effect / reason for increase (combined text) |
| IsrHolds | string | Required | Raw indicator of whether the issuer holds the reporting company's shares (e.g., `"有"` / `"無"` / `"無(注)３"`) |
| IsrHoldsCode | string | Required | Normalized 3-value form (`"1"` = holds, `"0"` = does not hold, `"2"` = undetermined) |
### Response sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"DocId": "S100YA84",
"Code": "86970",
"EdinetCode": "E03814",
"FilerName": "株式会社日本取引所グループ",
"FilerNameEn": "Japan Exchange Group, Inc.",
"DocTypeCode": "120",
"SubDate": "2026-06-11",
"SubTime": "15:00:00",
"PerSt": "2025-04-01",
"PerEn": "2026-03-31",
"Report": {
"HldrName": "株式会社日本取引所グループ",
"HldrCode": "86970",
"HldrEdinetCode": "E03814",
"ListedIss": 0,
"ListedBookVal": 0,
"ListedIncIss": 0,
"ListedIncAcqCost": 0,
"ListedDecIss": 0,
"ListedDecSaleAmt": 0,
"ListedIncRsn": null,
"NonListedIss": 6,
"NonListedBookVal": 1035000000,
"NonListedIncIss": 0,
"NonListedIncAcqCost": 0,
"NonListedDecIss": 0,
"NonListedDecSaleAmt": 0,
"NonListedIncRsn": null,
"Spec": [
{
"IsrName": "Sample Bank, Ltd.",
"IsrCode": "56780",
"IsrEdinetCode": "E05678",
"CurShs": 1200000,
"PriShs": 1200000,
"CurBookVal": 850000000,
"PriBookVal": 820000000,
"CurShsNotDisc": null,
"PriShsNotDisc": null,
"CurBookValNotDisc": null,
"PriBookValNotDisc": null,
"HoldRat": "To maintain and strengthen business relationships",
"IsrHolds": "有",
"IsrHoldsCode": "1"
}
],
"Deem": [
{
"IsrName": "Sample Electric Co., Ltd.",
"IsrCode": "90120",
"IsrEdinetCode": "E09012",
"CurShs": 500000,
"PriShs": null,
"CurBookVal": 350000000,
"PriBookVal": null,
"CurShsNotDisc": null,
"PriShsNotDisc": "（注3）",
"CurBookValNotDisc": null,
"PriBookValNotDisc": "（注3）",
"HoldRat": "Because the reporter holds voting-direction authority",
"IsrHolds": "無(注)３",
"IsrHoldsCode": "0"
}
],
"SpecFn": "Note: Specified investment shares are held to maintain and strengthen business relationships.
",
"DeemFn": "(Note 3) These shares are effectively held through a retirement benefit trust, and the reporter retains voting-direction authority under the trust agreement. Prior-period share counts and book values are not disclosed due to a change in the trust contract.
"
},
"Largest": null,
"SecondLargest": {
"HldrName": "株式会社東京証券取引所",
"HldrCode": null,
"HldrEdinetCode": null,
"ListedIss": 0,
"ListedBookVal": 0,
"ListedIncIss": 0,
"ListedIncAcqCost": 0,
"ListedDecIss": 0,
"ListedDecSaleAmt": 0,
"ListedIncRsn": null,
"NonListedIss": 2,
"NonListedBookVal": 953000000,
"NonListedIncIss": 0,
"NonListedIncAcqCost": 0,
"NonListedDecIss": 0,
"NonListedDecSaleAmt": 0,
"NonListedIncRsn": null,
"Spec": [],
"Deem": [],
"SpecFn": null,
"DeemFn": null
}
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/edinet-large-volume-shareholders
# Large Volume Holding Reports (EDINET)(/edinet/large-volume-shareholders)
`GET` /v2/edinet/large-volume-shareholders
## Overview
Retrieves the issuer and filer information disclosed in Large Volume Holding Reports, their Change Reports, and Amendment Reports.
## Attention
> **Info**
>
> - Available for filings submitted on or after July 1, 2021. Target documents are Large Volume Holding Reports and Change Reports (document type code 350) and Amendment Reports (document type code 360).
> - An Amendment Report does not replace the document it amends; it is added as a separate record. The Amendment Report record includes the document management number of the document being amended (`ParDocId`).
> - The method for calculating the number of share certificates held and the holding ratio may change due to regulatory revisions. Because such a change can give rise to a filing obligation, please note that a filing, or a change in the reported values, does not necessarily involve a purchase or sale. ※ Effective May 1, 2026, amendments to the Large Shareholding Reporting Rule changed its scope, the calculation of shareholding ratios, the definition of joint holders, and the reporting forms. Accordingly, changes in the number of shares held, shareholding ratios, or holder composition around this date may occur without any acquisition or disposal of shares. In particular, for reports with a reporting obligation date of May 1, 2026, do not identify trading activity solely from differences from the previous report. Also review the acquisitions and disposals during the preceding 60 days, the reason for the change, and the original report where necessary. The applicable rules and reporting forms are determined by the date on which the reporting obligation arose, rather than the filing date. For further information, please refer to the [materials published by the Financial Services Agency](https://www.fsa.go.jp/en/newsletter/weekly2025/644.html).
> - Available on the Standard plan or higher (Free / Light plans cannot use this API). Historical range: Standard up to 10 years, Premium up to 20 years.
> - Large volume holding data is available via API only. File download (CSV / Bulk) is not supported.
## Retrieve the large volume holding reports
`GET` `https://api.jquants.com/v2/edinet/large-volume-shareholders`
`edinet_code` / `code` / `date` are all optional.\
The parameter combinations and response are as follows.
- edinet\_code/code: –, date: – → All filings submitted today
- edinet\_code/code: ✓, date: – → Filings for the specified issuer's EDINET code / issue code (within the plan's historical range)
- edinet\_code/code: –, date: ✓ → All filings submitted on the specified date
- edinet\_code/code: ✓, date: ✓ → Filings for the specified issuer's EDINET code / issue code submitted on the specified date
※ Specifying both `edinet_code` and `code` at the same time returns an error (400).\
※ If no matching data exists, an empty array (`"data": []`) is returned.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| edinet\_code | string | Optional | EDINET code of the issuer (e.g. E03814) |
| code | string | Optional | Issue code of the issuer (e.g. 86970 or 8697) |
| date | string | Optional | Submission date (e.g. 20250620 or 2025-06-20) |
| pagination\_key | string | Optional | Pagination key string Specify the value returned by the previous call's pagination\_key. |
### Sample request code
/v2/edinet/large-volume-shareholders
**cURL**
```bash
curl -G https://api.jquants.com/v2/edinet/large-volume-shareholders \
-H "x-api-key: {{apiKey}}" \
-d edinet_code="{{edinet_code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/edinet/large-volume-shareholders', {
params: {
edinet_code: '{{edinet_code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/edinet/large-volume-shareholders",
params={"edinet_code": "{{edinet_code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Response fields
#### Document metadata (one object per filing)
| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| DocId | string | Required | EDINET document management number (`S` + 7 alphanumeric characters) |
| Code | string | Required | Issue code of the issuer (5 digits) |
| EdinetCode | string | Required | EDINET code of the issuer |
| IsrName | string | Required | Issuer name |
| DocTypeCode | string | Required | Document type code (`350` = Large Volume Holding Report family / `360` = Large Volume Holding Report family (Amendment)) |
| SubDate | string | Required | Submission date (YYYY-MM-DD) |
| SubTime | string | Required | Submission time (HH:MM:SS) |
| RptOblgDate | string | Required | Reporting obligation date (YYYY-MM-DD) |
| ParDocId | string | Required | Document management number of the document being amended (Amendment Reports only) |
| LargeHldgTypeCode | string | Required | Report type code (`1`=Large Volume Holding Report / `2`=Change Report / `3`=Change Report (short-term large volume transfer) / `4`=Large Volume Holding Report (securities subject to special provisions) / `5`=Change Report (securities subject to special provisions) / `6`=Amendment Report / `0`=Unknown) |
| DocTitle | string | Required | Document title |
| ChgRsn | string | Required | Reason for the change as of the reporting obligation date (Change Reports only) |
| TotalShsHeld | number | Required | Total number of share certificates, etc. held |
| TotalShsRatio | number | Required | Total holding ratio of share certificates, etc. Decimal expression (0.1343 = 13.43%) |
| TotalShsRatioLast | number | Required | Total holding ratio per the previous report (Change Reports only) |
| TotalOutStks | number | Required | Total number of outstanding shares, etc. |
| Hldrs | array | Required | Array of the filer and joint holders |
#### Hldrs array element
| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------- |
| HldrName | string | Required | Name of the holder |
| HldrNameEn | string | Required | Name of the holder (English) |
| HldrEdinetCode | string | Required | EDINET code of the holder |
| HldrCode | string | Required | Issue code of the holder (when the holder is a listed company, etc.) |
| LargeHldrTypeCode | string | Required | Holder type code (`1`=Individual / `2`=Corporation / `0`=Unknown) |
| LargeHldrTypeRaw | string | Required | Raw holder-type text as stated in the filing |
| HldgPurp | string | Required | Purpose of holding |
| ImpProp | string | Required | Act of making important proposals, etc. |
| ColAgr | string | Required | Material contracts such as collateral agreements |
| ShsHeld | number | Required | Number of share certificates, etc. held |
| ShsRatio | number | Required | Holding ratio of share certificates, etc. Decimal expression (0.0572 = 5.72%) |
| ShsRatioLast | number | Required | Holding ratio per the previous report (Change Reports only) |
| OwnFund | number | Required | Acquisition funds: own funds (JPY) |
| TotalBrw | number | Required | Acquisition funds: total borrowings (JPY) |
| TotalOther | number | Required | Acquisition funds: total from other sources (JPY) |
| OtherBrk | string | Required | Breakdown of the total amount from other sources (e.g. shares acquired via stock split), when stated |
| TotalFund | number | Required | Total acquisition funds (JPY) |
| AcqDisp | array | Required | Array of acquisitions / disposals during the last 60 days |
| BrwList | array | Required | Array of the breakdown of borrowings |
| CredList | array | Required | Array of the names, etc. of creditors |
#### AcqDisp array element (acquisitions / disposals during the last 60 days)
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------- |
| Date | string | Required | Date (YYYY-MM-DD) |
| SecType | string | Required | Type of share certificates, etc. (e.g. common shares) |
| Shs | number | Required | Number of shares |
| Ratio | number | Required | Ratio (%) |
| Mkt | string | Required | On-market / off-market distinction (raw text as stated in the filing) |
| MktCode | string | Required | On-market / off-market code (`1`=on-market / `2`=off-market) |
| TxnType | string | Required | Acquisition / disposal distinction (raw text as stated in the filing) |
| TxnTypeCode | string | Required | Acquisition / disposal code (`1`=acquisition / `2`=disposal) |
| Cptty | string | Required | Counterparty of the transfer (stated only in Change Reports for short-term large volume transfer) |
| Price | number | Required | Unit price (JPY) |
| PriceRaw | string | Required | Raw unit-price value |
#### BrwList array element (breakdown of borrowings)
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------- |
| Name | string | Required | Name (including branch name) |
| Ind | string | Required | Industry |
| Rep | string | Required | Name of the representative |
| Addr | string | Required | Address |
| DiscBrwPurp | string | Required | Disclosure of borrowing purpose (`1`=not disclosed to banks / `2`=disclosed to banks and non-bank borrowings) |
| Amt | number | Required | Amount (JPY) |
#### CredList array element (names, etc. of creditors)
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ---------------------------- |
| Name | string | Required | Name (including branch name) |
| Rep | string | Required | Name of the representative |
| Addr | string | Required | Address |
### Sample response
```bash {{ title: "200:OK" }}
{
"data": [
{
"DocId": "S100WBIV",
"Code": "86970",
"EdinetCode": "E03814",
"IsrName": "株式会社日本取引所グループ",
"DocTypeCode": "350",
"SubDate": "2025-07-07",
"SubTime": "12:09:00",
"RptOblgDate": "2025-06-30",
"ParDocId": null,
"LargeHldgTypeCode": "5",
"DocTitle": "変更報告書ＮＯ．9",
"ChgRsn": "・株券等保有割合の１％以上の増加",
"TotalShsHeld": 76018630,
"TotalShsRatio": 0.0728,
"TotalShsRatioLast": 0.0614,
"TotalOutStks": 1044578366,
"Hldrs": [
{
"HldrName": "サンプル・アセットマネジメント株式会社",
"HldrNameEn": "Sample Asset Management Co., Ltd.",
"HldrEdinetCode": "E99990",
"HldrCode": null,
"LargeHldrTypeCode": "2",
"LargeHldrTypeRaw": "法人(株式会社)",
"HldgPurp": "信託財産の運用として保有している。",
"ImpProp": null,
"ColAgr": null,
"ShsHeld": 59555500,
"ShsRatio": 0.057,
"ShsRatioLast": 0.0506,
"OwnFund": null,
"TotalBrw": null,
"TotalOther": null,
"OtherBrk": null,
"TotalFund": null,
"AcqDisp": [],
"BrwList": [],
"CredList": []
},
{
"HldrName": "サンプル証券株式会社",
"HldrNameEn": "Sample Securities Co., Ltd.",
"HldrEdinetCode": "E99991",
"HldrCode": null,
"LargeHldrTypeCode": "2",
"LargeHldrTypeRaw": "法人(株式会社)",
"HldgPurp": "証券業務に係る商品在庫として保有している。",
"ImpProp": null,
"ColAgr": "消費貸借契約により、サンプル信託銀行株式会社から1,000,000株 借入れている。（本項目はサンプルです）",
"ShsHeld": 8893542,
"ShsRatio": 0.0085,
"ShsRatioLast": 0.0095,
"OwnFund": 300000000,
"TotalBrw": 500000000,
"TotalOther": null,
"OtherBrk": null,
"TotalFund": 800000000,
"AcqDisp": [
{
"Date": "2025-06-20",
"SecType": "普通株式",
"Shs": 100000,
"Ratio": 0.01,
"Mkt": "市場内",
"MktCode": "1",
"TxnType": "取得",
"TxnTypeCode": "1",
"Cptty": null,
"Price": 3800,
"PriceRaw": null
}
],
"BrwList": [
{
"Name": "サンプル銀行株式会社",
"Ind": "銀行",
"Rep": "代表取締役 見本 太郎",
"Addr": "東京都千代田区丸の内一丁目1番1号",
"DiscBrwPurp": "2",
"Amt": 500000000
}
],
"CredList": [
{
"Name": "サンプル信託銀行株式会社",
"Rep": "代表取締役 例示 花子",
"Addr": "東京都千代田区大手町一丁目1番1号"
}
]
}
]
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/edinet-major-shareholders
# Major Shareholders (EDINET)(/edinet/major-shareholders)
`GET` /v2/edinet/major-shareholders
## Overview
Retrieves the major shareholders disclosed in the Annual Securities Report, the Semiannual Report and the Quarterly Report.
## Attention
> **Info**
>
> - Available from June 1, 2016 onward. Target documents are the Annual Securities Report (Form No.3), the Semiannual Report (Form No.4-3 and Form No.5) and the Quarterly Report (Form No.4-3).
> - Following the abolition of quarterly reports on April 1, 2024, quarterly report data is available only through October 2024.
> - Semiannual report data (Form No. 5) submitted by domestic unlisted companies is available only from June 2023 onward.
> - Available on the Standard plan or higher (Free / Light plans cannot use this API). Historical range: Standard up to 10 years, Premium up to 20 years.
> - Major shareholders data typically contains the top 10 entries, but may include 11 or more when the report lists tied ranks, or only one when the issuer has a single 100%-owning parent.
> - Major shareholders data is available via API only. File download (CSV / Bulk) is not supported.
## Retrieve the major shareholders status
`GET` `https://api.jquants.com/v2/edinet/major-shareholders`
`edinet_code` / `code` / `date` are all optional.\
The parameter combinations and response are as follows.
- edinet\_code/code: –, date: – → All reports submitted today
- edinet\_code/code: ✓, date: – → Reports for the specified EDINET code / issue code (within the plan's historical range)
- edinet\_code/code: –, date: ✓ → All reports submitted on the specified date
- edinet\_code/code: ✓, date: ✓ → The report for the specified EDINET code / issue code submitted on the specified date
※ Specifying both `edinet_code` and `code` at the same time returns an error (400).\
※ If no matching data exists, an empty array (`"data": []`) is returned.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| edinet\_code | string | Optional | EDINET code (e.g. E03814) |
| code | string | Optional | Issue code (e.g. 86970 or 8697) |
| date | string | Optional | Submission date (e.g. 20250620 or 2025-06-20) |
| pagination\_key | string | Optional | Pagination key string Specify the value returned by the previous call's pagination\_key. |
### Sample request code
/v2/edinet/major-shareholders
**cURL**
```bash
curl -G https://api.jquants.com/v2/edinet/major-shareholders \
-H "x-api-key: {{apiKey}}" \
-d edinet_code="{{edinet_code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/edinet/major-shareholders', {
params: {
edinet_code: '{{edinet_code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/edinet/major-shareholders",
params={"edinet_code": "{{edinet_code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Response fields
#### Document metadata (one object per filing)
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------- |
| DocId | string | Required | EDINET document management number (`S` + 7 alphanumeric characters) |
| Code | string | Required | Issue code of the filer (5 digits) |
| EdinetCode | string | Required | EDINET code of the filer |
| FilerName | string | Required | Filer name (Japanese) |
| FilerNameEn | string | Required | Filer name (English) |
| DocTypeCode | string | Required | Document type code (`120` = Annual Securities Report, `140` = Quarterly Report, `160` = Semiannual Report) |
| SubDate | string | Required | Submission date (YYYY-MM-DD) |
| SubTime | string | Required | Submission time (HH:MM:SS) |
| PerSt | string | Required | Start date of the current fiscal year (YYYY-MM-DD) |
| PerEn | string | Required | End date of the current fiscal year (YYYY-MM-DD) |
| CurPerSt | string | Required | Start date of the current accounting period (YYYY-MM-DD) |
| CurPerEn | string | Required | End date of the current accounting period (YYYY-MM-DD) |
| Hldrs | array | Required | Array of shareholder records, sorted by Rank ascending |
#### Hldrs array element
| Parameter | Type | Required | Description |
| --------- | ------- | -------- | ------------------------------------------------------------------------------------------------ |
| Rank | integer | Required | Rank (1–10; 11+ for ties) |
| HldrName | string | Required | Name of the shareholder |
| HldrAddr | string | Required | Address of the shareholder |
| ShsHeld | number | Required | Number of shares held |
| ShsRatio | number | Required | Ratio of shares held to issued shares (excluding treasury). Decimal expression (0.1881 = 18.81%) |
### Response sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"DocId": "S100YA84",
"Code": "86970",
"EdinetCode": "E03814",
"FilerName": "株式会社日本取引所グループ",
"FilerNameEn": "Japan Exchange Group, Inc.",
"DocTypeCode": "120",
"SubDate": "2026-06-11",
"SubTime": "15:00:00",
"PerSt": "2025-04-01",
"PerEn": "2026-03-31",
"CurPerSt": "2025-04-01",
"CurPerEn": "2026-03-31",
"Hldrs": [
{
"Rank": 1,
"HldrName": "日本マスタートラスト信託銀行株式会社（信託口）",
"HldrAddr": "東京都港区赤坂１丁目８番１号 赤坂インターシティＡＩＲ",
"ShsHeld": 175830000,
"ShsRatio": 0.1704
},
{
"Rank": 2,
"HldrName": "株式会社日本カストディ銀行（信託口）",
"HldrAddr": "東京都中央区晴海１丁目８－１２",
"ShsHeld": 56970000,
"ShsRatio": 0.0552
},
{
"Rank": 3,
"HldrName": "ＳＴＡＴＥ ＳＴＲＥＥＴ ＢＡＮＫ ＡＮＤ ＴＲＵＳＴ ＣＯＭＰＡＮＹ ５０５００１（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "ＯＮＥ ＣＯＮＧＲＥＳＳ ＳＴＲＥＥＴ， ＳＵＩＴＥ １， ＢＯＳＴＯＮ， ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 26685000,
"ShsRatio": 0.0259
},
{
"Rank": 4,
"HldrName": "ＳＴＡＴＥ ＳＴＲＥＥＴ ＢＡＮＫ ＡＮＤ ＴＲＵＳＴ ＣＯＭＰＡＮＹ ５０５３０１（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "ＯＮＥ ＣＯＮＧＲＥＳＳ ＳＴＲＥＥＴ， ＳＵＩＴＥ １， ＢＯＳＴＯＮ， ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 17838000,
"ShsRatio": 0.0173
},
{
"Rank": 5,
"HldrName": "ＪＰモルガン証券株式会社",
"HldrAddr": "東京都千代田区丸の内２丁目７－３ 東京ビルディング",
"ShsHeld": 15316000,
"ShsRatio": 0.0148
},
{
"Rank": 6,
"HldrName": "ＪＰ ＭＯＲＧＡＮ ＣＨＡＳＥ ＢＡＮＫ ３８５７８１（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "２５ ＢＡＮＫ ＳＴＲＥＥＴ， ＣＡＮＡＲＹ ＷＨＡＲＦ， ＬＯＮＤＯＮ， Ｅ１４ ５ＪＰ， ＵＮＩＴＥＤ ＫＩＮＧＤＯＭ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 15139000,
"ShsRatio": 0.0147
},
{
"Rank": 7,
"HldrName": "株式会社三菱ＵＦＪ銀行",
"HldrAddr": "東京都千代田区丸の内１丁目４番５号",
"ShsHeld": 15114000,
"ShsRatio": 0.0146
},
{
"Rank": 8,
"HldrName": "ＳＴＡＴＥ ＳＴＲＥＥＴ ＢＡＮＫ ＡＮＤ ＴＲＵＳＴ ＣＯＭＰＡＮＹ ５０５１０３（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "ＯＮＥ ＣＯＮＧＲＥＳＳ ＳＴＲＥＥＴ， ＳＵＩＴＥ １， ＢＯＳＴＯＮ， ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 14996000,
"ShsRatio": 0.0145
},
{
"Rank": 9,
"HldrName": "ＨＳＢＣ ＨＯＮＧ ＫＯＮＧ－ＴＲＥＡＳＵＲＹ ＳＥＲＶＩＣＥＳ Ａ／Ｃ ＡＳＩＡＮ ＥＱＵＩＴＩＥＳ ＤＥＲＩＶＡＴＩＶＥＳ（常任代理人 香港上海銀行東京支店）",
"HldrAddr": "１ ＱＵＥＥＮ’Ｓ ＲＯＡＤ ＣＥＮＴＲＡＬ，ＨＯＮＧ ＫＯＮＧ（東京都中央区日本橋３丁目１１－１）",
"ShsHeld": 14484000,
"ShsRatio": 0.014
},
{
"Rank": 10,
"HldrName": "Ｊ．Ｐ． ＭＯＲＧＡＮ ＢＡＮＫ ＬＵＸＥＭＢＯＵＲＧ Ｓ．Ａ． ３８４５１３（常任代理人 株式会社みずほ銀行決済営業部）",
"HldrAddr": "ＥＵＲＯＰＥＡＮ ＢＡＮＫ ＡＮＤ ＢＵＳＩＮＥＳＳ ＣＥＮＴＥＲ ６， ＲＯＵＴＥ ＤＥ ＴＲＥＶＥＳ， Ｌ－２６３３ ＳＥＮＮＩＮＧＥＲＢＥＲＧ， ＬＵＸＥＭＢＯＵＲＧ（東京都港区港南２丁目１５－１ 品川インターシティＡ棟）",
"ShsHeld": 14035000,
"ShsRatio": 0.0136
}
]
},
{
"DocId": "S100XBRL",
"Code": "86970",
"EdinetCode": "E03814",
"FilerName": "株式会社日本取引所グループ",
"FilerNameEn": "Japan Exchange Group, Inc.",
"DocTypeCode": "160",
"SubDate": "2025-11-14",
"SubTime": "15:00:00",
"PerSt": "2025-04-01",
"PerEn": "2026-03-31",
"CurPerSt": "2025-04-01",
"CurPerEn": "2025-09-30",
"Hldrs": [
{
"Rank": 1,
"HldrName": "日本マスタートラスト信託銀行株式会社（信託口）",
"HldrAddr": "東京都港区赤坂１丁目８番１号 赤坂インターシティＡＩＲ",
"ShsHeld": 176520000,
"ShsRatio": 0.1711
}
]
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/eq-bars-daily-am
# Morning Session Stock Prices (OHLC) (/equities/bars/daily/am)
`GET` /v2/equities/bars/daily/am
## Overview
You can obtain the morning session's high, low, opening, and closing prices for individual stocks as quick updates at noon.
### Attention
> **Info**
>
> - Null is recorded for the open, high, low, close, volume and trading value for stocks for which there is no trading volume in the morning session.
> - Stocks that are not listed on the TSE (including issue listed only on the other exchanges) are not included in the data.
> - Data for the day can be obtained until around 6:00 the next day.
> For historical data, please use [Stock Prices (OHLC)](https://jpx-jquants.com/en/spec/eq-bars-daily).
## Get stock prices in the morning session
`GET` `https://api.jquants.com/v2/equities/bars/daily/am`
In your request message, "code" can be specified.
### Parameter and Response
In your request message, "code" can be specified.\
Parameter in the request and results are as below.
- code: ✓ → A specified issue price in the morning session
- code: – → All listed issue prices in the morning session
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | 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. |
| pagination\_key | string | Optional | 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
/v2/equities/bars/daily/am
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/bars/daily/am \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/bars/daily/am', {
params: {
code: '{{code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/bars/daily/am",
params={"code": "{{code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------------------------- |
| Date | string | Required | Date (YYYY-MM-DD) |
| Code | string | Required | Issue code |
| MO | number | Required | Open price of the morning session |
| MH | number | Required | High price of the morning session |
| ML | number | Required | Low price of the morning session |
| MC | number | Required | Close price of the morning session |
| MVo | number | Required | Trading volume of the morning session |
| MVa | number | Required | Trading value of the morning session |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-03-20",
"Code": "39400",
"MO": 232.0,
"MH": 244.0,
"ML": 232.0,
"MC": 240.0,
"MVo": 52600.0,
"MVa": 12518800.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/eq-bars-daily/adj
# How to calculate adjusted prices
> **Note**
>
> The price data obtained via file download does not include adjusted price values.
> If you are using downloaded files (instead of calling the API), use the provided adjustment factor to calculate adjusted prices yourself.
In addition to unadjusted prices (`O/H/L/C/Vo`), the data includes **the adjustment factor** `AdjFactor` to reflect stock splits/reverse splits
(e.g., **for a 1:2 stock split,** `AdjFactor = 0.5` **on the ex-date**).
This page explains, for spreadsheet users, **how to calculate adjusted prices (e.g., adjusted close) yourself** using `AdjFactor`.
## Assumptions (what “adjusted” means here)
- **Goal**: Remove artificial jumps caused by stock splits/reverse splits and rights issues so the time series is easier to compare.
- **Scope**: Adjustments in this API cover **stock splits/reverse splits and rights issues** (rights issues of foreign stocks and issues listed on TOKYO PRO Market, and some corporate actions such as dividends, are not covered).
## Concept
`AdjFactor` is the factor populated on the ex-date (the effective date of a split/reverse split, etc.).
To adjust historical prices, you need to **accumulate (multiply) the** `AdjFactor` **values that appear on later (more recent) dates**.
In other words, older dates should reflect more subsequent split/reverse split (and similar) events, so you first create a **cumulative adjustment factor (`CumAdj`)** and then apply it to prices.
## Steps in a spreadsheet (with a table example)
### 1) Prepare the required columns from the downloaded file
At minimum, you need these columns:
- `Date`
- `C` (unadjusted close) — the same logic applies to `O/H/L`
- `Vo` (unadjusted volume) — if you also want adjusted volume
- `AdjFactor` (adjustment factor)
### 2) Sort by date in descending order (newest first)
**This is the most important point.** Sort `Date` in **descending order** so you can compute `CumAdj` from top to bottom.
### 3) Create the cumulative adjustment factor `CumAdj`
Create a table like the following (this example assumes a single 1:2 split occurs once in the period).
| Row | A:Date | B:C (unadjusted) | C:Vo (unadjusted) | D:AdjFactor | E:CumAdj (cumulative) | F:AdjC (calculated) | G:AdjVo (calculated) |
| --: | :--------- | ---------------: | ----------------: | ----------: | --------------------: | ------------------: | -------------------: |
| 2 | 2024-01-12 | 500 | 1,200,000 | 1.0 | | | |
| 3 | 2024-01-11 | 480 | 2,400,000 | 0.5 | | | |
| 4 | 2024-01-10 | 980 | 1,100,000 | 1.0 | | | |
Define `CumAdj` as “**the product of all `AdjFactor` values on dates newer than the current row**”.
(Because an ex-date factor should be applied to dates **before** that ex-date, it effectively impacts the **next row down (older date)** in this top-to-bottom calculation.)
#### Cell formulas (example)
- **E2 (latest date)**: `1`
- **E3 and below** (fill down): “previous (newer) `CumAdj`” × “previous (newer) `AdjFactor`”
- Formula in `E3`: `=E2*D2`
- Copy this down to the last row
In this example, `AdjFactor = 0.5` on the ex-date `2024-01-11` is reflected in `CumAdj` for the older date `2024-01-10`, resulting in `0.5`.
| Row | A:Date | B:C (unadjusted) | C:Vo (unadjusted) | D:AdjFactor | E:CumAdj (cumulative) | F:AdjC (calculated) | G:AdjVo (calculated) |
| --: | :--------- | ---------------: | ----------------: | ----------: | --------------------: | ------------------: | -------------------: |
| 2 | 2024-01-12 | 500 | 1,200,000 | 1.0 | 1.0 | | |
| 3 | 2024-01-11 | 480 | 2,400,000 | 0.5 | 1.0 | | |
| 4 | 2024-01-10 | 980 | 1,100,000 | 1.0 | 0.5 | | |
### 4) Calculate adjusted close (example: AdjC)
For prices (`O/H/L/C`), calculate **unadjusted price × CumAdj**.
- `F2` (fill down):
- `=B2*E2`
| Row | A:Date | B:C (unadjusted) | C:Vo (unadjusted) | D:AdjFactor | E:CumAdj (cumulative) | F:AdjC (calculated) | G:AdjVo (calculated) |
| --: | :--------- | ---------------: | ----------------: | ----------: | --------------------: | ------------------: | -------------------: |
| 2 | 2024-01-12 | 500 | 1,200,000 | 1.0 | 1.0 | 500.00 | |
| 3 | 2024-01-11 | 480 | 2,400,000 | 0.5 | 1.0 | 480.00 | |
| 4 | 2024-01-10 | 980 | 1,100,000 | 1.0 | 0.5 | 490.00 | |
### 5) Calculate adjusted volume (example: AdjVo) (optional)
Volume is the inverse of price. For example, to keep continuity under a 1:2 split (doubling pre-split volume), calculate **unadjusted volume ÷ CumAdj**.
- `G2` (fill down):
- `=C2/E2`
`CumAdj` is not normally zero, but for safety you can use something like `=IF(E2=0,"",C2/E2)` in Excel.
| Row | A:Date | B:C (unadjusted) | C:Vo (unadjusted) | D:AdjFactor | E:CumAdj (cumulative) | F:AdjC (calculated) | G:AdjVo (calculated) |
| --: | :--------- | ---------------: | ----------------: | ----------: | --------------------: | ------------------: | -------------------: |
| 2 | 2024-01-12 | 500 | 1,200,000 | 1.0 | 1.0 | 500.00 | 1,200,000 |
| 3 | 2024-01-11 | 480 | 2,400,000 | 0.5 | 1.0 | 480.00 | 2,400,000 |
| 4 | 2024-01-10 | 980 | 1,100,000 | 1.0 | 0.5 | 490.00 | 2,200,000 |
---
Source: https://jpx-jquants.com/en/spec/eq-bars-daily
# Stock Prices (OHLC) (/equities/bars/daily)
`GET` /v2/equities/bars/daily
## Overview
You can get information about stock price.\
Stock price consists before and after adjustment of stock splits, reverse stock splits, etc. (Rounded to first decimal places).
> **Warning**
>
> **Market capitalization (`MktCap`) is scheduled to be removed from this API.**\
> Please use `MktCap` in the [Valuation Indicators API](https://jpx-jquants.com/en/spec/eq-valuation) 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](https://jpx-jquants.com/en/spec/release) once it has been decided.
### Attention
> **Info**
>
> - Open, High, Low, Close, the volume of trade and the amount of purchase for the issue on the day when there is no trade volume (no sale) are recorded as Null.
> - Stocks that are not listed on the TSE (including issue listed only on the other exchanges) are not included in the data.
> - Delisted issues can also be retrieved by specifying a date or period within their listing period.
> - 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.
> - 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.
> - Stock price adjustments are supported for stock splits, reverse stock splits, and rights issues. Please note that some other corporate actions are not supported.
> - 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`).
## 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: – → All historical stock prices of a specific issue.
- code: ✓, date: ✓, from /to: – → Stock prices of a specific issue for the specific date
- code: ✓, date: –, from /to: ✓ → Stock prices of a specific issue for the specified period
- code: –, date: ✓, from /to: – → All listed issue prices for the specific date.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | 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. |
| date | string | Optional | Date of data when "from" and "to" are not specified (e.g. 20210907 or 2021-09-07) |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/equities/bars/daily
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/bars/daily \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/bars/daily', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/bars/daily",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Date | string | Required | Date (YYYY-MM-DD) |
| Code | string | Required | Issue code |
| O | number | Required | Open Price (before adjustment) |
| H | number | Required | High price (before adjustment) |
| L | number | Required | Low price (before adjustment) |
| C | number | Required | Close price (before adjustment) |
| UL | string | Required | Flag of hitting the upper price limit of the day (0: Other than hitting the upper price limit, 1: Hitting the upper price limit) |
| LL | string | Required | Flag of hitting the lower price limit of the day (0: Other than hitting the lower price limit, 1: Hitting the lower price limit) |
| Vo | number | Required | Trading volume (before adjustment) |
| Va | number | Required | Trading value |
| AdjFactor | number | Required | 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.) |
| AdjO | number | Required | Adjusted open price (\*1) |
| AdjH | number | Required | Adjusted high price (\*1) |
| AdjL | number | Required | Adjusted low price (\*1) |
| AdjC | number | Required | Adjusted close price (\*1) |
| AdjVo | number | Required | Adjusted volume (\*1) |
| MO | number | Required | Open price of the morning session (before adjustment) (\*2) |
| MH | number | Required | High price of the morning session (before adjustment) (\*2) |
| ML | number | Required | Low price of the morning session (before adjustment) (\*2) |
| MC | number | Required | Close price of the morning session (before adjustment) (\*2) |
| MUL | string | Required | 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) |
| MLL | string | Required | 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) |
| MVo | number | Required | Trading volume of the morning session (before adjustment) (\*2) |
| MVa | number | Required | Trading value of the morning session (\*2) |
| MAdjO | number | Required | Adjusted open price of the morning session (\*1, \*2) |
| MAdjH | number | Required | Adjusted high price of the morning session (\*1, \*2) |
| MAdjL | number | Required | Adjusted low price of the morning session (\*1, \*2) |
| MAdjC | number | Required | Adjusted close price of the morning session (\*1, \*2) |
| MAdjVo | number | Required | Adjusted trading volume of the morning session (\*1, \*2) |
| AO | number | Required | Open price of the afternoon session (before adjustment) (\*2) |
| AH | number | Required | High price of the afternoon session (before adjustment) (\*2) |
| AL | number | Required | Low price of the afternoon session (before adjustment) (\*2) |
| AC | number | Required | Close price of the afternoon session (before adjustment) (\*2) |
| AUL | string | Required | 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) |
| ALL | string | Required | 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) |
| AVo | number | Required | Trading volume of the afternoon session (before adjustment) (\*2) |
| AVa | number | Required | Trading value of the afternoon session (\*2) |
| AAdjO | number | Required | Adjusted open price of the afternoon session (\*1, \*2) |
| AAdjH | number | Required | Adjusted high price of the afternoon session (\*1, \*2) |
| AAdjL | number | Required | Adjusted low price of the afternoon session (\*1, \*2) |
| AAdjC | number | Required | Adjusted close price of the afternoon session (\*1, \*2) |
| AAdjVo | number | Required | Adjusted trading volume of the afternoon session (\*1, \*2) |
| MktCap | number | Required | Market capitalization (in millions of JPY) (\*3) |
| ExRT | string | Required | Ex-rights type (1: Stock split, 2: Reverse stock split, 3: Rights issue. Bonus share allotment is included in "1: Stock split".) (\*4) |
\*1 The item has been adjusted to take into account past divisions, etc.\
\*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
```bash {{ title: "200:OK" }}
{
"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."
}
```
---
Source: https://jpx-jquants.com/en/spec/eq-bars-minute
# 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
> **Info**
>
> - Stocks that are not listed on the TSE (including issue listed only on the other exchanges) are not included in the data.
> - Data is available for the past 2 years.
> - Data is not recorded for time periods with no trading activity.
## 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:
- code: ✓, date: –, from /to: – → Data for the specified issue for all periods
- code: ✓, date: ✓, from /to: – → Data for the specified issue on the specified date
- code: ✓, date: –, from /to: ✓ → Data for the specified issue during the specified period
- code: –, date: ✓, from /to: – → Data for all listed issues on the specified date
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | 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. |
| date | string | Optional | When from and to are not specified (e.g. 20210907 or 2021-09-07) |
| from | string | Optional | From date (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | To date (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/equities/bars/minute
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/bars/minute \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/bars/minute', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/bars/minute",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------------- |
| Date | string | Required | Date (YYYY-MM-DD) |
| Time | string | Required | Time (HH:mm) |
| Code | string | Required | Issue code |
| O | number | Required | Open price |
| H | number | Required | High price |
| L | number | Required | Low price |
| C | number | Required | Close price |
| Vo | number | Required | Trading volume |
| Va | number | Required | Trading value |
### Response Sample
```bash {{ title: "200:OK" }}
{
"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."
}
```
---
Source: https://jpx-jquants.com/en/spec/eq-earnings-cal
# Earnings Calendar (March/September fiscal year-end only) (/equities/earnings-calendar)
`GET` /v2/equities/earnings-calendar
## Overview
This API provides the announcement date of financial results. For now, companies with fiscal year ends in March or September can be obtained. (Companies with fiscal year ends in other month will be supported in the future.)
## Attention
> **Info**
>
> - It will be updated at around 19:00 (JST) only when there is an update for companies which end their fiscal year in March or September at the following site. If there are no updates for companies which end their fiscal year in March or September, the data as of the last update is provided by this API.\
> [https://www.jpx.co.jp/english/listing/event-schedules/financial-announcement/index.html](https://www.jpx.co.jp/english/listing/event-schedules/financial-announcement/index.html)
> - This API returns information about stocks whose financial results will be announced on the next business day.
> - If there is no record with the next business day in the data obtained from the API, it means that there are no companies scheduled to disclose on the next business day among the companies with fiscal year ends in March or September.
> - REIT data is not included.
> - If you need scheduled announcement dates and publication history for all listed issues (including REITs), please use the [Earnings Announcement Dates](https://jpx-jquants.com/en/spec/fin-earnings-date) API.
## Inquire the issue code, fiscal year, and quarter scheduled to be announced.
`GET` `https://api.jquants.com/v2/equities/earnings-calendar`
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| pagination\_key | string | Optional | 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
/v2/equities/earnings-calendar
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/earnings-calendar \
-H "x-api-key: {{apiKey}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/equities/earnings-calendar")
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/earnings-calendar",
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------- |
| Date | string | Required | Date (YYYY-MM-DD) If the earnings announcement date is undecided, the data will be an empty string (""). |
| Code | string | Required | Issue code |
| CoName | string | Required | Company name (Japanese) |
| FY | string | Required | End of Fiscal year (Japanese) |
| SectorNm | string | Required | Sector name (Japanese) |
| FQ | string | Required | Fiscal quarter (Japanese) |
| Section | string | Required | Market segment name (Japanese) |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2022-02-14",
"Code": "43760",
"CoName": "くふうカンパニー",
"FY": "9月30日",
"SectorNm": "情報・通信業",
"FQ": "第１四半期",
"Section": "マザーズ"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/eq-investor-types
# Trading by Type of Investors (/equities/investor-types)
`GET` /v2/equities/investor-types
## Overview
Trading by type of investors (stock trading value) can be obtained.\
This data is also available via the following site. The data is set in units of 1000 yen.\
[https://www.jpx.co.jp/english/markets/statistics-equities/investor-type/index.html](https://www.jpx.co.jp/english/markets/statistics-equities/investor-type/index.html)
### Attention
> **Info**
>
> - In accordance with the market classification review conducted on April 4, 2022, statistical data that are based on market classifications have been changed to the new market segments.
> - When the data of trading by type of investors is revised, that is, value of the past data is modified, the data is provided by this API as follows.
> - Revisions that are announced on or before April 3, 2023: only the data after revision is provided.
> - Revisions that are announced on or after April 3, 2023: both the data before revision and after revision are provided. When a revision occurs, a record is added with the same Section, StartDate and EndDate. In such a case, data with the newer PublishedDate represents the revised data while the data with the older PublishedDate can be identified as the pre-correction data.
> - When the data of trading by type of investors is revised, the updated data will be available on the next business day after the correction is announced.
## Get trading by type of investors
`GET` `https://api.jquants.com/v2/equities/investor-types`
In your request message, either "section" or "from/to" can be specified.
### Parameter and Response
In your request message, either "section" or "from/to" can be specified.\
Combination of parameter in the request and results are as below.
- section: ✓, from /to: ✓ → Trading data of a specific section for the specified period.
- section: ✓, from /to: – → All trading data of a specific section.
- section: –, from /to: ✓ → Trading data of all sections for the specified period.
- section: –, from /to: – → All trading data of all sections for all available period.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| section | string | Optional | Section name (e.g. TSEPrime) For a list of possible values, please see [here](https://jpx-jquants.com/en/spec/eq-investor-types/section). |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/equities/investor-types
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/investor-types \
-H "x-api-key: {{apiKey}}" \
-d section="{{section}}" \
-d from="{{from}}" \
-d to="{{to}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/investor-types', {
params: {
section: '{{section}}',
from: '{{from}}',
to: '{{to}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/investor-types",
params={"section": "{{section}}", "from": "{{from}}", "to": "{{to}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | --------------------------------------------------------------------- |
| PubDate | string | Required | Published Date (YYYY-MM-DD) |
| StDate | string | Required | Start Date (YYYY-MM-DD) |
| EnDate | string | Required | End Date (YYYY-MM-DD) |
| Section | string | Required | Section Name (See [Section name](https://jpx-jquants.com/en/spec/eq-investor-types/section)) |
| PropSell | number | Required | Proprietary Sales Value |
| PropBuy | number | Required | Proprietary Purchase Value |
| PropTot | number | Required | Proprietary Total Value |
| PropBal | number | Required | Proprietary Balance Value |
| BrkSell | number | Required | Brokerage Sales Value |
| BrkBuy | number | Required | Brokerage Purchase Value |
| BrkTot | number | Required | Brokerage Total Value |
| BrkBal | number | Required | Brokerage Balance Value |
| TotSell | number | Required | Total Sales Value |
| TotBuy | number | Required | Total Purchase Value |
| TotTot | number | Required | Total Value |
| TotBal | number | Required | Total Balance Value |
| IndSell | number | Required | Individuals Sales Value |
| IndBuy | number | Required | Individuals Purchase Value |
| IndTot | number | Required | Individuals Total Value |
| IndBal | number | Required | Individuals Balance Value |
| FrgnSell | number | Required | Foreigners Sales Value |
| FrgnBuy | number | Required | Foreigners Purchase Value |
| FrgnTot | number | Required | Foreigners Total Value |
| FrgnBal | number | Required | Foreigners Balance Value |
| SecCoSell | number | Required | Securities Companies Sales Value |
| SecCoBuy | number | Required | Securities Companies Purchase Value |
| SecCoTot | number | Required | Securities Companies Total Value |
| SecCoBal | number | Required | Securities Companies Balance Value |
| InvTrSell | number | Required | Investment Trusts Sales Value |
| InvTrBuy | number | Required | Investment Trusts Purchase Value |
| InvTrTot | number | Required | Investment Trusts Total Value |
| InvTrBal | number | Required | Investment Trusts Balance Value |
| BusCoSell | number | Required | Business Companies Sales Value |
| BusCoBuy | number | Required | Business Companies Purchase Value |
| BusCoTot | number | Required | Business Companies Total Value |
| BusCoBal | number | Required | Business Companies Balance Value |
| OthCoSell | number | Required | Other Companies Sales Value |
| OthCoBuy | number | Required | Other Companies Purchase Value |
| OthCoTot | number | Required | Other Companies Total Value |
| OthCoBal | number | Required | Other Companies Balance Value |
| InsCoSell | number | Required | Insurance Companies Sales Value |
| InsCoBuy | number | Required | Insurance Companies Purchase Value |
| InsCoTot | number | Required | Insurance Companies Total Value |
| InsCoBal | number | Required | Insurance Companies Balance Value |
| BankSell | number | Required | City Banks Regional Banks Etc Sales Value |
| BankBuy | number | Required | City Banks Regional Banks Etc Purchase Value |
| BankTot | number | Required | City Banks Regional Banks Etc Total Value |
| BankBal | number | Required | City Banks Regional Banks Etc Balance Value |
| TrstBnkSell | number | Required | Trust Banks Sales Value |
| TrstBnkBuy | number | Required | Trust Banks Purchase Value |
| TrstBnkTot | number | Required | Trust Banks Total Value |
| TrstBnkBal | number | Required | Trust Banks Balance Value |
| OthFinSell | number | Required | Other Financial Institutions Sales Value |
| OthFinBuy | number | Required | Other Financial Institutions Purchase Value |
| OthFinTot | number | Required | Other Financial Institutions Total Value |
| OthFinBal | number | Required | Other Financial Institutions Balance Value |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2017-01-13",
"StDate": "2017-01-04",
"EnDate": "2017-01-06",
"Section": "TSE1st",
"PropSell": 1311271004,
"PropBuy": 1453326508,
"PropTot": 2764597512,
"PropBal": 142055504,
"BrkSell": 7165529005,
"BrkBuy": 7030019854,
"BrkTot": 14195548859,
"BrkBal": -135509151,
"TotSell": 8476800009,
"TotBuy": 8483346362,
"TotTot": 16960146371,
"TotBal": 6546353,
"IndSell": 1401711615,
"IndBuy": 1161801155,
"IndTot": 2563512770,
"IndBal": -239910460,
"FrgnSell": 5094891735,
"FrgnBuy": 5317151774,
"FrgnTot": 10412043509,
"FrgnBal": 222260039,
"SecCoSell": 76381455,
"SecCoBuy": 61700100,
"SecCoTot": 138081555,
"SecCoBal": -14681355,
"InvTrSell": 168705109,
"InvTrBuy": 124389642,
"InvTrTot": 293094751,
"InvTrBal": -44315467,
"BusCoSell": 71217959,
"BusCoBuy": 63526641,
"BusCoTot": 134744600,
"BusCoBal": -7691318,
"OthCoSell": 10745152,
"OthCoBuy": 15687836,
"OthCoTot": 26432988,
"OthCoBal": 4942684,
"InsCoSell": 15926202,
"InsCoBuy": 9831555,
"InsCoTot": 25757757,
"InsCoBal": -6094647,
"BankSell": 10606789,
"BankBuy": 8843871,
"BankTot": 19450660,
"BankBal": -1762918,
"TrstBnkSell": 292932297,
"TrstBnkBuy": 245322795,
"TrstBnkTot": 538255092,
"TrstBnkBal": -47609502,
"OthFinSell": 22410692,
"OthFinBuy": 21764485,
"OthFinTot": 44175177,
"OthFinBal": -646207
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/eq-investor-types/section
# Section name
| Section | Value |
| ----------------------------- | ----------- |
| 1st Section | TSE1st |
| 2nd Section | TSE2nd |
| Mothers | TSEMothers |
| JASDAQ | TSEJASDAQ |
| Prime | TSEPrime |
| Standard | TSEStandard |
| Growth | TSEGrowth |
| Tokyo & Nagoya Stock Exchange | TokyoNagoya |
---
Source: https://jpx-jquants.com/en/spec/eq-master/marketcode
# Market segment code and name
| Code | Name |
| ---- | ---------------- |
| 0101 | 1st Section |
| 0102 | 2nd Section |
| 0104 | Mothers |
| 0105 | TOKYO PRO MARKET |
| 0106 | JASDAQ Standard |
| 0107 | JASDAQ Growth |
| 0109 | Others |
| 0111 | Prime |
| 0112 | Standard |
| 0113 | Growth |
---
Source: https://jpx-jquants.com/en/spec/eq-master
# Listed Issue Master (/equities/master)
`GET` /v2/equities/master
## Overview
Listed issue information as of the past, the current day, and the next business day can be retrieved.\
Please note that listed issue information as of the next business day can be obtained after 17:30.
### Attention
> **Info**
>
> - For the specification of past dates, even if you are subscribing Premium plan and specify a date earlier than the start date of data provision (May 7, 2008), the issue information as of May 7, 2008 will be returned.
> - If specified "Date" is non-business day, the issue information as of next business day of specified date will be returned.
> **Note**
>
> In accordance with the TSE market restructuring in April 2022, the Bank of Japan (code: 83010) and Shinkin Central Bank (code: 84210) no longer belong to any market divisions under the system, but J-Quants handles them as "Standard".
### Handling of delisted issues
> **Info**
>
> - If you specify a past date in `date`, the issues listed as of that date will be returned. Issues that have since been delisted can also be retrieved by specifying a date on which they were still listed.
> - If you specify a `code` directly with a date after the issue's delisting, the response will be empty.
> - Listing dates and delisting dates are not provided.
> - A list of delisted issues is not provided.
### History of issue code, company name, and market segment changes
> **Note**
>
> Change histories and old/new correspondence tables for issue codes, company names, and market segments are not provided. Please identify such changes by comparing the daily snapshots retrieved by specifying dates.
## Obtain daily listed issue information
`GET` `https://api.jquants.com/v2/equities/master`
When acquiring data, issue code (code) or date (date) can be specified.\
The combination of each parameter and the results of the response are as below.
- code: –, date: – → All listed issues as of the day when API is executed. (\*1)
- code: ✓, date: – → Specified listed issues as of the day when API is executed. (\*1)
- code: –, date: ✓ → All listed issues as of the specified day. (\*2)
- code: ✓, date: ✓ → Specified listed issues as of the specified day. (\*2)
\*1 If "Date" is not specified on non-business day, the issue information as of next business day will be returned.\
\*2 If you are subscribing a plan other than free plan, data as of the next business day can be obtained. Even if you specify a future date that is earlier than the next business day, the issue information as of the next business day will be returned.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | Issue code (e.g. 27890 or 2789) 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. |
| date | string | Optional | Date of application of information (e.g. 20210907 or 2021-09-07) |
### Sample Code
/v2/equities/master
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/master \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/master', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/master",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------ |
| Date | string | Required | Date of application of information (YYYY-MM-DD) |
| Code | string | Required | Issue code |
| CoName | string | Required | Company Name (Japanese) |
| CoNameEn | string | Required | Company Name (English) |
| S17 | string | Required | 17-Sector code (See [17-sector code and name](https://jpx-jquants.com/en/spec/eq-master/sector17code)) |
| S17Nm | string | Required | 17-Sector code name (Japanese) (See [17-sector code and name](https://jpx-jquants.com/en/spec/eq-master/sector17code)) |
| S33 | string | Required | 33-Sector code (See [33-sector code and name](https://jpx-jquants.com/en/spec/eq-master/sector33code)) |
| S33Nm | string | Required | 33-Sector code name (Japanese) (See [33-sector code and name](https://jpx-jquants.com/en/spec/eq-master/sector33code)) |
| ScaleCat | string | Required | TOPIX Scale category |
| Mkt | string | Required | Market segment code (See [Market segment code and name](https://jpx-jquants.com/en/spec/eq-master/marketcode)) |
| MktNm | string | Required | Market segment code name (Japanese) (See [Market segment code and name](https://jpx-jquants.com/en/spec/eq-master/marketcode)) |
| Mrgn | string | Required | Flags of margin and loan issues (1: Margin issues / 2: Loan issues / 3: Other issues (non-loan, non-margin)) |
| MrgnNm | string | Required | Name of flags of margin and loan issues |
| ProdCat | string | Required | Product category code (See [Product category codes and names](https://jpx-jquants.com/en/spec/eq-master/product-category)) |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2022-11-11",
"Code": "86970",
"CoName": "日本取引所グループ",
"CoNameEn": "Japan Exchange Group,Inc.",
"S17": "16",
"S17Nm": "金融（除く銀行）",
"S33": "7200",
"S33Nm": "その他金融業",
"ScaleCat": "TOPIX Large70",
"Mkt": "0111",
"MktNm": "プライム",
"Mrgn": "1",
"MrgnNm": "信用",
"ProdCat": "011"
}
]
}
```
---
Source: https://jpx-jquants.com/en/spec/eq-master/product-category
# Product category codes and names
| Code | Name |
| ---- | ---------------------------------------- |
| 011 | Domestic Stocks |
| 012 | Preferred Equity Investment Certificates |
| 013 | REITs |
| 014 | ETFs |
| 021 | Foreign Stocks |
| 022 | Foreign REITs |
| 023 | Foreign ETFs |
| 024 | Foreign Stock Depositary Receipts |
---
Source: https://jpx-jquants.com/en/spec/eq-master/sector17code
# 17-sector code and name
| Code | Name |
| ---- | ---------------------------------------------- |
| 1 | Food |
| 2 | Energy Resources |
| 3 | Construction & Materials |
| 4 | Materials & Chemicals |
| 5 | Pharmaceuticals |
| 6 | Automobiles & Transportation Equipment |
| 7 | Steel & Non-ferrous Metals |
| 8 | Machinery |
| 9 | Electric Equipment & Precision Instruments |
| 10 | Information & Communication, Services & Others |
| 11 | Electric Power & Gas |
| 12 | Transportation & Logistics |
| 13 | Trading Companies & Wholesale |
| 14 | Retail |
| 15 | Banks |
| 16 | Finance (Excluding Banks) |
| 17 | Real Estate |
| 99 | Others |
---
Source: https://jpx-jquants.com/en/spec/eq-master/sector33code
# 33-sector code and name
| Code | Name |
| ---- | -------------------------------------------- |
| 0050 | Fishery, Agriculture & Forestry |
| 1050 | Mining |
| 2050 | Construction |
| 3050 | Foods |
| 3100 | Textiles & Apparels |
| 3150 | Pulp & Paper |
| 3200 | Chemicals |
| 3250 | Pharmaceutical |
| 3300 | Oil & Coal Products |
| 3350 | Rubber Products |
| 3400 | Glass & Ceramics Products |
| 3450 | Iron & Steel |
| 3500 | Nonferrous Metals |
| 3550 | Metal Products |
| 3600 | Machinery |
| 3650 | Electric Appliances |
| 3700 | Transportation Equipment |
| 3750 | Precision Instruments |
| 3800 | Other Products |
| 4050 | Electric Power & Gas |
| 5050 | Land Transportation |
| 5100 | Marine Transportation |
| 5150 | Air Transportation |
| 5200 | Warehousing & Harbor Transportation Services |
| 5250 | Information & Communication |
| 6050 | Wholesale Trade |
| 6100 | Retail Trade |
| 7050 | Banks |
| 7100 | Securities & Commodity Futures |
| 7150 | Insurance |
| 7200 | Other Financing Business |
| 8050 | Real Estate |
| 9050 | Services |
| 9999 | Other |
---
Source: https://jpx-jquants.com/en/spec/eq-trades
# Stock Prices (Tick) (/equities/trades)
## Overview
Tick-by-tick transaction data is provided in CSV format.\
You can obtain detailed data such as price, volume, and timestamp for individual trades (executions).
> **Note**
>
> This data is only available in CSV format and cannot be accessed via API.\
> To download CSV files, please use the [List of Downloadable Files API](https://jpx-jquants.com/en/spec/bulk-list) and [Get File Download URL API](https://jpx-jquants.com/en/spec/bulk-get). You can also download from the [Download page](https://jpx-jquants.com/dashboard/downloads/price-data/stocks?filter=equities/trades) after signing in.
### Attention
> **Info**
>
> - Issues that are not listed on the Tokyo Stock Exchange (issues listed only on regional exchanges) are not included in the data.
> - The data retention period is 2 years.
## Data Item
| Parameter | Type | Required | Description |
| ------------------ | ------ | -------- | ------------------------------------------------------------ |
| Date | string | Required | Date (YYYY-MM-DD) |
| Code | string | Required | Issue code |
| Time | string | Required | Execution time (HH:MM:SS.ffffff) |
| SessionDistinction | string | Required | Trading session (01: Morning session, 02: Afternoon session) |
| Price | number | Required | Execution price (JPY) |
| TradingVolume | number | Required | Execution volume (shares) |
| TransactionId | string | Required | Transaction ID (Unique ID for each execution) |
## Data Sample
```csv
Date,Code,Time,SessionDistinction,Price,TradingVolume,TransactionId
2025-12-01,13010,09:00:00.067558,01,4810,2200,000000000021
2025-12-01,13010,09:00:01.039337,01,4810,100,000000000036
2025-12-01,13010,09:00:01.049791,01,4810,4500,000000000038
```
---
Source: https://jpx-jquants.com/en/spec/eq-valuation/calc
# How Indicators Are Calculated
This page explains the definitions of, and calculation principles for, the indicators provided by the [Valuation Indicators API](https://jpx-jquants.com/en/spec/eq-valuation).\
J-Quants calculates each indicator using information disclosed in financial statements and other materials, together with share-price data.
> **Info**
>
> - This page describes the basic **principles** underlying the indicators. Detailed calculation specifications, including the treatment of the number of shares and adjustments for changes in fiscal year-end, are not disclosed.
> - The indicators are provided for reference when making investment decisions and do not constitute a recommendation to buy or sell any particular security.
## Basis of Calculation
### TTM Net Income (Earnings Used to Calculate Actual Values)
Actual EPS, ROE, and PER are calculated using net income for the trailing twelve months (TTM).\
On this page, the total net income over these twelve months is referred to as **TTM net income**.\
Compared with using full-year results alone, this approach incorporates quarterly disclosures and therefore better reflects recent performance.
### Company-Forecast Net Income (Earnings Used to Calculate Forward Values)
Indicators with `Fwd` in their names (FwdEPS, FwdROE, and FwdPER) are calculated using the company's forecast net income for the current fiscal year.
### Share Price (Closing Price for the Day)
PER, FwdPER, PBR, and market capitalization are calculated using the closing price for the day.\
If no trade is executed on a given day, the base price applicable to that day is used instead.
## Indicator Definitions
### EPS — Earnings per Share (Actual)
If the company reports a net loss, EPS is recorded as a negative value, representing loss per share.
```
EPS = TTM net income / Number of shares
```
### FwdEPS — Forward Earnings per Share
The value is Null if the company has not published a forecast or has withdrawn its forecast.\
If the company forecasts a net loss, FwdEPS is recorded as a negative value, representing forecast loss per share.
```
FwdEPS = (Company-forecast net income) / Number of shares
```
### BPS — Book Value per Share
If shareholders' equity is negative, BPS is recorded as a negative per-share value.
```
BPS = Shareholders' equity at the end of the most recent quarter / Number of shares
```
### ROE — Return on Equity (Actual)
The value is Null if the average shareholders' equity at the beginning and end of the TTM period, which is used as the denominator, is zero or negative.\
If the numerator is negative because the company reports a net loss, ROE is recorded as a negative value.
```
ROE = TTM net income / Average shareholders' equity at the beginning and end of the TTM period
```
### FwdROE — Forward Return on Equity
The value is Null if the company has not published a forecast or has withdrawn its forecast.\
The value is also Null if the shareholders' equity used as the denominator is zero or negative.
```
FwdROE = (Company-forecast net income) / Shareholders' equity at the end of the most recent quarter
```
### PER — Price-to-Earnings Ratio (Actual)
The value is Null if EPS is zero or negative.
```
PER = Share price / EPS
```
### FwdPER — Forward Price-to-Earnings Ratio
The value is Null if the company has not published a forecast or has withdrawn its forecast.\
The value is also Null if FwdEPS is zero or negative.
```
FwdPER = Share price / FwdEPS
```
### PBR — Price-to-Book Ratio
The value is Null if BPS is zero or negative.
```
PBR = Share price / BPS
```
### Market Capitalization (MktCap)
Market capitalization is calculated using the number of shares excluding treasury shares. Its definition therefore differs from market capitalization calculated using total shares issued or free-float shares.
```
Market capitalization (JPY millions) = (Share price × Number of shares) / 1,000,000
```
## When Values Are Null
The applicable field is recorded as Null in any of the following cases:
- The data required for calculation is unavailable, such as during the initial data-coverage period, shortly after a security is listed, or during a transition following a change in fiscal year-end.
- The company has not published a forecast or has withdrawn its forecast. This applies only to indicators with `Fwd` in their names.
- The security is outside the scope of indicator calculation, such as an ETF, ETN, or preferred stock. A data row is still returned, but all indicators are Null.
Market capitalization is not subject to the determination of whether a security is within the scope of indicator calculation. A market-capitalization value may therefore be recorded for a security whose other indicators are Null, such as a preferred stock or REIT. However, because the number of shares is calculated using information disclosed in financial statements, market capitalization is Null for ETFs, ETNs, and similar securities, as well as for newly listed securities before their first financial results are disclosed.
For the initial data-coverage period, approximately 2008 to 2010, the share-count and financial information required for calculation may be incomplete. Consequently, more securities and fields are recorded as Null during this period.
In addition to the cases above, a value is Null if the resulting ratio would not be meaningful, such as when the company reports a net loss or shareholders' equity is zero or negative, even if all data required for calculation is available. See [Indicator Definitions](#Indicator-Definitions) for the conditions applicable to each indicator.
## Differences from Values Provided by Other Services
Even when indicators have the same name, values may differ from those provided by other sources or services because of differences in the definition of the number of shares, the scope of disclosures used, rounding methods, and other calculation details.\
J-Quants calculates the values provided by this API in accordance with the principles described above. Please review these calculation principles when using the API values.
---
Source: https://jpx-jquants.com/en/spec/eq-valuation
# Valuation Indicators (/equities/valuation)
`GET` /v2/equities/valuation
## API Overview
This API provides daily valuation indicators and market capitalization calculated from financial statement disclosures and share prices.\
Actual values are calculated using net income for the trailing twelve months (TTM), while forward values are calculated using the company's forecast net income for the current fiscal year.
### Notes on This API
> **Info**
>
> - In principle, information disclosed in financial results is reflected in the data from the following business day, regardless of the time of disclosure. For daily update times, see [Data Update Timing](https://jpx-jquants.com/en/spec/data-update).
> - The closing price for the day is used as the share price. If no trade is executed on a given day, the base price applicable to that day is used instead.
> - ROE and FwdROE are recorded as decimals (e.g., `0.2310` represents 23.1%).
> - If the data required for calculation is unavailable, the applicable field is recorded as Null, such as for a recently listed security or during a transition following a change in fiscal year-end. For the initial data-coverage period, approximately 2008 to 2010, the share-count and financial information required for calculation may be incomplete. Consequently, more securities and fields are recorded as Null during this period.
> - Data rows are returned for securities outside the scope of indicator calculation, such as ETFs, ETNs, and preferred stocks, but all indicators are Null. Market capitalization may be calculated for securities that are outside the scope of the other indicators. A market-capitalization value may therefore be recorded for a preferred stock, REIT, or similar security even if all other indicators are Null. Market capitalization is also Null for ETFs, ETNs, and similar securities because they have no financial statement disclosures from which the number of shares can be calculated.
> - Support for REITs and similar issues is planned for a future release as far as the indicators are concerned (market capitalization is already recorded for them).
> - For indicator definitions, the distinction between actual and forward values, and the conditions under which values are Null, see [How Indicators Are Calculated](https://jpx-jquants.com/en/spec/eq-valuation/calc).
## Retrieve Daily Valuation Indicator Data
`GET` `https://api.jquants.com/v2/equities/valuation`
Either an issue code (`code`) or a date (`date`) must be specified.\
The permitted parameter combinations and corresponding responses are shown below.
- code: ✓, date: –, from /to: – → All available data for the specified issue
- code: ✓, date: ✓, from /to: – → Data for the specified issue on the specified date
- code: ✓, date: –, from /to: ✓ → Data for the specified issue over the specified period
- code: –, date: ✓, from /to: – → Data for all listed issues on the specified date
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | Issue code (e.g., `27800` or `2780`) If a four-digit issue code is specified for an issue with both common and preferred stock listed, only data for the common stock is returned. |
| date | string | Optional | Date, when `from` and `to` are not specified (e.g., `20260826` or `2026-08-26`) |
| from | string | Optional | Start of the period (e.g., `20260801` or `2026-08-01`) |
| to | string | Optional | End of the period (e.g., `20260826` or `2026-08-26`) |
| pagination\_key | string | Optional | String that specifies the start of the search Set the pagination\_key returned by a previous search |
### Sample API Call
/v2/equities/valuation
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/valuation \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/valuation', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/valuation",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Items
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------------------------------------------------- |
| Date | string | Required | Date (YYYY-MM-DD) |
| Code | string | Required | Issue code (5 digits) |
| EPS | number | Required | Earnings per share (actual, JPY) (\*1, \*4) |
| FwdEPS | number | Required | Forward earnings per share (JPY) (\*2, \*4) |
| BPS | number | Required | Book value per share (JPY) (\*4, \*6) |
| ROE | number | Required | Return on equity (actual, decimal) (\*1, \*5) |
| FwdROE | number | Required | Forward return on equity (decimal) (\*2, \*5) |
| PER | number | Required | Price-to-earnings ratio (actual, multiple) (\*3, \*4) |
| FwdPER | number | Required | Forward price-to-earnings ratio (multiple) (\*3, \*4) |
| PBR | number | Required | Price-to-book ratio (multiple) (\*3, \*4) |
| MktCap | number | Required | Market capitalization (JPY millions) (\*3, \*7) |
\*1 Actual values calculated using net income for the trailing twelve months (TTM). The denominator of ROE is the average shareholders' equity at the beginning and end of the TTM period.\
\*2 Forward values calculated using the company's forecast net income for the current fiscal year. The denominator of FwdROE is the most recently disclosed period-end shareholders' equity.\
\*3 The closing price for the day is used as the share price. If no trade is executed on a given day, the base price applicable to that day is used instead.\
\*4 Values are rounded to two decimal places. Because values are returned as JSON numbers, trailing zeros may be omitted.\
\*5 Values are rounded to four decimal places. Note that they are expressed as decimals, not percentages (e.g., `0.2310` represents 23.1%). Because values are returned as JSON numbers, trailing zeros may be omitted.\
\*6 Calculated using the most recently disclosed period-end shareholders' equity.\
\*7 Calculated as share price (\*3) multiplied by the number of shares and recorded in millions of JPY, rounded to the nearest million. The calculation also reflects corporate actions such as stock splits and reverse stock splits.\
・The number of shares excludes treasury shares. This definition differs from market capitalization calculated using total shares issued or free-float shares.\
・Market capitalization in the Daily Stock Prices (OHLC) API is calculated using the closing price and a number of shares that includes treasury shares. Because the definition of the number of shares differs from that used for this field, the resulting values may not match. For an issue that holds treasury shares, the value in this field will generally be lower by the amount attributable to those treasury shares. Market capitalization in the Daily Stock Prices (OHLC) API is scheduled to be removed; use this field going forward.\
・Because the number of shares is calculated using financial statement disclosures, this field is Null for ETFs, ETNs, and similar issues, as well as for newly listed issues until their first financial results are disclosed.
### Sample Response
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-03-24",
"Code": "86970",
"EPS": 89.4,
"FwdEPS": 87.9,
"BPS": 590.65,
"ROE": 0.1534,
"FwdROE": 0.1488,
"PER": 22.88,
"FwdPER": 23.26,
"PBR": 3.46,
"MktCap": 1077137.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/fin-details
# Financial Statement Data (BS/PL/CF) (/fins/details)
`GET` /v2/fins/details
## Overview
You can obtain the entries in the balance sheet, income statement, and cash flow statement of a listed companies in their quarterly financial information.
## Attention
> **Info**
>
> - **About FinancialStatement (Various items in the financial statements)**
> - Contents of this API is created from the EDINET XBRL taxonomy body (label information).
> - For verbose labels (English) included in the item "FinancialStatement", see the following website.\
> [https://disclosure2dl.edinet-fsa.go.jp/guide/static/disclosure/WEEK0060.html](https://disclosure2dl.edinet-fsa.go.jp/guide/static/disclosure/WEEK0060.html) \
> The "Account Title List" (Accounting Standards: Japanese GAAP) and the "Taxonomy Element List for Designated International Accounting Standards" (Accounting Standards: IFRS) are available on the EDINET Taxonomy page published by fiscal year. The following data is provided for each accounting standard.
> - If the accounting standard is Japanese GAAP, the data is provided as a set with the value of "Verbose Labels (English)" in column E of each sheet of the "Account Title List" as the key.
> - If the accounting standard is IFRS, the data is provided as a set with the value of "Verbose Labels (English)" in column D of each sheet of the "Taxonomy Element List for Designated International Accounting Standards" as the key.
> - **About Taxonomy Extension**
> - Company-specific items defined in the taxonomy by submitter that do not exist in the EDINET taxonomy are not covered by this API.
> **Note**
>
> - MODEC, Inc. (stock code 62690) presents its consolidated financial statements and notes to consolidated financial statements in U.S. dollars in its financial statements for February 2022 and thereafter. Therefore, the financial statement information for the subject issue in this service is also provided in U.S. dollars.
> **Info**
>
> This API has its own [individual rate limit](https://jpx-jquants.com/en/spec/rate-limits#rate-limits-by-endpoint). For best practices on efficient data retrieval, including bulk retrieval of historical data, see [Rate Limits](https://jpx-jquants.com/en/spec/rate-limits#best-practices).
## Get quarterly financial statement information
`GET` `https://api.jquants.com/v2/fins/details`
Either "code" or "date" must be specified.
### Parameter and Response
Either a "code" or "date" must be specified.\
Parameter in the request and results are as below:
- code: ✓, date: –, cursor: – → All financial statement data for a specific issue.
- code: ✓, date: ✓, cursor: – → Financial statement data for a specific issue on the specific date.
- code: –, date: ✓, cursor: – → Financial statement data for all listed issues on the specific date.
- code: –, date: ✓, cursor: ✓ → Financial statement data since the previous request.
### Retrieving financial statement data using cursor
For the cursor-based differential retrieval specification, see [Retrieving Differential Data Using Cursor](https://jpx-jquants.com/en/spec/cursor).
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | Issue code (e.g. 86970 or 8697) 4 or 5 character issue code |
| date | string | Optional | Disclosure date (e.g. 2022-01-05 or 20220105) |
| cursor | string | Optional | Cursor for differential retrieval Use the value returned as cursor in the previous response. Cannot be specified together with pagination\_key. For details, see [Retrieving Differential Data Using Cursor](https://jpx-jquants.com/en/spec/cursor). |
| pagination\_key | string | Optional | 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
/v2/fins/details
**cURL**
```bash
curl -G https://api.jquants.com/v2/fins/details \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/fins/details', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/fins/details",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| DiscDate | string | Required | Disclosed Date |
| DiscTime | string | Required | Disclosed Time |
| Code | string | Required | Issue Code (5 digits) |
| DiscNo | string | Required | Disclosure Number The json output from the API is sorted in ascending order by disclosure number. |
| DocType | string | Required | Type of Document [Type of Document List](https://jpx-jquants.com/en/spec/fin-summary/typeofdocument) |
| FS | object | Required | Various items in financial statements Data stored with verbose label (English) as key and its value (financial statement value) as value. Redundant labels (English) associated with XBRL tags and their values are recorded. |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"DiscDate": "2020-04-30",
"DiscTime": "12:00:00",
"Code": "86970",
"DiscNo": "20200429402226",
"DocType": "FYFinancialStatements_Consolidated_IFRS",
"FS": {
"EDINET code, DEI": "E03814",
"Security code, DEI": "86970",
"Filer name in Japanese, DEI": "株式会社日本取引所グループ",
"Filer name in English, DEI": "Japan Exchange Group, Inc.",
"Document type, DEI": "通期第３号参考様式 [IFRS]（連結）",
"Accounting standards, DEI": "IFRS",
"Whether consolidated financial statements are prepared, DEI": "true",
"Industry code when consolidated financial statements are prepared in accordance with industry specific regulations, DEI": "CTE",
"Industry code when financial statements are prepared in accordance with industry specific regulations, DEI": "CTE",
"Current fiscal year start date, DEI": "2019-04-01",
"Current period end date, DEI": "2020-03-31",
"Type of current period, DEI": "FY",
"Current fiscal year end date, DEI": "2020-03-31",
"Previous fiscal year start date, DEI": "2018-04-01",
"Comparative period end date, DEI": "2019-03-31",
"Previous fiscal year end date, DEI": "2019-03-31",
"Amendment flag, DEI": "false",
"Report amendment flag, DEI": "false",
"XBRL amendment flag, DEI": "false",
"Cash and cash equivalents (IFRS)": "71883000000",
"Trade and other receivables - CA (IFRS)": "16686000000",
"Income taxes receivable - CA (IFRS)": "5922000000",
"Other financial assets - CA (IFRS)": "117400000000",
"Other current assets - CA (IFRS)": "1837000000",
"Current assets (IFRS)": "67093263000000",
"Property, plant and equipment (IFRS)": "14798000000",
"Goodwill (IFRS)": "67374000000",
"Intangible assets (IFRS)": "35045000000",
"Retirement benefit asset - NCA (IFRS)": "5642000000",
"Investments accounted for using equity method (IFRS)": "14703000000",
"Other financial assets - NCA (IFRS)": "18156000000",
"Other non-current assets - NCA (IFRS)": "6049000000",
"Deferred tax assets (IFRS)": "3321000000",
"Non-current assets (IFRS)": "193039000000",
"Assets (IFRS)": "67286302000000",
"Trade and other payables - CL (IFRS)": "6643000000",
"Bonds and borrowings - CL (IFRS)": "32500000000",
"Income taxes payable - CL (IFRS)": "10289000000",
"Other current liabilities - CL (IFRS)": "10062000000",
"Current liabilities (IFRS)": "66947278000000",
"Bonds and borrowings - NCL (IFRS)": "19953000000",
"Retirement benefit liability - NCL (IFRS)": "8866000000",
"Other non-current liabilities - NCL (IFRS)": "2162000000",
"Deferred tax liabilities (IFRS)": "2665000000",
"Non-current liabilities (IFRS)": "33648000000",
"Liabilities (IFRS)": "66980926000000",
"Share capital (IFRS)": "11500000000",
"Capital surplus (IFRS)": "39716000000",
"Treasury shares (IFRS)": "-1548000000",
"Other components of equity (IFRS)": "5602000000",
"Retained earnings (IFRS)": "242958000000",
"Equity attributable to owners of parent (IFRS)": "298228000000",
"Non-controlling interests (IFRS)": "7146000000",
"Equity (IFRS)": "305375000000",
"Liabilities and equity (IFRS)": "67286302000000",
"Number of submission, DEI": "1",
"Profit (loss) before tax from continuing operations (IFRS)": "69095000000.0",
"Depreciation and amortization - OpeCF (IFRS)": "16499000000",
"Finance income - OpeCF (IFRS)": "-665000000",
"Finance costs - OpeCF (IFRS)": "96000000",
"Share of loss (profit) of investments accounted for using equity method - OpeCF (IFRS)": "-2457000000",
"Decrease (increase) in trade and other receivables - OpeCF (IFRS)": "-5246000000",
"Increase (decrease) in trade and other payables - OpeCF (IFRS)": "420000000",
"Decrease (increase) in retirement benefit asset - OpeCF (IFRS)": "230000000",
"Increase (decrease) in retirement benefit liability - OpeCF (IFRS)": "12000000",
"Other, Changes in working capital - OpeCF (IFRS)": "-424000000",
"Subtotal - OpeCF (IFRS)": "77560000000",
"Interest and dividends received - OpeCF (IFRS)": "899000000",
"Interest paid - OpeCF (IFRS)": "-96000000",
"Income taxes refund (paid) - OpeCF (IFRS)": "-21482000000",
"Net cash provided by (used in) operating activities (IFRS)": "56881000000",
"Payments into time deposits - InvCF (IFRS)": "-117400000000",
"Proceeds from withdrawal of time deposits - InvCF (IFRS)": "113100000000",
"Purchase of property, plant and equipment - InvCF (IFRS)": "-1199000000",
"Purchase of intangible assets - InvCF (IFRS)": "-12379000000",
"Proceeds from sale of investment securities - InvCF (IFRS)": "11585000000",
"Payments for acquisition of subsidiaries - InvCF (IFRS)": "-3165000000",
"Other - InvCF (IFRS)": "23000000",
"Net cash provided by (used in) investing activities (IFRS)": "-9434000000",
"Repayments of lease liabilities - FinCF (IFRS)": "-3125000000",
"Dividends paid - FinCF (IFRS)": "-35935000000",
"Purchase of treasury shares - FinCF (IFRS)": "-350000000",
"Net cash provided by (used in) financing activities (IFRS)": "-39411000000",
"Net increase (decrease) in cash and cash equivalents before effect of exchange rate changes (IFRS)": "8035000000",
"Effect of exchange rate changes on cash and cash equivalents (IFRS)": "-43000000",
"Other income (IFRS)": "975000000.0",
"Revenue - 2 (IFRS)": "124663000000.0",
"Operating expenses (IFRS)": "58532000000.0",
"Other expenses (IFRS)": "54000000.0",
"Share of profit (loss) of investments accounted for using equity method (IFRS)": "2457000000.0",
"Operating profit (loss) (IFRS)": "68533000000.0",
"Finance income (IFRS)": "665000000.0",
"Finance costs (IFRS)": "103000000.0",
"Income tax expense (IFRS)": "20781000000.0",
"Profit (loss) (IFRS)": "48314000000.0",
"Profit (loss) attributable to owners of parent (IFRS)": "47609000000.0",
"Profit (loss) attributable to non-controlling interests (IFRS)": "705000000.0",
"Basic earnings (loss) per share (IFRS)": "88.91"
}
}
],
"cursor": "eyJkIjoiMjAyNS0wNC0wMSIsInQiOiIyMDI1LTA0LTAxVDA4OjAwOjAwWiMyMDI1MDQwMTEzMDEwMCJ9"
}
```
---
Source: https://jpx-jquants.com/en/spec/fin-dividend
# Cash Dividend Data (/fins/dividend)
`GET` /v2/fins/dividend
## Overview
Provides information on dividends (determined and forecast) per share of listed companies, record date, ex-rights date, and payable date.
## Attention
> **Info**
>
> - Stocks that are not listed on the TSE (including issue listed only on the other exchanges) are not included in the data.
## Get dividend data
`GET` `https://api.jquants.com/v2/fins/dividend`
Either issue code (code) or date (date) must be specified.
### Parameter and Response
Either issue code (code) or date (date) must be specified.\
The combination of each parameter and the results of the response are as below.
- code: ✓, date: –, from /to: – → Cash dividend data for all available period.
- code: ✓, date: ✓, from /to: – → Cash dividend data for a specific issue on the specific date.
- code: ✓, date: –, from /to: ✓ → Cash dividend data for a specific issue for the specified period.
- code: –, date: ✓, from /to: – → Cash dividend data for all listed issues on the specific date.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| code | string | Optional | 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. |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
| date | string | Optional | When "from" and "to" are not specified (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/fins/dividend
**cURL**
```bash
curl -G https://api.jquants.com/v2/fins/dividend \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/fins/dividend", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/fins/dividend",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ---------------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PubDate | string | Required | Announcement Date (YYYY-MM-DD) |
| PubTime | string | Required | Announcement Time (HH:MM) |
| Code | string | Required | Issue code |
| RefNo | string | Required | Reference Number Number to uniquely identify the dividend notification See [about Reference Number](https://jpx-jquants.com/en/spec/fin-dividend/reference-number) |
| StatCode | string | Required | Status Code 1: new, 2: revised, 3: delete |
| BoardDate | string | Required | Date of Board of Directors' resolution |
| IFCode | string | Required | Interim/Final Code 1: interim, 2: final |
| FRCode | string | Required | Forecast/Result Code 1: result, 2: forecast |
| IFTerm | string | Required | Interim Final Term |
| DivRate | number / string | Required | Dividend value per share "-" if undetermined, "" if not applicable. |
| RecDate | string | Required | Record date |
| ExDate | string | Required | Ex-rights date |
| ActRecDate | string | Required | Date of Dividend Vesting |
| PayDate | string | Required | Scheduled payment start date "-" if undetermined, "" if not applicable. |
| CARefNo | string | Required | CA Reference Number Reference number of the dividend notice of modification or deletion. For new notification, same value as Reference number. See [about Reference Number](https://jpx-jquants.com/en/spec/fin-dividend/reference-number) |
| DistAmt | number / string | Required | Amount of cash delivered per share "-" if undetermined, "" if not applicable. Provides only after February 24, 2014. |
| RetEarn | number / string | Required | Retained earnings per share "-" if undetermined, "" if not applicable. Provides only after February 24, 2014. |
| DeemDiv | number / string | Required | Deemed dividend per share "-" if undetermined, "" if not applicable. Provides only after February 24, 2014. |
| DeemCapGains | number / string | Required | Amount of deemed transfer income per share "-" if undetermined, "" if not applicable. Provides only after February 24, 2014. |
| NetAssetDecRatio | number / string | Required | Decrease ratio in net assets "-" if undetermined, "" if not applicable. Provides only after February 24, 2014. |
| CommSpecCode | string | Required | Code stands for Commemorative/Special dividend 1: Commemorative, 2: Special, 3: Both, 0: Normal |
| CommDivRate | number / string | Required | Commemorative dividend value per share "-" if undetermined, "" if not applicable. Provides only after June 6, 2022. |
| SpecDivRate | number / string | Required | Special dividend value per share "-" if undetermined, "" if not applicable. Provides only after June 6, 2022. |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2014-02-24",
"PubTime": "09:21",
"Code": "15550",
"RefNo": "201402241B00002",
"StatCode": "1",
"BoardDate": "2014-02-24",
"IFCode": "2",
"FRCode": "2",
"IFTerm": "2014-03",
"DivRate": "-",
"RecDate": "2014-03-10",
"ExDate": "2014-03-06",
"ActRecDate": "2014-03-10",
"PayDate": "-",
"CARefNo": "201402241B00002",
"DistAmt": "",
"RetEarn": "",
"DeemDiv": "",
"DeemCapGains": "",
"NetAssetDecRatio": "",
"CommSpecCode": "0",
"CommDivRate": "",
"SpecDivRate": ""
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/fin-dividend/reference-number
# About Reference Number
## Reference Number
- Reference number: Number uniquely assigned to each record
- CA Reference number: Reference number assigned to each corporate action event. For a record with status "revised" or "delete", same value as reference number of the previous dividend notice to be modified or deleted is set in this field. For a record with status "new", same value as Reference number is set.
## Example: When the following notifications are received, we provide data as shown in the table below
- Issue: Japan Exchange Group, Inc. (Code: 86970)
- 2023-03-06 New dividend information is provided.
- 2023-03-07 Previously announced dividend information is modified.
- 2023-03-08 Previously announced dividend information is deleted.
- 2023-03-09 Another new dividend information is provided.
| PubDate | Code | RefNo | CARefNo | StatCode |
| ---------- | ----- | ----- | ------- | ---------- |
| 2023-03-06 | 86970 | 1 | 1 | 1: new |
| 2023-03-07 | 86970 | 2 | 1 | 2: revised |
| 2023-03-08 | 86970 | 3 | 1 | 3: delete |
| 2023-03-09 | 86970 | 4 | 4 | 1: new |
> **Note**
>
> - Only some items are shown in this example.
> - The above values only are for illustrative purposes and may differ from the data actually generated.
---
Source: https://jpx-jquants.com/en/spec/fin-earnings-date
# Earnings Announcement Dates (/fins/earnings-date)
`GET` /v2/fins/earnings-date
## API Overview
This API provides the earnings announcement dates that listed companies have reported to the Tokyo Stock Exchange.\
It covers all listed issues that have submitted a report (including REITs), regardless of their fiscal year end, and provides the history of changes and "to be determined" announcements on a per-publication-date basis.
### Notes on this API
> **Info**
>
> - When a change to an earnings announcement date is reported, the previous data is not deleted; the revised scheduled date is added as a new record (queries by `code` return all records including the change history).
> - When a previously published earnings announcement date is later changed to "to be determined", SchDate is an empty string (`""`).
> - When querying by `scheduled_date`, only the most recently published record for each issue and fiscal quarter (1Q/2Q/3Q/FY) matches. Therefore, if a scheduled date has since been changed, the record does not match its pre-change scheduled date.
> - The data availability period of each plan is applied based on the publication date (`PubDate`). With `date`, specifying a date outside your plan's accessible range returns a 400 error. With `code` / `scheduled_date`, records published outside the range are not included in the results.
## Retrieve earnings announcement date data
`GET` `https://api.jquants.com/v2/fins/earnings-date`
Exactly one of `code` (issue code), `date` (publication date), or `scheduled_date` (scheduled announcement date) must be specified.\
The combinations of parameters and the corresponding responses are as follows.
- code: ✓, date: –, scheduled\_date: – → Publication history of scheduled dates for the specified issue
- code: –, date: ✓, scheduled\_date: – → Scheduled date data published or changed on the specified date, for all issues
- code: –, date: –, scheduled\_date: ✓ → Data for all issues whose currently effective scheduled announcement date is the specified date
* Specifying two or more parameters at the same time results in a 400 error.\\
* If no matching data exists, an empty array (`"data": []`) is returned.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------- |
| code | string | Optional | Issue code (e.g. 86970 or 8697) |
| date | string | Optional | Publication date (e.g. 20250620 or 2025-06-20) |
| scheduled\_date | string | Optional | Scheduled earnings announcement date (e.g. 20250805 or 2025-08-05) |
| pagination\_key | string | Optional | String to specify the starting point of the search Set the pagination\_key returned by a previous search |
### Sample Code
/v2/fins/earnings-date
**cURL**
```bash
curl -G https://api.jquants.com/v2/fins/earnings-date \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/fins/earnings-date', {
params: {
code: '{{code}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/fins/earnings-date",
params={"code": "{{code}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Results
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
| PubDate | string | Required | Publication date (YYYY-MM-DD) The date on which this scheduled date was published or changed |
| SchDate | string | Required | Scheduled earnings announcement date (YYYY-MM-DD) An empty string (`""`) when to be determined |
| FQName | string | Required | Fiscal quarter (1Q / 2Q / 3Q / FY) |
| FYE | string | Required | Fiscal year end (MMDD) |
| Code | string | Required | Issue code (5 digits) |
| CoName | string | Required | Company name (Japanese) |
| CoNameEn | string | Required | Company name (English) |
Note: Company names (CoName / CoNameEn) reflect the data as of PubDate.
### Sample Response
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2025-06-03",
"SchDate": "2025-07-30",
"FQName": "1Q",
"FYE": "0331",
"Code": "86970",
"CoName": "日本取引所グループ",
"CoNameEn": "Japan Exchange Group,Inc."
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/fin-summary
# Financial Data (Summary only) (/fins/summary)
`GET` /v2/fins/summary
## Overview
You can obtain quarterly earnings summaries and disclosure information (mainly numerical data) on revisions to earnings and dividend information for listed companies.\
Either issue code (code) or date (date) must be specified.
## Attention
> **Info**
>
> - **About Accounting Standards:** Each item name output from the API is based on Japanese GAAP (JGAAP) disclosure items. Therefore, IFRS and U.S. GAAP (USGAAP) disclosure data do not have the concept of ordinary income, so the data is blank.
> **Info**
>
> - **About addition of API item in response to the "Revision of the Quarterly Disclosure System":**
> - In response to the "Revision of the Quarterly Disclosure System", the items to be described in the Summary Form of Financial Statements will be changed as below.
> - **before:** "Changes in significant subsidiaries during the period (changes in specified subsidiaries resulting in the change in scope of consolidation)"
> - **after:** "Significant changes in the scope of consolidation during the period"
> - In response to this change, "SignificantChangesInTheScopeOfConsolidation" is added to the response items of this API from Jul 22, 2024.
> - For details, please refer to the Data Item column.
> **Info**
>
> This API has its own [individual rate limit](https://jpx-jquants.com/en/spec/rate-limits#rate-limits-by-endpoint). For best practices on efficient data retrieval, including bulk retrieval of historical data, see [Rate Limits](https://jpx-jquants.com/en/spec/rate-limits#best-practices).
## Get quarterly financial information
`GET` `https://api.jquants.com/v2/fins/summary`
Either "code" or "date" must be specified.
### Parameter and Response
Either "code" or "date" must be specified.\
Combination of parameter in the request and results are as below.
- code: ✓, date: –, cursor: – → All financial data for a specific issue.
- code: ✓, date: ✓, cursor: – → Financial data for a specific issue on the specific date.
- code: –, date: ✓, cursor: – → Financial data for all listed issues on the specific date.
- code: –, date: ✓, cursor: ✓ → Financial data since the previous request (Premium plan only).
### Retrieving financial data using cursor
For the cursor-based differential retrieval specification, see [Retrieving Differential Data Using Cursor](https://jpx-jquants.com/en/spec/cursor).
> **Note**
>
> The cursor parameter is available for Premium plan users only.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| code | string | Optional | Issue code (e.g. 86970 or 8697) 4 or 5 character issue code |
| date | string | Optional | Disclosure date (e.g. 2022-01-05 or 20220105) |
| cursor | string | Optional | Cursor for differential retrieval (Premium plan only) Use the value returned as cursor in the previous response. Cannot be specified together with pagination\_key. For details, see [Retrieving Differential Data Using Cursor](https://jpx-jquants.com/en/spec/cursor). |
| pagination\_key | string | Optional | 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
/v2/fins/summary
**cURL**
```bash
curl -G https://api.jquants.com/v2/fins/summary \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/fins/summary', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/fins/summary",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| DiscDate | string | Required | Disclosed Date |
| DiscTime | string | Required | Disclosed Time |
| Code | string | Required | Issue code (5 digits) |
| DiscNo | string | Required | Disclosure Number The json output from the API is sorted in ascending order by disclosure number. |
| DocType | string | Required | Type of Document [Type of Document List](https://jpx-jquants.com/en/spec/fin-summary/typeofdocument) |
| CurPerType | string | Required | Type of Current Period \[1Q, 2Q, 3Q, 4Q, 5Q, FY] |
| CurPerSt | string | Required | Current Period Start Date |
| CurPerEn | string | Required | Current Period End Date |
| CurFYSt | string | Required | Current Fiscal Year Start Date |
| CurFYEn | string | Required | Current Fiscal Year End Date |
| NxtFYSt | string | Required | Next Fiscal Year Start Date Empty if no next fiscal year disclosure information in the record. |
| NxtFYEn | string | Required | Next Fiscal Year End Date Empty if no next fiscal year disclosure information in the record. |
| Sales | number | Required | Net Sales |
| OP | number | Required | Operating Profit |
| OdP | number | Required | Ordinary Profit |
| NP | number | Required | Profit |
| EPS | number | Required | Earnings Per Share |
| DEPS | number | Required | Diluted Earnings Per Share |
| TA | number | Required | Total Assets |
| Eq | number | Required | Equity |
| EqAR | number | Required | Equity to Asset Ratio |
| BPS | number | Required | Book Value Per Share |
| CFO | number | Required | Cash Flows from Operating Activities |
| CFI | number | Required | Cash Flows from Investing Activities |
| CFF | number | Required | Cash Flows from Financing Activities |
| CashEq | number | Required | Cash and Equivalents |
| Div1Q | number | Required | Result Dividend Per Share 1st Quarter |
| Div2Q | number | Required | Result Dividend Per Share 2nd Quarter |
| Div3Q | number | Required | Result Dividend Per Share 3rd Quarter |
| DivFY | number | Required | Result Dividend Per Share Fiscal Year End |
| DivAnn | number | Required | Result Dividend Per Share Annual |
| DivUnit | number | Required | Distributions Per Unit (REIT) |
| DivTotalAnn | number | Required | Result Total Dividend Paid Annual |
| PayoutRatioAnn | number | Required | Result Payout Ratio Annual |
| FDiv1Q | number | Required | Forecast Dividend Per Share 1st Quarter |
| FDiv2Q | number | Required | Forecast Dividend Per Share 2nd Quarter |
| FDiv3Q | number | Required | Forecast Dividend Per Share 3rd Quarter |
| FDivFY | number | Required | Forecast Dividend Per Share Fiscal Year End |
| FDivAnn | number | Required | Forecast Dividend Per Share Annual |
| FDivUnit | number | Required | Forecast Distributions Per Unit (REIT) |
| FDivTotalAnn | number | Required | Forecast Total Dividend Paid Annual |
| FPayoutRatioAnn | number | Required | Forecast Payout Ratio Annual |
| NxFDiv1Q | number | Required | Forecast Dividend Per Share Next Year 1st Quarter |
| NxFDiv2Q | number | Required | Forecast Dividend Per Share Next Year 2nd Quarter |
| NxFDiv3Q | number | Required | Forecast Dividend Per Share Next Year 3rd Quarter |
| NxFDivFY | number | Required | Forecast Dividend Per Share Next Year Fiscal Year End |
| NxFDivAnn | number | Required | Forecast Dividend Per Share Next Year Annual |
| NxFDivUnit | number | Required | Forecast Distributions Per Unit Next Year (REIT) |
| NxFPayoutRatioAnn | number | Required | Forecast Payout Ratio Next Year Annual |
| FSales2Q | number | Required | Forecast Net Sales 2nd Quarter |
| FOP2Q | number | Required | Forecast Operating Profit 2nd Quarter |
| FOdP2Q | number | Required | Forecast Ordinary Profit 2nd Quarter |
| FNP2Q | number | Required | Forecast Profit 2nd Quarter |
| FEPS2Q | number | Required | Forecast Earnings Per Share 2nd Quarter |
| NxFSales2Q | number | Required | Forecast Net Sales Next Year 2nd Quarter |
| NxFOP2Q | number | Required | Forecast Operating Profit Next Year 2nd Quarter |
| NxFOdP2Q | number | Required | Forecast Ordinary Profit Next Year 2nd Quarter |
| NxFNp2Q | number | Required | Forecast Profit Next Year 2nd Quarter |
| NxFEPS2Q | number | Required | Forecast Earnings Per Share Next Year 2nd Quarter |
| FSales | number | Required | Forecast Net Sales Fiscal Year End |
| FOP | number | Required | Forecast Operating Profit Fiscal Year End |
| FOdP | number | Required | Forecast Ordinary Profit Fiscal Year End |
| FNP | number | Required | Forecast Profit Fiscal Year End |
| FEPS | number | Required | Forecast Earnings Per Share Fiscal Year End |
| NxFSales | number | Required | Forecast Net Sales Next Fiscal Year End |
| NxFOP | number | Required | Forecast Operating Profit Next Fiscal Year End |
| NxFOdP | number | Required | Forecast Ordinary Profit Next Fiscal Year End |
| NxFNp | number | Required | Forecast Profit Next Fiscal Year End |
| NxFEPS | number | Required | Forecast Earnings Per Share Next Fiscal Year End |
| MatChgSub | string | Required | Material Changes in Subsidiaries |
| SigChgInC | string | Required | Significant Changes In The Scope Of Consolidation If the specified date is before 2024-07-21, the response does not contain a value for that item. |
| ChgByASRev | string | Required | Changes Based on Revisions of Accounting Standard |
| ChgNoASRev | string | Required | Changes Other Than Ones Based on Revisions of Accounting Standard |
| ChgAcEst | string | Required | Changes in Accounting Estimates |
| RetroRst | string | Required | Retrospective Restatement |
| ShOutFY | number | Required | Number of Issued and Outstanding Shares at Fiscal Year End Including Treasury Stock |
| TrShFY | number | Required | Number of Treasury Stock at Fiscal Year End |
| AvgSh | number | Required | Average Number of Shares |
| NCSales | number | Required | Non-consolidated Net Sales |
| NCOP | number | Required | Non-consolidated Operating Profit |
| NCOdP | number | Required | Non-consolidated Ordinary Profit |
| NCNP | number | Required | Non-consolidated Profit |
| NCEPS | number | Required | Non-consolidated Earnings Per Share |
| NCTA | number | Required | Non-consolidated Total Assets |
| NCEq | number | Required | Non-consolidated Equity |
| NCEqAR | number | Required | Non-consolidated Equity to Asset Ratio |
| NCBPS | number | Required | Non-consolidated Book Value Per Share |
| FNCSales2Q | number | Required | Non-consolidated Forecast Net Sales 2nd Quarter |
| FNCOP2Q | number | Required | Non-consolidated Forecast Operating Profit 2nd Quarter |
| FNCOdP2Q | number | Required | Non-consolidated Forecast Ordinary Profit 2nd Quarter |
| FNCNP2Q | number | Required | Non-consolidated Forecast Profit 2nd Quarter |
| FNCEPS2Q | number | Required | Non-consolidated Forecast Earnings Per Share 2nd Quarter |
| NxFNCSales2Q | number | Required | Non-consolidated Forecast Net Sales Next Year 2nd Quarter |
| NxFNCOP2Q | number | Required | Non-consolidated Forecast Operating Profit Next Year 2nd Quarter |
| NxFNCOdP2Q | number | Required | Non-consolidated Forecast Ordinary Profit Next Year 2nd Quarter |
| NxFNCNP2Q | number | Required | Non-consolidated Forecast Profit Next Year 2nd Quarter |
| NxFNCEPS2Q | number | Required | Non-consolidated Forecast Earnings Per Share Next Year 2nd Quarter |
| FNCSales | number | Required | Non-consolidated Forecast Net Sales Fiscal Year End |
| FNCOP | number | Required | Non-consolidated Forecast Operating Profit Fiscal Year End |
| FNCOdP | number | Required | Non-consolidated Forecast Ordinary Profit Fiscal Year End |
| FNCNP | number | Required | Non-consolidated Forecast Profit Fiscal Year End |
| FNCEPS | number | Required | Non-consolidated Forecast Earnings Per Share Fiscal Year End |
| NxFNCSales | number | Required | Non-consolidated Forecast Net Sales Next Fiscal Year End |
| NxFNCOP | number | Required | Non-consolidated Forecast Operating Profit Next Fiscal Year End |
| NxFNCOdP | number | Required | Non-consolidated Forecast Ordinary Profit Next Fiscal Year End |
| NxFNCNP | number | Required | Non-consolidated Forecast Profit Next Fiscal Year End |
| NxFNCEPS | number | Required | Non-consolidated Forecast Earnings Per Share Next Fiscal Year End |
| ShEq | number | Required | Shareholders' Equity |
| NCShEq | number | Required | Non-consolidated Shareholders' Equity |
| ROE | number | Required | Return on Equity |
| NCROE | number | Required | Non-consolidated Return on Equity |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"DiscDate": "2023-01-30",
"DiscTime": "12:00:00",
"Code": "86970",
"DiscNo": "20230127594871",
"DocType": "3QFinancialStatements_Consolidated_IFRS",
"CurPerType": "3Q",
"CurPerSt": "2022-04-01",
"CurPerEn": "2022-12-31",
"CurFYSt": "2022-04-01",
"CurFYEn": "2023-03-31",
"NxtFYSt": "",
"NxtFYEn": "",
"Sales": "100529000000",
"OP": "51765000000",
"OdP": "",
"NP": "35175000000",
"EPS": "66.76",
"DEPS": "",
"TA": "79205861000000",
"Eq": "320021000000",
"EqAR": "0.004",
"BPS": "",
"CFO": "",
"CFI": "",
"CFF": "",
"CashEq": "91135000000",
"Div1Q": "",
"Div2Q": "26.0",
"Div3Q": "",
"DivFY": "",
"DivAnn": "",
"DivUnit": "",
"DivTotalAnn": "",
"PayoutRatioAnn": "",
"FDiv1Q": "",
"FDiv2Q": "",
"FDiv3Q": "",
"FDivFY": "36.0",
"FDivAnn": "62.0",
"FDivUnit": "",
"FDivTotalAnn": "",
"FPayoutRatioAnn": "",
"NxFDiv1Q": "",
"NxFDiv2Q": "",
"NxFDiv3Q": "",
"NxFDivFY": "",
"NxFDivAnn": "",
"NxFDivUnit": "",
"NxFPayoutRatioAnn": "",
"FSales2Q": "",
"FOP2Q": "",
"FOdP2Q": "",
"FNP2Q": "",
"FEPS2Q": "",
"NxFSales2Q": "",
"NxFOP2Q": "",
"NxFOdP2Q": "",
"NxFNp2Q": "",
"NxFEPS2Q": "",
"FSales": "132500000000",
"FOP": "65500000000",
"FOdP": "",
"FNP": "45000000000",
"FEPS": "85.42",
"NxFSales": "",
"NxFOP": "",
"NxFOdP": "",
"NxFNp": "",
"NxFEPS": "",
"MatChgSub": "false",
"SigChgInC": "",
"ChgByASRev": "false",
"ChgNoASRev": "false",
"ChgAcEst": "true",
"RetroRst": "",
"ShOutFY": "528578441",
"TrShFY": "1861043",
"AvgSh": "526874759",
"NCSales": "",
"NCOP": "",
"NCOdP": "",
"NCNP": "",
"NCEPS": "",
"NCTA": "",
"NCEq": "",
"NCEqAR": "",
"NCBPS": "",
"FNCSales2Q": "",
"FNCOP2Q": "",
"FNCOdP2Q": "",
"FNCNP2Q": "",
"FNCEPS2Q": "",
"NxFNCSales2Q": "",
"NxFNCOP2Q": "",
"NxFNCOdP2Q": "",
"NxFNCNP2Q": "",
"NxFNCEPS2Q": "",
"FNCSales": "",
"FNCOP": "",
"FNCOdP": "",
"FNCNP": "",
"FNCEPS": "",
"NxFNCSales": "",
"NxFNCOP": "",
"NxFNCOdP": "",
"NxFNCNP": "",
"NxFNCEPS": "",
"ShEq": "318500000000",
"NCShEq": "",
"ROE": "0.112",
"NCROE": ""
}
],
"cursor": "eyJkIjoiMjAyNS0wNC0wMSIsInQiOiIyMDI1LTA0LTAxVDA4OjAwOjAwWiMyMDI1MDQwMTEzMDEwMCJ9"
}
```
---
Source: https://jpx-jquants.com/en/spec/fin-summary/typeofdocument
# Type of Document
List of TypeOfDocument items for Financial Data API.
## Document Type List
| Document Type | Description |
| -------------------------------------------------------- | ------------------------------------------------------------- |
| FYFinancialStatements\_Consolidated\_JP | Financial Statements (Consolidated, JP GAAP) |
| FYFinancialStatements\_Consolidated\_US | Financial Statements (Consolidated, US GAAP) |
| FYFinancialStatements\_NonConsolidated\_JP | Financial Statements (Non-consolidated, JP GAAP) |
| 1QFinancialStatements\_Consolidated\_JP | 1Q Financial Statements (Consolidated, JP GAAP) |
| 1QFinancialStatements\_Consolidated\_US | 1Q Financial Statements (Consolidated, US GAAP) |
| 1QFinancialStatements\_NonConsolidated\_JP | 1Q Financial Statements (Non-consolidated, JP GAAP) |
| 2QFinancialStatements\_Consolidated\_JP | 2Q Financial Statements (Consolidated, JP GAAP) |
| 2QFinancialStatements\_Consolidated\_US | 2Q Financial Statements (Consolidated, US GAAP) |
| 2QFinancialStatements\_NonConsolidated\_JP | 2Q Financial Statements (Non-consolidated, JP GAAP) |
| 3QFinancialStatements\_Consolidated\_JP | 3Q Financial Statements (Consolidated, JP GAAP) |
| 3QFinancialStatements\_Consolidated\_US | 3Q Financial Statements (Consolidated, US GAAP) |
| 3QFinancialStatements\_NonConsolidated\_JP | 3Q Financial Statements (Non-consolidated, JP GAAP) |
| OtherPeriodFinancialStatements\_Consolidated\_JP | Other Period Financial Statements (Consolidated, JP GAAP) |
| OtherPeriodFinancialStatements\_Consolidated\_US | Other Period Financial Statements (Consolidated, US GAAP) |
| OtherPeriodFinancialStatements\_NonConsolidated\_JP | Other Period Financial Statements (Non-consolidated, JP GAAP) |
| FYFinancialStatements\_Consolidated\_JMIS | Financial Statements (Consolidated, JMIS) |
| 1QFinancialStatements\_Consolidated\_JMIS | 1Q Financial Statements (Consolidated, JMIS) |
| 2QFinancialStatements\_Consolidated\_JMIS | 2Q Financial Statements (Consolidated, JMIS) |
| 3QFinancialStatements\_Consolidated\_JMIS | 3Q Financial Statements (Consolidated, JMIS) |
| OtherPeriodFinancialStatements\_Consolidated\_JMIS | Other Period Financial Statements (Consolidated, JMIS) |
| FYFinancialStatements\_NonConsolidated\_IFRS | Financial Statements (Non-consolidated, IFRS) |
| 1QFinancialStatements\_NonConsolidated\_IFRS | 1Q Financial Statements (Non-consolidated, IFRS) |
| 2QFinancialStatements\_NonConsolidated\_IFRS | 2Q Financial Statements (Non-consolidated, IFRS) |
| 3QFinancialStatements\_NonConsolidated\_IFRS | 3Q Financial Statements (Non-consolidated, IFRS) |
| OtherPeriodFinancialStatements\_NonConsolidated\_IFRS | Other Period Financial Statements (Non-consolidated, IFRS) |
| FYFinancialStatements\_Consolidated\_IFRS | Financial Statements (Consolidated, IFRS) |
| 1QFinancialStatements\_Consolidated\_IFRS | 1Q Financial Statements (Consolidated, IFRS) |
| 2QFinancialStatements\_Consolidated\_IFRS | 2Q Financial Statements (Consolidated, IFRS) |
| 3QFinancialStatements\_Consolidated\_IFRS | 3Q Financial Statements (Consolidated, IFRS) |
| OtherPeriodFinancialStatements\_Consolidated\_IFRS | Other Period Financial Statements (Consolidated, IFRS) |
| FYFinancialStatements\_NonConsolidated\_Foreign | Financial Statements (Non-consolidated, Foreign) |
| 1QFinancialStatements\_NonConsolidated\_Foreign | 1Q Financial Statements (Non-consolidated, Foreign) |
| 2QFinancialStatements\_NonConsolidated\_Foreign | 2Q Financial Statements (Non-consolidated, Foreign) |
| 3QFinancialStatements\_NonConsolidated\_Foreign | 3Q Financial Statements (Non-consolidated, Foreign) |
| OtherPeriodFinancialStatements\_NonConsolidated\_Foreign | Other Period Financial Statements (Non-consolidated, Foreign) |
| FYFinancialStatements\_Consolidated\_Foreign | Financial Statements (Consolidated, Foreign) |
| 1QFinancialStatements\_Consolidated\_Foreign | 1Q Financial Statements (Consolidated, Foreign) |
| 2QFinancialStatements\_Consolidated\_Foreign | 2Q Financial Statements (Consolidated, Foreign) |
| 3QFinancialStatements\_Consolidated\_Foreign | 3Q Financial Statements (Consolidated, Foreign) |
| OtherPeriodFinancialStatements\_Consolidated\_Foreign | Other Period Financial Statements (Consolidated, Foreign) |
| FYFinancialStatements\_Consolidated\_REIT | Financial Statements (REIT) |
| DividendForecastRevision | Dividend Forecast Revision |
| EarnForecastRevision | Earnings Forecast Revision |
| REITDividendForecastRevision | REIT Distribution Forecast Revision |
| REITEarnForecastRevision | REIT Earnings Forecast Revision |
---
Source: https://jpx-jquants.com/en/spec/fix-data-info
# Data Correction History and Known issues
### How Data Corrections Are Reflected
> **Note**
>
> - Data corrections are reflected by overwriting the existing data. Previous versions of the data are not retained, and diffs of corrected records are not provided.
> - We do not provide an API that notifies you when a data update or correction is complete, nor version numbers or ETags for the data.
> - Differential data retrieval using cursor is supported only for Financial Data, Financial Statement Data, and TDnet/Company Disclosure Index List (see [Retrieving Differential Data Using Cursor](https://jpx-jquants.com/en/spec/cursor)).
> - If you need to reliably incorporate corrections, we recommend periodically re-fetching the data you need, taking the [update timing of provided data](https://jpx-jquants.com/en/spec/data-update) into account.
### Data Correction History
#### Recent Data Correction History (Last 5 Entries)
| Correction Date | Target API | Affected Period | Description |
| ---------------- | -------------------------------------------- | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| August 27, 2026 | TDnet/Company Disclosure | August 29, 2022, November 2, 2023 | Added missing disclosure index entries and disclosure documents (PDF/XBRL) for August 29, 2022 and November 2, 2023. The TDnet/Company Disclosure Index Bulk Download file has also been replaced with the corrected version. |
| August 5, 2026 | Options (OHLC) | August 3, 2026 | Corrected incorrect values recorded in the following fields for some Securities Options (EQOP) issues.Settle(Settlement Price) IV(Implied Volatility)Number of affected issues: 1,189 The daily bulk data file for August 3, 2026 has also been replaced with the corrected version. |
| June 29, 2026 | Stock Prices (OHLC) | - | Following the addition of rights issues to the price adjustment targets, adjusted prices and trading volumes that were not correctly adjusted for past rights issues have been corrected. Affected issue codes: 17730, 33180, 37500, 38320, 38560, 45410, 57210, 63970, 69930, 77780, 94780 |
| January 23, 2026 | Outstanding Short Selling Positions Reported | November 7, 2013 - January 13, 2026 | Minor errors caused by floating-point operations have been corrected, and the values have been normalized to four decimal places.ShrtPosToSO(Ratio of Short Positions to Shares Outstanding) PrevRptRatio(Ratio of Short Positions in Previous Reporting) |
| May 2, 2025 | Financial Data (Summary only) | - | Corrected the data overall. |
#### Past Correction History
| Correction Date | Target API | Affected Period | Description |
| ------------------ | ------------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| September 20, 2024 | Options (OHLC) | January 4, 2010 - March 20, 2014 | Corrected morning/afternoon session OHLC values for index options |
| September 20, 2024 | Futures (OHLC) | From 2010 onwards | Corrected Day Session OHLC values for index futures |
| August 2, 2024 | Financial Data (Summary only) / Financial Statement Data (BS/PL/CF) | - | Corrected the data overall. |
| June 17, 2024 | Listed Issue Master | - | Fixed incorrect ScaleCategory values that were erroneously set to "-" |
| February 28, 2024 | Financial Data (Summary only) / Financial Statement Data (BS/PL/CF) | January 13, 2009 - February 8, 2024 | Corrected the data overall. |
| November 7, 2023 | Short Sale Value and Ratio by Sector | November 6, 2023 | Corrected entire data for November 6, 2023. |
| September 22, 2023 | Trading by Type of Investors | - | Deleted data for non-existent issue codes that existed on certain dates Issue codes: 20000, 30000, 50000 |
| April 10, 2023 | Financial Data (Summary only) | July 7, 2008 - March 31, 2014 | Fixed missing data for the following field (ResultDividentPerShareAnual). Corrected values that were incorrectly populated with previous fiscal period values to current fiscal period values. |
| April 10, 2023 | Stock Prices (OHLC) | March 28, 2023 | Added missing data for March 28, 2023 |
| April 4, 2023 | Financial Data (Summary only) | July 7, 2008 - March 31, 2014 | Fixed missing data for the following fields (TypeOfCurrentPeriod, CurrentPeriodStartDate, CurrentPeriodEndDate, CurrentFiscalYearStartDate, CurrentFiscalYearEndDate). |
| April 4, 2023 | Options (OHLC) | May 7, 2008 - July 15, 2016 | Corrected Month (contract month) to YYYY-MM format |
### Known Issues
This section describes currently known issues and problems.
#### Current Known Issues
| Date Added | Target API | Description | Workaround | Date Resolved |
| ---------- | ---------- | ----------- | ---------- | ------------- |
| None | | | | |
#### Resolved
| Date Added | Target API | Description | Workaround | Date Resolved |
| --------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- | ------------------ |
| August 26, 2024 | Futures (OHLC) | Unable to retrieve Day Session OHLC values for index futures. | | September 20, 2024 |
| June 9, 2023 | Financial Data (Summary only) | Errors in TypeOfCurrentPeriod and CurrentPeriodEndDate * Issue code 36330: Disclosure dates 2017-04-27, 2017-07-27, 2017-10-30 * Issue code 60260: Disclosure dates 2015-04-28, 2015-07-29 | You can verify the period using the TypeOfDocument value [Document Type](fin-summary/typeofdocument) | February 28, 2024 |
| April 10, 2023 | Trading by Type of Investors | Unable to retrieve all-day data without specifying a date | Please specify a date or section to narrow down the request scope. | April 27, 2023 |
| April 3, 2023 | Financial Data (Summary only) | Unable to retrieve data for May 13, 2022 by specifying the date | Please specify both date and issue code to narrow down the request scope. | April 27, 2023 |
---
Source: https://jpx-jquants.com/en/spec/gzip-compression
# Gzip Compression of API Responses
API responses are compressed using Gzip to reduce data transfer volume.
## Impact by User Usage Pattern
| Package\* Usage | Accept-Encoding:gzip Present | Client-Side Handling Required |
| :------------------- | :--------------------------- | :------------------------------------------------------------------------------------------------------------------------ |
| **Package Used** | Header is added by default | **No handling required** (Compressed responses are automatically decompressed, so no client-side consideration is needed) |
| **Package Not Used** | Header present | **Proper decompression of compressed responses is required** (For curl, use `--compressed`) |
| | Header not present | **No handling required** (Uncompressed responses are received, so no client-side consideration is needed) |
\* Refers to HTTP client libraries commonly used for REST API calls. (Examples) Libraries such as requests and urllib in Python
---
Source: https://jpx-jquants.com/en/spec/idx-bars-daily-topix
# TOPIX Prices (OHLC) (/indices/bars/daily/topix)
`GET` /v2/indices/bars/daily/topix
## Overview
Available index is TOPIX (Tokyo Stock Price Index).
## Get Daily TOPIX Information
`GET` `https://api.jquants.com/v2/indices/bars/daily/topix`
"from/to" can be specified (Optional). If "from/to" is not specified, the response contains all historical data.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/indices/bars/daily/topix
**cURL**
```bash
curl -G https://api.jquants.com/v2/indices/bars/daily/topix \
-H "x-api-key: {{apiKey}}" \
-d from="{{from}}" \
-d to="{{to}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/indices/bars/daily/topix", {
params: {
from: '{{from}}',
to: '{{to}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/indices/bars/daily/topix",
params={
"from": "{{from}}",
"to": "{{to}}",
},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------------- |
| Date | string | Required | Date (YYYY-MM-DD) |
| O | number | Required | Open Price |
| H | number | Required | High Price |
| L | number | Required | Low Price |
| C | number | Required | Close Price |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2022-06-28",
"O": 1885.52,
"H": 1907.38,
"L": 1885.32,
"C": 1907.38
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/idx-bars-daily/indexcodes
# Index Codes
## Notes on Each Index
> **Info**
>
> - Although the Tokyo Stock Exchange Mothers market was reorganized on April 4, 2022, based on certain rules, the replacement of the component stocks of the Tokyo Stock Exchange Mothers Index was carried out, and on November 6, 2023, the index name was changed to "Tokyo Stock Exchange Growth Market 250 Index". For details, please refer to [here](https://www.jpx.co.jp/english/news/6030/20230428-01.html).
> - Indices marked "(Premium)" are available only with the Premium plan.
> - Total Return Index series provide only the closing price.
| Index Code | Index Name | Data Recording Period |
| ---------- | -------------------------------------------------------------------------------------- | ---------------------------------------- |
| 0000 | TOPIX | 2008/5/7〜 |
| 0001 | TSE Second Section Composite Index | 2008/5/7〜2022/4/1 |
| 0028 | TOPIX Core30 | 2008/5/7〜 |
| 0029 | TOPIX Large 70 | 2008/5/7〜 |
| 002A | TOPIX 100 | 2008/5/7〜 |
| 002B | TOPIX Mid400 | 2008/5/7〜 |
| 002C | TOPIX 500 | 2008/5/7〜 |
| 002D | TOPIX Small | 2008/5/7〜 |
| 002E | TOPIX 1000 | 2008/5/7〜 |
| 002F | TOPIX Small500 | (OHLC) 2018/10/9〜 (Close only) 2018/9/3〜 |
| 0040 | TSE Sector Index: Fishery, Agriculture & Forestry | 2008/5/7〜 |
| 0041 | TSE Sector Index: Mining | 2008/5/7〜 |
| 0042 | TSE Sector Index: Construction | 2008/5/7〜 |
| 0043 | TSE Sector Index: Foods | 2008/5/7〜 |
| 0044 | TSE Sector Index: Textiles & Apparels | 2008/5/7〜 |
| 0045 | TSE Sector Index: Pulp & Paper | 2008/5/7〜 |
| 0046 | TSE Sector Index: Chemicals | 2008/5/7〜 |
| 0047 | TSE Sector Index: Pharmaceutical | 2008/5/7〜 |
| 0048 | TSE Sector Index: Oil & Coal Products | 2008/5/7〜 |
| 0049 | TSE Sector Index: Rubber Products | 2008/5/7〜 |
| 004A | TSE Sector Index: Glass & Ceramics Products | 2008/5/7〜 |
| 004B | TSE Sector Index: Iron & Steel | 2008/5/7〜 |
| 004C | TSE Sector Index: Nonferrous Metals | 2008/5/7〜 |
| 004D | TSE Sector Index: Metal Products | 2008/5/7〜 |
| 004E | TSE Sector Index: Machinery | 2008/5/7〜 |
| 004F | TSE Sector Index: Electric Appliances | 2008/5/7〜 |
| 0050 | TSE Sector Index: Transportation Equipment | 2008/5/7〜 |
| 0051 | TSE Sector Index: Precision Instruments | 2008/5/7〜 |
| 0052 | TSE Sector Index: Other Products | 2008/5/7〜 |
| 0053 | TSE Sector Index: Electric Power & Gas | 2008/5/7〜 |
| 0054 | TSE Sector Index: Land Transportation | 2008/5/7〜 |
| 0055 | TSE Sector Index: Marine Transportation | 2008/5/7〜 |
| 0056 | TSE Sector Index: Air Transportation | 2008/5/7〜 |
| 0057 | TSE Sector Index: Warehousing & Harbor Transportation Services | 2008/5/7〜 |
| 0058 | TSE Sector Index: Information & Communication | 2008/5/7〜 |
| 0059 | TSE Sector Index: Wholesale Trade | 2008/5/7〜 |
| 005A | TSE Sector Index: Retail Trade | 2008/5/7〜 |
| 005B | TSE Sector Index: Banks | 2008/5/7〜 |
| 005C | TSE Sector Index: Securities & Commodity Futures | 2008/5/7〜 |
| 005D | TSE Sector Index: Insurance | 2008/5/7〜 |
| 005E | TSE Sector Index: Other Financing Business | 2008/5/7〜 |
| 005F | TSE Sector Index: Real Estate | 2008/5/7〜 |
| 0060 | TSE Sector Index: Services | 2008/5/7〜 |
| 0070 | TSE Growth Market 250 Index (Formerly: TSE Mothers Index) | 2008/5/7〜 |
| 0075 | REIT | 2008/5/7〜 |
| 0080 | TOPIX-17 Foods | 2009/2/2〜 |
| 0081 | TOPIX-17 Energy Resources | 2009/2/2〜 |
| 0082 | TOPIX-17 Construction & Materials | 2009/2/2〜 |
| 0083 | TOPIX-17 Raw Materials & Chemicals | 2009/2/2〜 |
| 0084 | TOPIX-17 Pharmaceutical | 2009/2/2〜 |
| 0085 | TOPIX-17 Automobiles & Transportation Equipment | 2009/2/2〜 |
| 0086 | TOPIX-17 Steel & Nonferrous Metals | 2009/2/2〜 |
| 0087 | TOPIX-17 Machinery | 2009/2/2〜 |
| 0088 | TOPIX-17 Electric Appliances & Precision Instruments | 2009/2/2〜 |
| 0089 | TOPIX-17 IT & Services, Others | 2009/2/2〜 |
| 008A | TOPIX-17 Electric Power & Gas | 2009/2/2〜 |
| 008B | TOPIX-17 Transportation & Logistics | 2009/2/2〜 |
| 008C | TOPIX-17 Commercial & Wholesale Trade | 2009/2/2〜 |
| 008D | TOPIX-17 Retail Trade | 2009/2/2〜 |
| 008E | TOPIX-17 Banks | 2009/2/2〜 |
| 008F | TOPIX-17 Financials (Ex Banks) | 2009/2/2〜 |
| 0090 | TOPIX-17 Real Estate | 2009/2/2〜 |
| 0091 | JASDAQ INDEX | 2008/5/7〜2022/4/1 |
| 0500 | TSE Prime Market Index | 2022/6/27〜 |
| 0501 | TSE Standard Market Index | 2022/6/27〜 |
| 0502 | TSE Growth Market Index | 2022/6/27〜 |
| 0503 | JPX Prime 150 Index | (OHLC) 2023/7/3〜 (Close only) 2023/5/29〜 |
| 0504 | JPX Start-Up Acceleration 100 Index | (OHLC) 2026/3/9〜 (Close only) 2022/7/28〜 |
| 8100 | TOPIX Value | 2009/2/9〜 |
| 812C | TOPIX500 Value | 2009/2/9〜 |
| 812D | TOPIXSmall Value | 2009/2/9〜 |
| 8200 | TOPIX Growth | 2009/2/9〜 |
| 822C | TOPIX500 Growth | 2009/2/9〜 |
| 822D | TOPIXSmall Growth | 2009/2/9〜 |
| 8501 | TSE REIT Office Index | (OHLC) 2010/3/8〜 (Close only) 2010/3/1〜 |
| 8502 | TSE REIT Residential Index | (OHLC) 2010/3/8〜 (Close only) 2010/3/1〜 |
| 8503 | TSE REIT Retail & Logistics, etc. Index | (OHLC) 2010/3/8〜 (Close only) 2010/3/1〜 |
| 6000 | TOPIX (Total Return) Closing Price | 2010/1/4〜 |
| B507 | JPX-Nikkei 400 Total Return Index Closing Price | 2013/11/18〜 |
| 6096 | JPX-Nikkei 400 Net Total Return Index Closing Price | 2015/10/26〜 |
| 6095 | TOPIX Net Total Return Index Closing Price | 2015/10/26〜 |
| 6028 | TOPIX Core30 (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6029 | TOPIX Large70 (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 602A | TOPIX 100 (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 602B | TOPIX Mid400 (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 602C | TOPIX 500 (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 602D | TOPIX 1000 (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 602E | TOPIX Small (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6040 | Fishery, Agriculture & Forestry (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6041 | Mining (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6042 | Construction (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6043 | Foods (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6044 | Textiles & Apparels (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6045 | Pulp & Paper (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6046 | Chemicals (Total Return) Closing Price | (Premium) 2010/1/6〜 |
| 6047 | Pharmaceutical (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6048 | Oil & Coal Products (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6049 | Rubber Products (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 604A | Glass & Ceramics Products (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 604B | Iron & Steel (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 604C | Nonferrous Metals (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 604D | Metal Products (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 604E | Machinery (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 604F | Electronic Appliances (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6050 | Transportation Equipment (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6051 | Precision Instruments (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6052 | Other Products (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6053 | Electric Power & Gas (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6054 | Land Transportation (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6055 | Marine Transportation (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6056 | Air Transportation (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6057 | Warehousing & Harbor Transportation Service (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6058 | Information & Communication (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6059 | Wholesale Trade (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 605A | Retail Trade (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 605B | Banks (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 605C | Securities & Commodity Futures (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 605D | Insurance (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 605E | Other Financing Business (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 605F | Real Estate (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6060 | Services (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6080 | TOPIX-17 FOODS(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6081 | TOPIX-17 ENERGY RESOURCES(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6082 | TOPIX-17 CONSTRUCTION & MATERIALS(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6083 | TOPIX-17 RAW MATERIALS & CHEMICALS(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6084 | TOPIX-17 PHARMACEUTICAL(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6085 | TOPIX-17 AUTOMOBILES & TRANSPORTATION EQUIPMENT(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6086 | TOPIX-17 STEEL & NONFERROUS METALS(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6087 | TOPIX-17 MACHINERY(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6088 | TOPIX-17 ELECTRIC APPLIANCES & PRECISION INSTRUMENTS(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6089 | TOPIX-17 IT & SERVICES, OTHERS(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 608A | TOPIX-17 ELECTRIC POWER & GAS(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 608B | TOPIX-17 TRANSPORTATION & LOGISTICS(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 608C | TOPIX-17 COMMERCIAL & WHOLESALE TRADE(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 608D | TOPIX-17 RETAIL TRADE(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 608E | TOPIX-17 BANKS(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 608F | TOPIX-17 FINANCIALS （EX BANKS）(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6090 | TOPIX-17 REAL ESTATE(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| B100 | TOPIX Value(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| B200 | TOPIX 500 Value(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| B12C | TOPIX Small Value(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| B22C | TOPIX Growth(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| B12D | TOPIX 500 Growth(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| B22D | TOPIX Small Growth(Total Return) Closing Price | (Premium) 2010/1/4〜 |
| 6075 | REIT Index (Total Return) Closing Price | (Premium) 2010/1/4〜 |
| B500 | Dividend Focus 100 (Total Return) Closing Price | (Premium) 2010/3/1〜 |
| B501 | Tokyo Stock Exchange REIT Office Index(Total Return) Closing Price | (Premium) 2010/3/1〜 |
| B502 | Tokyo Stock Exchange REIT Residential Index(Total Return) Closing Price | (Premium) 2010/3/1〜 |
| B503 | Tokyo Stock Exchange REIT Retail & Logistics, Others Index(Total Return) Closing Price | (Premium) 2010/3/1〜 |
| 7000 | Tokyo Stock Exchange Prime Market Total Return Index Closing Price | (Premium) 2022/4/4〜 |
| 7001 | Tokyo Stock Exchange Standard Market Total Return Index Closing Price | (Premium) 2022/4/4〜 |
| 7002 | Tokyo Stock Exchange Growth Market Total Return Index Closing Price | (Premium) 2022/4/4〜 |
| 6503 | JPX Prime 150 Index (Total Return) Closing Price | (Premium) 2023/5/29〜 |
| 6504 | JPX Start-Up Acceleration 100 Index (Total Return) Closing Price | (Premium) 2022/7/28〜 |
---
Source: https://jpx-jquants.com/en/spec/idx-bars-daily
# Indices (OHLC) (/indices/bars/daily)
`GET` /v2/indices/bars/daily
## Overview
Available various indices.
Please refer to [this page](https://jpx-jquants.com/en/spec/idx-bars-daily/indexcodes) for the currently distributed indices.
### Attention
> **Info**
>
> - Although the Tokyo Stock Exchange Mothers market was reorganized on April 4, 2022, based on certain rules, the replacement of the component stocks of the Tokyo Stock Exchange Mothers Index was carried out, and on November 6, 2023, the index name was changed to "Tokyo Stock Exchange Growth Market 250 Index". For details, please refer to [here](https://www.jpx.co.jp/english/news/6030/20230428-01.html).
> - The OHLC data for Oct. 1st, 2020 includes the closing price from the previous trading day (Sep. 30th, 2020) because trading was halted all day due to the failure of the equity trading system, arrowhead.
> - Some indices are available only with the Premium plan.
> - For some indices, only the closing price is provided.
### Indices and Items Not Provided
Please refer to [the index codes page](https://jpx-jquants.com/en/spec/idx-bars-daily/indexcodes) for the indices currently distributed. The following indices and items are not provided.
> **Info**
>
> - The Nikkei Stock Average (cash index) is not provided.
> - Trading value and trading volume are not included in the responses of this API.
## Get daily various indices prices (OHLC)
`GET` `https://api.jquants.com/v2/indices/bars/daily`
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: – → All historical indices prices of a specific index code.
- code: ✓, date: ✓, from /to: – → Indices prices of a specific index code on the specific date.
- code: ✓, date: –, from /to: ✓ → Indices prices of a specific index code for the specified period.
- code: –, date: ✓, from /to: – → All listed indices prices for the specific date.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | Index code (e.g. 0000 or 0028) Please refer to [the index codes page](https://jpx-jquants.com/en/spec/idx-bars-daily/indexcodes) for the currently distributed indices. |
| date | string | Optional | Date of data when "from" and "to" are not specified (e.g. 20210907 or 2021-09-07) |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/indices/bars/daily
**cURL**
```bash
curl -G https://api.jquants.com/v2/indices/bars/daily \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/indices/bars/daily", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/indices/bars/daily",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------- |
| Date | string | Required | Date (YYYY-MM-DD) |
| Code | string | Required | Index Code Please refer to [this page](https://jpx-jquants.com/en/spec/idx-bars-daily/indexcodes) for the currently distributed indices. |
| O | number | Required | Open Price（※） |
| H | number | Required | High Price（※） |
| L | number | Required | Low Price（※） |
| C | number | Required | Close Price |
※ Null is set for indices where only the closing price is provided.
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-12-01",
"Code": "0028",
"O": 1199.18,
"H": 1202.58,
"L": 1195.01,
"C": 1200.17
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/jquants-cli
# J-Quants CLI
A guide to using the CLI tool `jquants` for retrieving Japanese stock market data via J-Quants API V2.
> **Note**
>
> This guide focuses on setup, global options, and common usage patterns. For a full list of subcommand options, run `jquants --help`.
## Prerequisites
- **Account Registration:** An [account registration](https://jpx-jquants.com/register) is required to use J-Quants API V2.
- **Plan Selection:** Choose one of the following plans to access data: Free, Light, Standard, or Premium. Note that accessible endpoints vary by plan.
## Installation
### Homebrew (macOS / Linux)
```bash
brew install J-Quants/tap/jquants
```
> **Note**
>
> Starting with Homebrew 6.0.0, third-party taps must be explicitly trusted before their formulae can be installed, as a security enhancement. If you see an error indicating the tap is not trusted, trust the formula with the following command and run the install again.
>
> ```bash
> brew trust --formula J-Quants/tap/jquants
> ```
>
> See the [official Homebrew documentation (Tap Trust)](https://docs.brew.sh/Tap-Trust) for details.
### GitHub Releases
Download the pre-built binary for your platform from the [Releases page](https://github.com/J-Quants/jquants-cli/releases) and place it in a directory on your `PATH`.
| OS | Architecture | File |
| ------- | --------------------- | ----------------------------------------------------- |
| macOS | Intel (x86\_64) | `jquants-{version}-x86_64-apple-darwin.tar.gz` |
| macOS | Apple Silicon (ARM64) | `jquants-{version}-aarch64-apple-darwin.tar.gz` |
| Linux | x86\_64 (musl) | `jquants-{version}-x86_64-unknown-linux-musl.tar.gz` |
| Linux | ARM64 (musl) | `jquants-{version}-aarch64-unknown-linux-musl.tar.gz` |
| Windows | x86\_64 | `jquants-{version}-x86_64-pc-windows-msvc.zip` |
## Authentication
### Recommended: OAuth2 Browser Login
```bash
jquants login
```
Running this command automatically opens a browser. After logging in with your J-Quants account, the API Key is saved to `~/.config/jquants/credentials.json`. You do not need to specify the API Key explicitly after this step.
### Direct API Key (Alternative)
You can configure the API Key via an environment variable or a `.env` file.
```bash {{ title: "Environment Variable" }}
export JQUANTS_API_KEY=your_api_key_here
```
```ini {{ title: ".env File" }}
# .env file (place at project root)
JQUANTS_API_KEY=your_api_key_here
```
Obtain your API Key from the [J-Quants Dashboard](https://jpx-jquants.com/dashboard/api-keys).
**Authentication priority:** `api_key` in `~/.config/jquants/credentials.json` → `JQUANTS_API_KEY` environment variable → error
> **Note**
>
> - Do not commit `credentials.json` or `JQUANTS_API_KEY` to your repository.
> - Add the `.env` file to `.gitignore` to exclude it from version control.
### Logout
```bash
jquants logout
```
Clears the browser login session and removes `~/.config/jquants/credentials.json`.
## AI Agent Integration
This tool includes a Skills file for AI Agents (e.g., Claude Code). Install it with one of the following commands.
```bash {{ title: "npx" }}
npx skills add J-Quants/jquants-cli
```
```bash {{ title: "jquants CLI (current directory)" }}
# Place in current directory
jquants skills add
```
```bash {{ title: "jquants CLI (specify directory)" }}
# Creates .claude/skills/jquants-cli-usage/
jquants skills add --dir .claude/skills
```
## Basic Usage
### Global Option Placement
`--output`, `--save`, and `--fields` must all be specified **before the subcommand**.
```bash {{ title: "Correct" }}
# ✅ Correct
jquants --output csv eq daily --code 86970
jquants --output json --save out.json eq master
```
```bash {{ title: "Incorrect" }}
# ❌ Incorrect (after subcommand has no effect)
jquants eq daily --code 86970 --output csv
```
### Output Format
Use the `--output` (`-o`) flag to select the output format.
| Format | Description |
| --------- | ----------------------------------------------------- |
| `table` | Table format (default). Column names are abbreviated. |
| `json` | JSON format. All fields output with full names. |
| `csv` | CSV format. Also switches automatically when piping. |
| `parquet` | Apache Parquet format. Requires `--save`. |
```bash
jquants eq daily --code 86970 # Table display (default)
jquants --output json eq daily --code 86970 # JSON output (all fields)
jquants --output csv eq master # CSV output
jquants --output parquet --save out.parquet eq daily --code 86970 # Save as Parquet
```
> **Note**
>
> When using `--output parquet`, **`--save` is required**. Omitting `--save` will result in an error.
### Field Selection
Use `--fields` (`-f`) to narrow down the fields to retrieve. Field names use the JSON/CSV key names (API field names), which differ from the abbreviated column names in table display.
```bash
# Retrieve only issue code, date, and adjusted close price
jquants -f Date,Code,AdjC eq daily --code 86970
# Save multiple fields as CSV
jquants --output csv --save prices.csv -f Date,Code,Open,High,Low,Close,Volume eq daily --code 86970
```
### How to Check Field Names
Use `jquants schema ` to view the list of available fields (e.g., `jquants schema eq.daily`).
If you specify a field name that does not exist with `-f`, an error message will list the available fields.
### Saving to File
Use `--save ` to save output to a file. Combine with `--output`.
```bash
jquants --output csv --save master.csv eq master
jquants --output json --save daily.json eq daily --code 86970
jquants --output parquet --save daily.parquet eq daily --code 86970
```
> **Note**
>
> `--output table` (default) cannot be combined with `--save`. Specify `csv`, `json`, or `parquet` for file output. A `Saved: ` message is printed to stderr upon completion.
### Automatic CSV Switch When Piping
When stdout is connected to a pipe (non-TTY detected), output is automatically switched to CSV format even with `--output table`.
```bash
jquants eq master | head -5
jquants eq master | awk -F, '{print $3}'
jquants eq daily --code 86970 | python3 script.py
```
## Command Reference
### eq — Equities
Retrieves stock prices, listed issue information, valuation indicators, and investor trading data.
| Subcommand | Description |
| ------------------- | -------------------------------------------------------------------------------------- |
| `master` | Listed issue information (name, market, sector, etc.) |
| `daily` | Daily stock prices (OHLCV, adjusted) |
| `am` | Morning session OHLCV |
| `minute` | Minute-by-minute OHLCV |
| `earnings-calendar` | Scheduled earnings announcement dates (March/September fiscal year-end companies only) |
| `investor-types` | Trading by investor type |
| `trades` | Tick data (trade-by-trade, bulk retrieval) |
| `valuation` | Valuation indicators |
### mkt — Market
Retrieves market data including trading breakdown, margin trading, short selling, and trading calendar.
| Subcommand | Description |
| ------------------- | ------------------------------------------------------------------ |
| `breakdown` | Trading breakdown |
| `margin-alert` | Daily disclosed margin trading balance |
| `margin-interest` | Weekly margin trading balance |
| `calendar` | Trading calendar (business days and holidays) |
| `short-ratio` | Short selling ratio by sector (filter by 33-sector code `--s33`) |
| `short-sale-report` | Short sale balance report (by disclosure date `--disc-date`, etc.) |
### edinet — EDINET Documents
Retrieves data derived from EDINET filings such as annual securities reports and large volume holding reports. **Requires the Standard plan or higher.**
| Subcommand | Description |
| --------------------------- | ----------------------------------------------- |
| `major-shareholders` | Major shareholders (annual securities reports) |
| `cross-shareholdings` | Cross-shareholdings (annual securities reports) |
| `large-volume-shareholders` | Large volume holding reports |
> **Note**
>
> - `--edinet-code` and `--code` cannot be specified together. If all options are omitted, documents submitted on the day of the API call are returned.
> - Nested fields (`Hldrs`, `Report`, etc.) are summarized as item counts in table mode. Use `--output json` for the full data.
### fins — Financials
Retrieves financial statements, dividend information, earnings announcement dates, and financial summaries.
| Subcommand | Description |
| --------------- | -------------------------------------------------------------------------------------------------------------------- |
| `details` | Financial statements (BS / PL / CF). Use `--output json` for all fields. |
| `dividend` | Dividend information |
| `earnings-date` | Earnings announcement dates (all listed companies; exactly one of `--code` / `--date` / `--scheduled-date` required) |
| `summary` | Financial summary |
### idx — Indices
Retrieves daily data for TOPIX and other indices.
| Subcommand | Description |
| ------------- | ------------------------ |
| `daily-topix` | TOPIX daily bars |
| `daily` | Daily bars by index code |
### deriv — Derivatives
Retrieves daily data for futures and options.
| Subcommand | Description |
| ------------- | ------------------------ |
| `futures` | Futures OHLCV |
| `options` | Options OHLCV |
| `options-225` | Nikkei 225 options OHLCV |
### td — TDnet Timely Disclosure
Retrieves TDnet timely disclosure index, disclosure files, and bulk data. **Requires a TDnet add-on subscription.**
| Subcommand | Description |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list` | Timely disclosure index (specify `--date` or `--code`; `--code` covers the past 5 years, use `--from`/`--to` for a range, `--disc-items` for AND-filtering by disclosure item code) |
| `files` | Download URLs for disclosure files (PDF / XBRL). `--disc-no` required. URLs expire in 15 minutes; `--docs` filters the file type (g=full-text PDF / s=summary PDF / x=XBRL), `--download` fetches directly |
| `bulk` | Bulk CSV download URL for timely disclosures (past 5 years, gzip). URLs expire in 15 minutes; `--download` fetches directly |
### bulk — Bulk Download
Downloads data for multiple issues or long date ranges as GZ-compressed CSV files.
| Subcommand | Description |
| ---------- | --------------------------------------- |
| `list` | List of available files for download |
| `get` | Display download URLs or retrieve files |
## Shell Completion
Use `jquants completions` to generate shell completion scripts.
```bash {{ title: "Bash" }}
jquants completions bash > ~/.config/bash/completions/jquants.bash
# Add to ~/.bashrc
source ~/.config/bash/completions/jquants.bash
```
```bash {{ title: "Zsh" }}
mkdir -p ~/.zfunc
jquants completions zsh > ~/.zfunc/_jquants
# Add to ~/.zshrc
fpath=(~/.zfunc $fpath)
autoload -Uz compinit && compinit
```
```bash {{ title: "Fish" }}
jquants completions fish > ~/.config/fish/completions/jquants.fish
```
```powershell {{ title: "PowerShell" }}
jquants completions powershell | Out-File -FilePath $PROFILE -Append
```
## Common Mistakes and Solutions
| Mistake | Correct Usage | Reason |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `jquants eq daily --code 86970 --output csv` | `jquants --output csv eq daily --code 86970` | `--output` must come before the subcommand |
| `jquants --save out.csv eq daily --code 86970` | `jquants --output csv --save out.csv eq daily --code 86970` | `--save` requires `--output csv` or `json` |
| `jquants --output table --save out.txt eq daily` | `jquants --output csv --save out.csv eq daily` | `--output table` cannot be combined with `--save` |
| `jquants --output parquet eq daily --code 86970` | `jquants --output parquet --save out.parquet eq daily --code 86970` | Parquet requires `--save` |
| Data appears truncated with `jquants fins details --code 86970` | `jquants --output json fins details --code 86970` | Financial statement fields are abbreviated as 'N items' in table format; use JSON to get all data |
| Looping `eq daily --code X` for all issues | `jquants bulk get --endpoint /equities/bars/daily --date YYYY-MM --download` | Use bulk download for large data sets |
| Trying to read GZ bulk files directly | Decompress after download with `gunzip *.gz` | Bulk files are GZ-compressed |
| Running API commands without `jquants login` first | Run `jquants login` first | Missing credentials will result in an API error |
---
Source: https://jpx-jquants.com/en/spec/mcp-server
# MCP Server
J-Quants API's official MCP server is optimized for Generative AI to correctly use the J-Quants API.
By introducing the MCP Server, you can easily access J-Quants data by entrusting code generation to AI.
This guide provides steps to introduce the J-Quants official MCP Server to your AI client.
## Overall Flow
1. **Check Prerequisites**: Ensure Python 3.10 or higher and uv are installed.
2. **Install MCP Server**: Install the MCP Server using the uvx command.
3. **Configure AI Client**: Register the MCP Server in Claude Desktop or Cursor.
4. **Start Using**: Just ask the AI to get J-Quants API endpoint information and sample code.
## Prerequisites
The following environment is required to use the MCP Server.
- **Python 3.10 or higher**
- **[uv](https://github.com/astral-sh/uv)** (Recommended) or pip
> **Note**
>
> - uv is a fast Python package manager. If you haven't installed it yet, you can install it with the following command.
```bash {{ title: "macOS / Linux" }}
curl -LsSf https://astral.sh/uv/install.sh | sh
```
```bash {{ title: "Windows (PowerShell)" }}
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
## Installation
Install the MCP Server with the following command.
We recommend using `uv tool`, but you can also install it with `pip`.
```bash {{ title: "uv tool (Recommended)" }}
# Install directly from GitHub
uv tool install git+https://github.com/J-Quants/j-quants-doc-mcp.git
# Or clone locally and install
git clone https://github.com/J-Quants/j-quants-doc-mcp.git
cd j-quants-doc-mcp
uv tool install .
```
```bash {{ title: "pip" }}
# Install directly from GitHub
pip install git+https://github.com/J-Quants/j-quants-doc-mcp.git
# Or clone locally and install
git clone https://github.com/J-Quants/j-quants-doc-mcp.git
cd j-quants-doc-mcp
pip install .
```
[View GitHub Repository →](https://github.com/J-Quants/j-quants-doc-mcp)
## Configuration for AI Client
### Claude Desktop
Add the following to `claude_desktop_config.json`.
```json {{ title: "If installed with uv tool" }}
{
"mcpServers": {
"j-quants-doc-mcp": {
"command": "uvx",
"args": ["j-quants-doc-mcp"]
}
}
}
```
```json {{ title: "If installed with pip" }}
{
"mcpServers": {
"j-quants-doc-mcp": {
"command": "j-quants-doc-mcp",
"args": []
}
}
}
```
**Config File Location:**
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
### Cursor
1. Open the menu bar "Cursor" -> "Preferences" -> "Cursor Settings".
2. Select "Tools & MCP" from the left menu and click "New MCP Server".
3. Add the following to the opened JSON file (`mcp.json`).
```json {{ title: "If installed with uv tool" }}
{
"mcpServers": {
"j-quants-doc-mcp": {
"command": "uvx",
"args": ["j-quants-doc-mcp"]
}
}
}
```
```json {{ title: "If installed with pip" }}
{
"mcpServers": {
"j-quants-doc-mcp": {
"command": "j-quants-doc-mcp",
"args": []
}
}
}
```
**Config File Location:**
- macOS: `~/.cursor/mcp.json`
- Windows: `%USERPROFILE%\.cursor\mcp.json`
> **Note**
>
> - After configuration, please restart your AI client. Once the MCP Server is correctly recognized, the AI will be able to answer questions about the J-Quants API.
## Update
If you have already installed it, you can update to the latest version using the following methods.
```bash {{ title: "If using uv tool" }}
# If installed directly from GitHub
uv tool upgrade j-quants-doc-mcp
# If installed from local clone
cd j-quants-doc-mcp
git pull
uv tool upgrade j-quants-doc-mcp
```
```bash {{ title: "If using pip" }}
# If installed directly from GitHub
pip install --upgrade git+https://github.com/J-Quants/j-quants-doc-mcp.git
# If installed from local clone
cd j-quants-doc-mcp
git pull
pip install --upgrade .
```
> **Note**
>
> - After updating, restart Claude Desktop or Cursor to reflect the new version.
## Troubleshooting
### Not recognized by Claude Desktop or Cursor
1. Check if the JSON in the configuration file is in the correct format.
2. Restart the AI Client (Claude Desktop / Cursor).
### Generated code cannot be executed
To execute the generated Python code, please install the following dependencies.
```bash {{ title: "Install Dependencies" }}
pip install httpx python-dotenv
```
> **Note**
>
> - Check if the environment variables are correctly set.
---
Source: https://jpx-jquants.com/en/spec/migration-v1-v2
# 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.
> **Note**
>
> Users who registered on or after December 22, 2025 can only use V2. No migration is required.
## 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 |
```json {{ title: "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` |
---
Source: https://jpx-jquants.com/en/spec/mkt-breakdown
# Breakdown Trading Data (/markets/breakdown)
`GET` /v2/markets/breakdown
## Overview
Detail Breakdown Trading Data is extracted from daily trading values and volumes (only regular trading sessions on the TSE market) per TSE-listed issue based on flags for margin transactions and short selling that are attached to orders at the time of placement.
### Attention
> **Info**
>
> - Even in the event of a corporate action for the issue, items of volume will not be retrospectively adjusted.
> - The data for Oct, 1st 2020 does not exist because trading was halted all day due to the failure of the equity trading system.
## Get daily trading values and volumes
`GET` `https://api.jquants.com/v2/markets/breakdown`
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: – → All historical data of a specific issue.
- code: ✓, date: ✓, from /to: – → Data of a specific issue for a specific date.
- code: ✓, date: –, from /to: ✓ → Data of a specific issue for the specified period.
- code: –, date: ✓, from /to: – → All listed issue data for the specific date.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | 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. |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
| date | string | Optional | Date of data when from and to are not specified (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/markets/breakdown
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/breakdown \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/breakdown", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/breakdown",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Date | string | Required | Trade date (YYYY-MM-DD) |
| Code | string | Required | Issue code |
| LongSellVa | number | Required | Long selling trading value Breakdown of sell trading value |
| ShrtNoMrgnVa | number | Required | Trading value of short selling (excluding new margin sell) Breakdown of sell trading value |
| MrgnSellNewVa | number | Required | Trading value of new margin selling (sell orders that create new margin sell positions) Breakdown of sell trading value |
| MrgnSellCloseVa | number | Required | Trading value of closing margin selling (sell orders that close existing margin buy positions) Breakdown of sell trading value |
| LongBuyVa | number | Required | Long buying Trading value Breakdown of buy trading value |
| MrgnBuyNewVa | number | Required | Trading value of new margin buying (buy orders that create new margin buy positions) Breakdown of buy trading value |
| MrgnBuyCloseVa | number | Required | Closing margin buying (buy orders that close existing margin sell positions) Breakdown of buy trading value |
| LongSellVo | number | Required | Long selling Trading volume Breakdown of sell trading volume |
| ShrtNoMrgnVo | number | Required | Trading volume of short selling (excluding new margin selling) Breakdown of sell trading volume |
| MrgnSellNewVo | number | Required | Trading volume of new margin selling (sell orders that create new margin sell positions) Breakdown of sell trading volume |
| MrgnSellCloseVo | number | Required | Closing margin selling (sell orders that close existing margin buy positions) Trading volume Breakdown of sell trading volume |
| LongBuyVo | number | Required | Long buying Trading volume Breakdown of buy trading volume |
| MrgnBuyNewVo | number | Required | Trading volume of new margin buying (buy orders that create new margin buy positions) Breakdown of buy trading volume |
| MrgnBuyCloseVo | number | Required | Trading volume of closing margin buying (buy orders that close existing margin sell positions) Breakdown of buy trading volume |
### Sample Response
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2015-04-01",
"Code": "13010",
"LongSellVa": 115164000.0,
"ShrtNoMrgnVa": 93561000.0,
"MrgnSellNewVa": 6412000.0,
"MrgnSellCloseVa": 23009000.0,
"LongBuyVa": 185114000.0,
"MrgnBuyNewVa": 35568000.0,
"MrgnBuyCloseVa": 17464000.0,
"LongSellVo": 415000.0,
"ShrtNoMrgnVo": 337000.0,
"MrgnSellNewVo": 23000.0,
"MrgnSellCloseVo": 83000.0,
"LongBuyVo": 667000.0,
"MrgnBuyNewVo": 128000.0,
"MrgnBuyCloseVo": 63000.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/mkt-cal/holiday-division
# Holiday division
| Section | Value |
| ---------------------------------------- | ----- |
| Non-business day | 0 |
| Business day | 1 |
| Day of TSE Half-Day Trading Sessions | 2 |
| Non-business days (with holiday trading) | 3 |
---
Source: https://jpx-jquants.com/en/spec/mkt-cal
# Trading Calendar (/markets/calendar)
`GET` /v2/markets/calendar
## Overview
Information on business days and non-business days at the Tokyo Stock Exchange (TSE) and Osaka Exchange (OSE), as well as whether holiday trading is conducted at OSE, can be obtained.\
The delivered data is the same as the content published on the following pages.
- Market Holidays: [https://www.jpx.co.jp/english/corporate/about-jpx/calendar/index.html](https://www.jpx.co.jp/english/corporate/about-jpx/calendar/index.html)
- Holiday Trading: [https://www.jpx.co.jp/english/derivatives/rules/holidaytrading/index.html](https://www.jpx.co.jp/english/derivatives/rules/holidaytrading/index.html)
### Attention
> **Info**
>
> - As a rule, the business days and holiday trading days (planned) for the following year will be updated around the end of March each year.
## Get business days data
`GET` `https://api.jquants.com/v2/markets/calendar`
You can specify a holiday division (hol\_div) or date period (from/to).
### Parameter and Response
You can specify a holiday division (hol\_div) or date period (from/to).\
The combination of each parameter and the results of the response are as below.
- hol\_div: ✓, from /to: – → All data for the specified holiday division.
- hol\_div: ✓, from /to: ✓ → Data for the specified holiday division for the specified period.
- hol\_div: –, from /to: ✓ → Data for the specified period.
- hol\_div: –, from /to: – → All data.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------- |
| hol\_div | string | Optional | Holiday division For a list of possible values, please see [here](https://jpx-jquants.com/en/spec/mkt-cal/holiday-division). |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
### Sample Code
/v2/markets/calendar
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/calendar \
-H "x-api-key: {{apiKey}}" \
-d hol_div="{{hol_div}}" \
-d from="{{from}}" \
-d to="{{to}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/calendar", {
params: {
hol_div: '{{hol_div}}',
from: '{{from}}',
to: '{{to}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/calendar",
params={
"hol_div": "{{hol_div}}",
"from": "{{from}}",
"to": "{{to}}",
},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------------------------------------------------------------------- |
| Date | string | Required | Date (YYYY-MM-DD) |
| HolDiv | string | Required | Holiday division See [Holiday division](https://jpx-jquants.com/en/spec/mkt-cal/holiday-division) |
### Sample Response
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2015-04-01",
"HolDiv": "1"
}
]
}
```
---
Source: https://jpx-jquants.com/en/spec/mkt-margin-alert/margin-trading-classification
# TSE Margin Borrowing And Lending Regulation Classification
| Code | Description |
| ---- | --------------------------------------------------------------------------------------------------- |
| 001 | The stock has been selected as a restricted/precaution issue by JSF. |
| 002 | The stock has been selected as an issue subjected to daily publication by the Tokyo Stock Exchange. |
| 003 | The stock has been selected as a restricted issue by the Tokyo Stock Exchange. |
| 004 | The stock has been selected as a second-tier restricted issue by the Tokyo Stock Exchange. |
| 005 | The stock has been selected as a third-tier restricted issue by the Tokyo Stock Exchange. |
| 006 | The stock has been selected as a fourth-tier restricted issue by the Tokyo Stock Exchange. |
| 101 | The stock has been removed from the list of restricted issues by the Tokyo Stock Exchange. |
| 102 | The stock has been selected as a security on special alert by the Tokyo Stock Exchange. |
---
Source: https://jpx-jquants.com/en/spec/mkt-margin-alert
# Margin Trading Outstanding (Issues Subject to Daily Publication) (/markets/margin-alert)
`GET` /v2/markets/margin-alert
## Overview
Daily margin trading outstanding as of the last business day is available.
This data is also available via the following site but no historical data.\
[https://www.jpx.co.jp/english/markets/statistics-equities/margin/index.html](https://www.jpx.co.jp/english/markets/statistics-equities/margin/index.html)
### Attention
> **Info**
>
> - No retroactive adjustment will be made to the data that have undergone corporate action.
> - Only stocks for which the Tokyo Stock Exchange or Japan Securities Finance Co., Ltd (JSF) decide it necessary to disclose Daily margin trading outstandings are included.
> - If the past data is revised, the data is provided by this API as follows;
> - Both the data before revision and after revision are provided. When a revision occurs, a record with the same ApplicationDate is added. In such a case, data with the newer PublishedDate represents the revised data while the data with the older PublishedDate can be identified as the pre-correction data.
## Get daily margin trading outstandings
`GET` `https://api.jquants.com/v2/markets/margin-alert`
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.\
The combination of each parameter and the results of the response are as below.
- code: ✓, date: –, from /to: – → All historical data of a specific issue.
- code: ✓, date: ✓, from /to: – → Data of a specific issue for a specific published date.
- code: ✓, date: –, from /to: ✓ → Data of a specific issue for the specified period.
- code: –, date: ✓, from /to: – → All listed issue data for the specific date.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | 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. |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
| date | string | Optional | Date of data when from and to are not specified (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/markets/margin-alert
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/margin-alert \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/margin-alert", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/margin-alert",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------- |
| PubDate | string | Required | Published Date (YYYY-MM-DD) |
| Code | string | Required | Issue code |
| AppDate | string | Required | Application Date (YYYY-MM-DD) The point in time when the margin trade volume |
| PubReason | map | Required | [Publish Reason](https://jpx-jquants.com/en/spec/mkt-margin-alert/publish-reason) |
| ShrtOut | number | Required | Total short positions (negotiable + standardized) |
| ShrtOutChg | number / string | Required | Prev. day change in short positions (unit: share) If not published prev. day, set -. |
| ShrtOutRatio | number / string | Required | ShortMarginOutstanding / Listed shares × 100 (%) For ETF, set \* |
| LongOut | number | Required | Total long positions (negotiable + standardized) |
| LongOutChg | number / string | Required | Prev. day change in long positions (unit: share) If not published prev. day, set -. |
| LongOutRatio | number / string | Required | LongMarginOutstanding / Listed shares × 100 (%) For ETF, set \* |
| SLRatio | number | Required | LongMarginOutstanding / ShortMarginOutstanding × 100 (%) |
| ShrtNegOut | number | Required | Negotiable short positions Negotiable part of total short positions |
| ShrtNegOutChg | number / string | Required | Prev. day change in negotiable short positions (unit: share) If not published prev. day, set -. |
| ShrtStdOut | number | Required | Standardized short positions Standardized part of total short positions |
| ShrtStdOutChg | number / string | Required | Prev. day change in standardized short positions (unit: share) If not published prev. day, set -. |
| LongNegOut | number | Required | Negotiable long positions Negotiable part of total long positions |
| LongNegOutChg | number / string | Required | Prev. day change in negotiable long positions (unit: share) If not published prev. day, set -. |
| LongStdOut | number | Required | Standardized long positions Standardized part of total long positions |
| LongStdOutChg | number / string | Required | Prev. day change in standardized long positions (unit: share) If not published prev. day, set -. |
| TSEMrgnRegCls | string | Required | [TSE Margin Regulation Classification](https://jpx-jquants.com/en/spec/mkt-margin-alert/margin-trading-classification) |
### Sample Response
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2024-02-08",
"Code": "13260",
"AppDate": "2024-02-07",
"PubReason":
{
"Restricted": "0",
"DailyPublication": "0",
"Monitoring": "0",
"RestrictedByJSF": "0",
"PrecautionByJSF": "1",
"UnclearOrSecOnAlert": "0"
},
"ShrtOut": 11.0,
"ShrtOutChg": 0.0,
"ShrtOutRatio": "*",
"LongOut": 676.0,
"LongOutChg": -20.0,
"LongOutRatio": "*",
"SLRatio": 1.6,
"ShrtNegOut": 0.0,
"ShrtNegOutChg": 0.0,
"ShrtStdOut": 11.0,
"ShrtStdOutChg": 0.0,
"LongNegOut": 192.0,
"LongNegOutChg": -20.0,
"LongStdOut": 484.0,
"LongStdOutChg": 0.0,
"TSEMrgnRegCls": "001"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/mkt-margin-alert/publish-reason
# Publish Reason
For example, in the following cases, daily margin trading outstandings is disclosed because it has been selected as a restricted issue by the Tokyo Stock Exchange and a issue subject to restrictions on applications for the use of stocks for loan trading by Japan Securities Finance Co., Ltd (JSF).
```bash
{
"Restricted": 1,
"DailyPublication": 0,
"Monitoring": 0,
"RestrictedByJSF": 1,
"PrecautionByJSF": 0,
"UnclearOrSecOnAlert": 0
}
```
## Item Description
| Item | Description |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Restricted | In the case of 1, the stock has been selected as [a restricted issue by the Tokyo Stock Exchange](https://www.jpx.co.jp/english/markets/equities/margin-reg/index.html). If 0, not applicable. |
| DailyPublication | In the case of 1, the stock has been selected as [an issue subjected to daily publication by the Tokyo Stock Exchange](https://www.jpx.co.jp/english/markets/equities/margin-daily/index.html). If 0, not applicable. |
| Monitoring | In the case of 1, the stock has been selected as [a security on special alert by the Tokyo Stock Exchange](https://www.jpx.co.jp/english/listing/measures/alert/index.html). If 0, not applicable. |
| RestrictedByJSF | In the case of 1, the stock has been selected as [a issue subject to restrictions on applications for the use of stocks for loan trading by Japan Securities Finance Co., Ltd (JSF)](https://www.taisyaku.jp/english/restriction/). If 0, not applicable. |
| PrecautionByJSF | In the case of 1, the stock has been selected as [a issue subject to a notice for precaution for the use of stocks for loan trading by Japan Securities Finance Co., Ltd (JSF)](https://www.taisyaku.jp/english/restriction/). If 0, not applicable. |
| UnclearOrSecOnAlert | In the case of 1, the stock has been selected as [a issue subject to alert on unclear information for which Tokyo Stock Exchange deems it necessary by the Tokyo Stock Exchange](https://www.jpx.co.jp/english/markets/equities/alerts/index.html). If 0, not applicable. |
---
Source: https://jpx-jquants.com/en/spec/mkt-margin-int-daily
# Margin Trading Outstanding (Daily)
`GET` /v2/markets/margin-interest (scheduled for September 28, 2026)
## Overview
This API provides daily margin trading outstanding data, including share quantities and values, for all listed issues.
### Attention
> **Info**
>
> - This API is scheduled to be released with the updated specification on September 28, 2026.
> - Data for the previous business day is available on each business day.
> - This API provides a different dataset from [Margin Trading Outstanding (Issues Subject to Daily Publication)](https://jpx-jquants.com/en/spec/mkt-margin-alert), which covers only issues designated for daily publication.
> - Daily data is available from September 25, 2026. Earlier data remains weekly and is dated as of the last business day of each week. No data is provided for weeks with two or fewer business days, such as during the year-end and New Year holidays.
> - The value fields (ShrtVal, etc.) contain values from September 25, 2026. For earlier data, they are returned as null.
> - The published date field (PubDate) contains values from September 25, 2026. For earlier data, it is returned as null.
> - Searches by published date (published\_date) do not return historical data for which the publication date is not recorded.
> - Share-quantity fields are not adjusted retrospectively for corporate actions.
> - Securities not listed on the Tokyo Stock Exchange, including those listed exclusively on other exchanges, are not included in the data.
## Get Margin Trading Outstanding
`GET` `https://api.jquants.com/v2/markets/margin-interest` (scheduled for September 28, 2026)
Either "code", "date", or "published\_date" must be specified.
### Parameters and Responses
The available parameter combinations and their corresponding results are shown below.
- code: ✓, date: –, from /to: –, published\_date: – → All historical data for a specific issue
- code: ✓, date: ✓, from /to: –, published\_date: – → Data for a specific issue on a specific date
- code: ✓, date: –, from /to: ✓, published\_date: – → Data for a specific issue during a specified period
- code: –, date: ✓, from /to: –, published\_date: – → Data for all listed issues on a specific date
- code: –, date: –, from /to: –, published\_date: ✓ → Data for all listed issues on a specific published date
- code: ✓, date: –, from /to: –, published\_date: ✓ → Data for a specific issue on a specific published date
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API key |
### Query Parameters
> **Note**
>
> Either **code**, **date**, or **published\_date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | Issue code (e.g., 27800 or 2780) If a four-character issue code is specified for an issue that has both common and preferred shares listed, only data for the common shares is returned. |
| from | string | Optional | Start date of the requested period (e.g., 20210901 or 2021-09-01) |
| to | string | Optional | End date of the requested period (e.g., 20210907 or 2021-09-07) |
| date | string | Optional | Date to retrieve when "from" and "to" are not specified (e.g., 20210907 or 2021-09-07) |
| published\_date | string | Optional | Published date to retrieve (e.g., 20260928 or 2026-09-28) Cannot be specified together with the record-date parameters (date / from / to); doing so results in a 400 error. |
| pagination\_key | string | Optional | The primary key of the first item to be evaluated by the request. Use the pagination\_key returned by the previous request. |
### Sample Code
/v2/markets/margin-interest
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/margin-interest \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/margin-interest", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/margin-interest",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Items
| Parameter | Type | Required | Description |
| ---------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PubDate | string | Required | Published Date (YYYY-MM-DD) This field contains values from September 25, 2026. For earlier data, it is returned as null. |
| Date | string | Required | Base date of the margin trading outstanding data in YYYY-MM-DD format. |
| Code | string | Required | Issue code |
| IssType | string | Required | Issue classification 1: Margin issue, 2: Loan issue, 3: Other issue (neither a loan issue nor a margin issue) |
| ShrtVol | number | Required | Total margin trading short positions (shares) |
| LongVol | number | Required | Total margin trading long positions (shares) |
| ShrtNegVol | number | Required | Negotiable margin trading short positions (shares) The negotiable portion of total margin trading short positions. |
| LongNegVol | number | Required | Negotiable margin trading long positions (shares) The negotiable portion of total margin trading long positions. |
| ShrtStdVol | number | Required | Standardized margin trading short positions (shares) The standardized portion of total margin trading short positions. |
| LongStdVol | number | Required | Standardized margin trading long positions (shares) The standardized portion of total margin trading long positions. |
| ShrtVal | number | Required | Total margin trading short positions (value) This field contains values from September 25, 2026. For earlier data, it is returned as null. |
| LongVal | number | Required | Total margin trading long positions (value) This field contains values from September 25, 2026. For earlier data, it is returned as null. |
| ShrtNegVal | number | Required | Negotiable margin trading short positions (value) The negotiable portion of total margin trading short positions by value. This field contains values from September 25, 2026. For earlier data, it is returned as null. |
| LongNegVal | number | Required | Negotiable margin trading long positions (value) The negotiable portion of total margin trading long positions by value. This field contains values from September 25, 2026. For earlier data, it is returned as null. |
| ShrtStdVal | number | Required | Standardized margin trading short positions (value) The standardized portion of total margin trading short positions by value. This field contains values from September 25, 2026. For earlier data, it is returned as null. |
| LongStdVal | number | Required | Standardized margin trading long positions (value) The standardized portion of total margin trading long positions by value. This field contains values from September 25, 2026. For earlier data, it is returned as null. |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"PubDate": "2026-09-28",
"Date": "2026-09-25",
"Code": "86970",
"IssType": "2",
"ShrtVol": 257400.0,
"LongVol": 225000.0,
"ShrtNegVol": 242800.0,
"LongNegVol": 81900.0,
"ShrtStdVol": 14600.0,
"LongStdVol": 143100.0,
"ShrtVal": 514800000.0,
"LongVal": 450000000.0,
"ShrtNegVal": 485600000.0,
"LongNegVal": 163800000.0,
"ShrtStdVal": 29200000.0,
"LongStdVal": 286200000.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/mkt-margin-int
# Margin Trading Outstandings (/markets/margin-interest)
`GET` /v2/markets/margin-interest
## Overview
Weekly margin trading outstandings (number of shares) as of the last business day of each week is available.
This data is also available via the following site.\
[https://www.jpx.co.jp/english/markets/statistics-equities/margin/index.html](https://www.jpx.co.jp/english/markets/statistics-equities/margin/index.html)
### Attention
> **Info**
>
> - This API is scheduled to be updated to a new specification on September 28, 2026. See [the new specification](https://jpx-jquants.com/en/spec/mkt-margin-int-daily) for details.
> - Even in the event of a corporate action for the issue, items of trading volume will not be retrospectively adjusted.
> - No data is provided for weeks with two or fewer business days like New Year's holiday.
> - Stocks that are not listed on the TSE (including issue listed only on the other exchanges) are not included in the data.
## Get weekly margin trading outstandings
`GET` `https://api.jquants.com/v2/markets/margin-interest`
Either "code" or "date" must be specified.
### Parameter and Response
Either "code" or "date" must be specified.\
Combination of parameter in the request and results are as below.
- code: ✓, date: –, from /to: – → All historical data of a specific issue.
- code: ✓, date: ✓, from /to: – → Data of a specific issue for the specific date.
- code: ✓, date: –, from /to: ✓ → Data of a specific issue for the specified period.
- code: –, date: ✓, from /to: – → All listed issue data for the specific date.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **code** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | Optional | 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. |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
| date | string | Optional | Date when "from" and "to" are not specified (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/markets/margin-interest
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/margin-interest \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/margin-interest", {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/margin-interest",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ---------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------- |
| Date | string | Required | Record date Base date of margin trading outstandings(usually on Friday) (YYYY-MM-DD) |
| Code | string | Required | Issue code |
| ShrtVol | number | Required | Total margin trading weekend short positions |
| LongVol | number | Required | Total margin trading weekend long positions |
| ShrtNegVol | number | Required | Negotiable margin trading weekend short positions Negotiable part of the total margin trading weekend short positions. |
| LongNegVol | number | Required | Negotiable margin trading weekend long positions Negotiable part of the total margin trading weekend long positions. |
| ShrtStdVol | number | Required | Standardized margin trading weekend short positions Standardized part of the total margin trading weekend short positions. |
| LongStdVol | number | Required | Standardized margin positions weekend long positions Standardized part of the total margin trading weekend long positions. |
| IssType | string | Required | Issue Classifications 1: Margin issues, 2: Loan issues, 3: Other issues (non-loan, non-margin) |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2023-03-24",
"Code": "86970",
"ShrtVol": 123456.0,
"LongVol": 234567.0,
"ShrtNegVol": 11111.0,
"LongNegVol": 22222.0,
"ShrtStdVol": 33333.0,
"LongStdVol": 44444.0,
"IssType": "1"
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/mkt-short-ratio
# Short Sale Value and Ratio by Sector (/markets/short-ratio)
`GET` /v2/markets/short-ratio
## Overview
You can obtain daily short sale trading values by industry (sector).\
This data is also available via the following site.\
[https://www.jpx.co.jp/english/markets/statistics-equities/short-selling/index.html](https://www.jpx.co.jp/english/markets/statistics-equities/short-selling/index.html) \
The published values on the web page are rounded to million yen, but this API provides data in yen.
### Attention
> **Info**
>
> - If a date is specified for which no trading volume exists (no sale), the value will be empty.
> - The data for Oct, 1st 2020 does not exist because trading was halted all day due to the failure of the equity trading system.
## Get daily short sale trading values by sector
`GET` `https://api.jquants.com/v2/markets/short-ratio`
When acquiring data, either "date" or "s33" (33-sector code) must be specified.
### Parameter and Response
When acquiring data, either "date" or "s33" (33-sector code) must be specified.\
The combination of each parameter and the results of the response are as below.
- s33: –, date: ✓, from/to: – → Short sale data of all sectors for the specified day.
- s33: ✓, date: –, from/to: – → Short sale data of the specified sector for all historical period.
- s33: ✓, date: –, from/to: ✓ → Short sale data of the specified sector for the specified period.
- s33: ✓, date: ✓, from/to: – → Short sale data of the specified sector for the specified day.
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **s33** or **date** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| s33 | string | Optional | 33-sector code (e.g. 0050 or 50) |
| from | string | Optional | Starting point of data period (e.g. 20210901 or 2021-09-01) |
| to | string | Optional | End point of data period (e.g. 20210907 or 2021-09-07) |
| date | string | Optional | When "from" and "to" are not specified (e.g. 20210907 or 2021-09-07) |
| pagination\_key | string | Optional | 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
/v2/markets/short-ratio
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/short-ratio \
-H "x-api-key: {{apiKey}}" \
-d s33="{{s33}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/short-ratio", {
params: {
s33: '{{s33}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/short-ratio",
params={"s33": "{{s33}}", "date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ------------- | ------ | -------- | ------------------------------------------------------------------------------- |
| Date | string | Required | Date (YYYY-MM-DD) |
| S33 | string | Required | 33-sector code (See [33-sector code and name](https://jpx-jquants.com/en/spec/eq-master/sector33code)) |
| SellExShortVa | number | Required | Trading value of long selling |
| ShrtWithResVa | number | Required | Value of short sales with price restrictions |
| ShrtNoResVa | number | Required | Value of short sales without price restrictions |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"Date": "2022-10-25",
"S33": "0050",
"SellExShortVa": 1333126400.0,
"ShrtWithResVa": 787355200.0,
"ShrtNoResVa": 149084300.0
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/mkt-short-sale
# Outstanding Short Selling Positions Reported (/markets/short-sale-report)
`GET` /v2/markets/short-sale-report
## Overview
This data covers the outstanding short selling position ratio is 0.5% or more of those reported by trading participants in accordance with the "Cabinet Office Order on Restrictions on Securities Transactions".
This data is the same as the following site but has a longer history.\
[https://www.jpx.co.jp/english/markets/public/short-selling/index.html](https://www.jpx.co.jp/english/markets/public/short-selling/index.html)
### Attention
> **Info**
>
> - Data will not be provided on days when no applicable reports are made by trading participants.
> - Please click here for the "Cabinet Office Order on Restrictions on Securities Transactions": [https://www.jpx.co.jp/english/markets/public/short-selling/01.html](https://www.jpx.co.jp/english/markets/public/short-selling/01.html)
## Get Outstanding Short Selling Positions Reported
`GET` `https://api.jquants.com/v2/markets/short-sale-report`
In your request message, either "code", "disc\_date" or "calc\_date" must be specified.
### Parameter and Response
In your request message, either "code", "disc\_date" or "calc\_date" must be specified.\
The combination of each parameter and the results of the response are as below.
- code: ✓, disc\_date: –, disc\_date\_from/disc\_date\_to: –, calc\_date: – → All historical data of a specific issue.
- code: ✓, disc\_date: ✓, disc\_date\_from/disc\_date\_to: –, calc\_date: – → Data of a specific issue for the specific date (DisclosedDate).
- code: ✓, disc\_date: –, disc\_date\_from/disc\_date\_to: ✓, calc\_date: – → Data of a specific issue for the specified period.
- code: ✓, disc\_date: –, disc\_date\_from/disc\_date\_to: –, calc\_date: ✓ → Data of a specific issue for the specific date (CalculatedDate).
- code: –, disc\_date: ✓, disc\_date\_from/disc\_date\_to: –, calc\_date: – → Data for all listed issues on the specified date (DisclosedDate).
- code: –, disc\_date: –, disc\_date\_from/disc\_date\_to: –, calc\_date: ✓ → Data for all listed issues on the specified date (CalculatedDate).
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> At least one of **code** / **disc\_date** / **calc\_date** must be specified.
| Parameter | Type | Required | Description |
| ---------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| code | string | Optional | 4 or 5 character issue code (e.g. 8697 or 86970) 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. |
| disc\_date | string | Optional | Date of Disclosure (e.g. 20240301 or 2024-03-01) |
| disc\_date\_from | string | Optional | Starting point of data period (e.g. 20240301 or 2024-03-01) |
| disc\_date\_to | string | Optional | End point of data period (e.g. 20240301 or 2024-03-01) |
| calc\_date | string | Optional | Date of Calculation (e.g. 20240301 or 2024-03-01) |
| pagination\_key | string | Optional | 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
/v2/markets/short-sale-report
**cURL**
```bash
curl -G https://api.jquants.com/v2/markets/short-sale-report \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d calc_date="{{calc_date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})
await client.get("/v2/markets/short-sale-report", {
params: {
code: '{{code}}',
calc_date: '{{calc_date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/markets/short-sale-report",
params={"code": "{{code}}", "calc_date": "{{calc_date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| DiscDate | string | Required | Date of Disclosure (YYYY-MM-DD) |
| CalcDate | string | Required | Date of Calculation (YYYY-MM-DD) |
| Code | string | Required | Issue code (5-character) |
| SSName | string | Required | Name of Short Seller The value is listed as reported by market participants, so both Japanese and English names are mixed. Please note that "個人" refers to individual investor. |
| SSAddr | string | Required | Address of Short Seller |
| DICName | string | Required | Name of Discretionary Investment Contractor |
| DICAddr | string | Required | Address of Discretionary Investment Contractor |
| FundName | string | Required | Name of Investment Fund |
| ShrtPosToSO | number | Required | Ratio of Short Positions to Shares Outstanding |
| ShrtPosShares | number | Required | Number of Short Positions in Shares |
| ShrtPosUnits | number | Required | Number of Short Positions in Trading Units |
| PrevRptDate | string | Required | Date of Calculation in Previous Reporting (YYYY-MM-DD) |
| PrevRptRatio | number | Required | Ratio of Short Positions in Previous Reporting |
| Notes | string | Required | Notes |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"DiscDate": "2024-08-01",
"CalcDate": "2024-07-31",
"Code": "13660",
"SSName": "個人",
"SSAddr": "",
"DICName": "",
"DICAddr": "",
"FundName": "",
"ShrtPosToSO": 0.0053,
"ShrtPosShares": 140000,
"ShrtPosUnits": 140000,
"PrevRptDate": "2024-07-22",
"PrevRptRatio": 0.0043,
"Notes": ""
}
],
"pagination_key": "value1.value2."
}
```
---
Source: https://jpx-jquants.com/en/spec/pagination
# Response Pagination
When an API response becomes large, a `pagination_key` may be set in the response. If a `pagination_key` is set, you can retrieve subsequent data by executing a request with the `pagination_key` set in the next query without changing the search conditions. Please refer to the sample code for each API for the response format.
/v2/method
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
r_get = requests.get(
"https://api.jquants.com/v2/method?query=param",
headers=headers,
)
data = r_get.json()["data"]
while "pagination_key" in r_get.json():
pagination_key = r_get.json()["pagination_key"]
r_get = requests.get(
f"https://api.jquants.com/v2/method?query=param&pagination_key={pagination_key}",
headers=headers,
)
data += r_get.json()["data"]
```
- The `pagination_key` will be set in the response message until all matching data for the query is returned. If the `pagination_key` is not set in the response message, it means that all matching data for the query has been returned.
- The value of `pagination_key` changes each time pagination occurs.
- No field returning the total number of records is provided. To retrieve all data, repeat requests until the `pagination_key` is no longer returned.
- If the data is updated while paginating, full consistency across the retrieved results is not guaranteed.
---
Source: https://jpx-jquants.com/en/spec/quickstart
# Quickstart
An overview of how to start using J-Quants API and what the experience looks like once you begin.
## Overall Flow
1. Register as a user on the [J-Quants Website](https://jpx-jquants.com/register) (free).
2. Choose a subscription plan. You can start with the free plan.
3. After signing in, the [Quick Start Guide](https://jpx-jquants.com/dashboard/quickstart) on your dashboard walks you through the way that suits you, step by step.
> **Note**
>
> To use the API, you need to register for one of the subscription plans, including the Free plan. For differences between user registration and subscription plans, please refer to the
> [FAQ](https://jpx-jquants.com/help/plan).
## Three Ways to Get Started
| Option | Best for |
| ------------------------------------------------------- | ------------------------------------------------------------------- |
| Work with your AI (recommended) | You already use AI tools such as Claude or ChatGPT |
| Write code in Colab | You want to learn the API by writing Python |
| Download files from your browser (Light plan or higher) | You want CSV files from the screen to use in Excel or similar tools |
The [Quick Start Guide](https://jpx-jquants.com/dashboard/quickstart) on your dashboard walks you through each of these after signing in. Here is what each experience looks like.
### Work with your AI (recommended)
After a few setup commands, just ask an AI tool such as Claude or ChatGPT in plain language.
```text {{ title: "Example request to the AI (Light plan or higher)" }}
Using the J-Quants CLI, download the last 5 years of stock price data into
~/jquants-data, and set it up so the latest data is saved automatically every evening.
```
Data accumulates locally every day, and you can ask questions of your own data in plain language — "Which stocks saw a volume spike yesterday?" or "How do prices tend to move the day after earnings?"
### Write code in Colab
A Python notebook that requires no setup, letting you learn while calling the API directly.
[](https://colab.research.google.com/github/J-Quants/jquants-api-quick-start/blob/master/jquants-api-quick-start-v2-en.ipynb)
### Download files from your browser (Light plan or higher)
No installation needed. Download CSV files from the dashboard's Downloads screen and use them directly in Excel or similar tools.
## What Each Plan Offers
The available data types and periods depend on your plan.
- [Data specifications and coverage](https://jpx-jquants.com/spec/data-spec)
- [Pricing plans](https://jpx-jquants.com/en/#pricing)
## For Developers Calling the API Directly
You can call the API over HTTP from your own programs. Issue your API key from the **\[API Keys]** screen in the dashboard (not needed if you use the CLI's `jquants login`, which issues one automatically).
/v2/equities/bars/daily
**cURL**
```bash
curl -G https://api.jquants.com/v2/equities/bars/daily \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/equities/bars/daily', {
params: {
code: '{{code}}',
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/equities/bars/daily",
params={"code": "{{code}}", "date": "{{date}}"},
headers=headers,
)
```
See details of Stock Prices (OHLC)
---
Source: https://jpx-jquants.com/en/spec/rate-limits
# Rate Limits
J-Quants API has rate limits (usage frequency restrictions) in place to ensure stable service operation.\
If you send requests exceeding the limit within a certain period, API usage will be temporarily restricted.
## Rate Limits by Plan
The maximum number of requests per minute varies depending on your subscription plan.
| Plan | Limit (Requests / min) |
| :----------- | :--------------------- |
| **Free** | 5 |
| **Light** | 60 |
| **Standard** | 120 |
| **Premium** | 500 |
※ The above are the basic limit values and may be adjusted depending on system conditions.
## Rate Limits by Endpoint
For the following endpoints, individual limits apply regardless of your plan.
| Endpoint | Limit (Requests / min) |
| :----------------------------------------------------------- | :--------------------- |
| **Financial Data (Summary only)** (`/v2/fins/summary`) | 60 |
| **Financial Statement Data (BS/PL/CF)** (`/v2/fins/details`) | 60 |
## Rate Limits for Add-on
If you have an add-on subscription, separate rate limits apply to add-on-specific APIs.
| Add-on | Limit (Requests / min) |
| :----------------------------------- | :--------------------- |
| **Stock Prices (minute-OHLC, Tick)** | 60 |
| **TDnet/Company Disclosure** | 100 |
※ Add-on-specific APIs have limits independent of plan rate limits.
## When Limits Are Exceeded
If you make requests exceeding the rate limit, the API will return HTTP status code `429 Too Many Requests`.
### Temporary Access Restriction
If you **significantly exceed** the rate limit and continue making requests, access may be completely blocked for approximately 5 minutes.\
During this time, all requests will result in errors, so it is recommended to implement controls such as retrying with appropriate intervals on the application side.
## Best Practices
- **Efficient Data Retrieval**:
- Use query parameters to retrieve only the necessary data and reduce unnecessary requests.
- Many APIs allow you to retrieve data for all issues by specifying only the date. Avoid retrieving data for one issue at a time across all dates.
- Please use the [file download feature](https://jpx-jquants.com/en/spec/bulk) for bulk retrieval of historical data.
- **Error Handling**: If status code `429` is returned, do not retry immediately, but wait for a certain period before resuming requests.
---
Source: https://jpx-jquants.com/en/spec/release
# Releases
## 2026
**Sep 14, 2026** \[New Feature] \[Update]
### Release of the Valuation Indicators API
- The [Valuation Indicators API](https://jpx-jquants.com/en/spec/eq-valuation), which delivers daily valuation indicators calculated from financial statement disclosures and share prices, is now available. It can be used on all plans.
- Eight indicators are provided: EPS, FwdEPS, BPS, ROE, FwdROE, PER, FwdPER and PBR. Actual figures are based on trailing twelve months (TTM) net income, and forward figures are based on the company's forecast of net income for the current fiscal year.
- Market capitalization (`MktCap`, in millions of JPY) is also recorded. It is calculated as the share price multiplied by the share count excluding treasury shares, so its value may not match market capitalization in the [Daily Stock Prices (OHLC)](https://jpx-jquants.com/en/spec/eq-bars-daily) API, which uses a share count that includes treasury shares.
- File download (CSV download / Bulk API) is also supported for the Light plan and above.
### \[Advance Notice] Market capitalization (`MktCap`) will be removed from the Daily Stock Prices (OHLC) API
- Market capitalization in the [Valuation Indicators API](https://jpx-jquants.com/en/spec/eq-valuation) is calculated using a share count that excludes treasury shares.
- Accordingly, market capitalization (`MktCap`) in the response of the [Daily Stock Prices (OHLC)](https://jpx-jquants.com/en/spec/eq-bars-daily) API, which is calculated with a share count that includes treasury shares, is scheduled to be removed. We will announce the removal date once it has been decided.
- Market capitalization is provided by the [Valuation Indicators API](https://jpx-jquants.com/en/spec/eq-valuation), so please consider switching your reference. Note that the two APIs define the share count differently, so the values may not match.
### Added amendment report data to the Large Volume Holding Reports (EDINET) API, with the document management number of the amended document and the reporting obligation date as response fields
- Amendment Reports (document type code `360`) have been added to the [Large Volume Holding Reports (EDINET) API](https://jpx-jquants.com/en/spec/edinet-large-volume-shareholders) data.
- An Amendment Report does not replace the document it amends; it is added as a separate record.
- The document management number of the document being amended (`ParDocId`) was added to the response fields. Amendment Report (`6`) was added to the report type code (`LargeHldgTypeCode`).
- The reporting obligation date (`RptOblgDate`) was added to the response fields.
**Aug 24, 2026** \[Update]
### \[Advance Notice] Margin Trading Outstanding API to be upgraded to daily delivery with new value fields (September 28, 2026)
- On September 28, 2026, the [Margin Trading Outstandings API](https://jpx-jquants.com/en/spec/mkt-margin-int) will be upgraded from weekly to daily data delivery. Data for the previous business day will be available on each business day.
- Daily data will be available from September 25, 2026. Earlier data remains weekly and is dated as of the last business day of each week.
- Six value fields ("ShrtVal", "LongVal", "ShrtNegVal", "LongNegVal", "ShrtStdVal", and "LongStdVal") will be added to the response.
- These fields will contain values from September 25, 2026. For earlier data, they will be returned as null. Please ensure that your implementation handles null appropriately.
- The published date field ("PubDate") will be added to the response as the first field. In addition, you will be able to search data by published date (published\_date).
- The published date contains values from September 25, 2026. For earlier data, the key is present but the value is null, so please handle null appropriately.
- The order of the response fields will change: "IssType" (issue classification) will appear immediately after "Code". Implementations should not rely on the order of fields in a JSON response.
- For details, see [Margin Trading Outstanding (Daily)](https://jpx-jquants.com/en/spec/mkt-margin-int-daily).
**Aug 17, 2026** \[Update]
### Added semiannual and quarterly report data to the Major Shareholders (EDINET) API, with the current accounting period start and end dates as response fields
- Semiannual and quarterly reports have been added to the [Major Shareholders (EDINET) API](https://jpx-jquants.com/en/spec/edinet-major-shareholders) data.
- The following two fields were added to the response.
- `CurPerSt` (start date of the current accounting period)
- `CurPerEn` (end date of the current accounting period)
**Aug 10, 2026** \[Update]
### Added market capitalization and ex-rights type to Daily Stock Prices (OHLC)
- We added market capitalization (`MktCap`) and ex-rights type (`ExRT`) to the response of the [Daily Stock Prices (OHLC)](https://jpx-jquants.com/en/spec/eq-bars-daily) API. Available for all plans.
- Market capitalization is calculated as "close price (before adjustment) × number of listed shares" and recorded in millions of JPY (rounded to the nearest million).
- Ex-rights type is a code indicating the corporate action type on the ex-rights date (`1`: Stock split, `2`: Reverse stock split, `3`: Rights issue). Null is recorded on days with no applicable corporate action.
**Aug 3, 2026** \[New Feature] \[Update]
### Release of Earnings Announcement Dates API
- We released the [Earnings Announcement Dates API](https://jpx-jquants.com/en/spec/fin-earnings-date), available for all plans.
- You can retrieve the earnings announcement dates that listed companies have reported to the Tokyo Stock Exchange.
- You can search by issue code, publication date, or scheduled announcement date. Note that when searching by scheduled announcement date, if a previously reported date has been revised, only the currently effective date is returned.
- The Free plan is subject to a 12-week delay (with 2 years of history); the Light plan and above provide history according to the plan (5 / 10 / 20 years).
- File download (CSV download / Bulk API) is also supported for the Light plan and above.
- In addition, the existing API that provides only the next business day's announcements has been renamed to [Earnings Calendar (March/September fiscal year-end only)](https://jpx-jquants.com/en/spec/eq-earnings-cal) (no changes to its functionality or response).
### Added Shareholders' Equity and ROE to the Financial Data API
- We added Shareholders' Equity (consolidated: "ShEq", non-consolidated: "NCShEq") and Return on Equity (consolidated: "ROE", non-consolidated: "NCROE") to the response of the [Financial Data API](https://jpx-jquants.com/en/spec/fin-summary), available for all plans.
- There are no changes to the existing response items or behavior.
**Jul 13, 2026** \[New Feature]
### Release of Large Volume Holding Reports (EDINET) API
- We released the [Large Volume Holding Reports (EDINET) API](https://jpx-jquants.com/en/spec/edinet-large-volume-shareholders), available for the Standard and Premium plans.
- From Large Volume Holding Reports and their Change Reports (document type code 350) submitted to EDINET, you can retrieve, per filer and joint holder, the number of share certificates held, the holding ratio, the breakdown of acquisition funds, and acquisitions / disposals during the last 60 days.
- You can search by the issuer's EDINET code, issue code, and submission date.
- This API does not support file download (CSV download / Bulk API).
**Jul 6, 2026** \[New Feature]
### Release of Major Shareholders & Cross-Shareholdings (EDINET) APIs
- We released the [Major Shareholders (EDINET) API](https://jpx-jquants.com/en/spec/edinet-major-shareholders), available for the Standard and Premium plans.
- From the "Status of Major Shareholders" section of the Annual Securities Report, you can retrieve each shareholder's name, address, shares held, and holding ratio.
- We also released the [Cross-Shareholdings (EDINET) API](https://jpx-jquants.com/en/spec/edinet-cross-shareholdings), available for the Standard and Premium plans.
- From "Section 4: Status of Shares" of the Annual Securities Report, you can retrieve, per scope (the reporting company itself and the consolidated group companies with the largest / second-largest holdings), listed / non-listed share counts and their changes, the specified investment / deemed holding records, and footnote text.
- Each issue in the specified investment / deemed holding records is annotated with EdinetCode and SecCode.
- These APIs do not support file download (CSV download / Bulk API).
**Jun 29, 2026** \[Update] \[Fix]
### Rights issues added to price adjustment for Stock Prices (OHLC)
- In addition to stock splits and reverse stock splits, "rights issues" have been newly added to the price adjustment targets of [Stock Prices (OHLC)](https://jpx-jquants.com/en/spec/eq-bars-daily).
- Accordingly, adjusted prices and trading volumes that were not correctly adjusted for past rights issues have been corrected. For some issues, past adjusted values will change.
- Corrected issues (codes): 17730, 33180, 37500, 38320, 38560, 45410, 57210, 63970, 69930, 77780, 94780
**Jun 8, 2026** \[New Feature]
### Financial Data APIs upgraded to near real-time updates (Premium plan API only)
- For Premium plan users, the [Financial Data (Summary only)](https://jpx-jquants.com/en/spec/fin-summary) and [Financial Statement Data (BS/PL/CF)](https://jpx-jquants.com/en/spec/fin-details) APIs have been upgraded to near real-time updates. (CSV updates remain twice daily.)
- After calling the API with `date` set to today, you can pass the `cursor` from the response in the next request to retrieve only data published since the previous call.
- For details, see [Retrieving Differential Data Using Cursor](https://jpx-jquants.com/en/spec/cursor).
**May 26, 2026** \[New Feature] \[Update]
### Product category added to Listed Issue Master
- The product category field (ProdCat) has been added to the [Listed Issue Master](https://jpx-jquants.com/en/spec/eq-master) response.
- This enables filtering by product types such as ETF and REIT.
- For details, see [Product category codes and names](https://jpx-jquants.com/en/spec/eq-master/product-category).
**May 18, 2026** \[New Feature]
### TDnet/Company Disclosure now available
- The TDnet/Company Disclosure add-on has been added. You can now access company disclosure information via the following APIs:
- [TDnet/Company Disclosure Index List](https://jpx-jquants.com/en/spec/td-list)
- [TDnet/Company Disclosure Files](https://jpx-jquants.com/en/spec/td-files)
- [TDnet/Company Disclosure Index CSV Download](https://jpx-jquants.com/en/spec/td-bulk)
**Apr 13, 2026** \[New Feature]
### Expanded coverage for Futures (OHLC)
- You can now retrieve the following futures via [Futures (OHLC)](https://jpx-jquants.com/en/spec/drv-bars-daily-fut):
- USD/JPY Futures
- CNH/JPY Futures
- EUR/JPY Futures
- For details, see [Futures Product Category Codes](https://jpx-jquants.com/en/spec/drv-bars-daily-fut/derivative-product-category)
### J-Quants CLI tool released
- The CLI tool `jquants` has been released for retrieving Japanese stock market data via J-Quants API V2.
- Install via Homebrew or download pre-built binaries.
- For details, see [J-Quants CLI](https://jpx-jquants.com/en/spec/jquants-cli).
**Apr 6, 2026** \[New Feature]
### Expanded coverage for Indices (OHLC)
- You can now retrieve the following indices via [Indices (OHLC)](https://jpx-jquants.com/en/spec/idx-bars-daily):
- Dividend-included indices
- JPX Start-Up Acceleration 100 Index
- For details, see [Index Codes](https://jpx-jquants.com/en/spec/idx-bars-daily/indexcodes).
**Mar 30, 2026** \[New Feature]
### Trading Calendar available via file download
- Trading Calendar data can now be retrieved via file download (Bulk API).
- The `/markets/calendar` endpoint has been added to the [List of Downloadable Files API](https://jpx-jquants.com/en/spec/bulk-list). You can download the data as a CSV file by specifying `/markets/calendar` as the endpoint in the [File Download URL API](https://jpx-jquants.com/en/spec/bulk-get).
**Mar 9, 2026** \[New Feature] \[Update]
### Download files for the latest date
- You can now download data updated on a given day from a single screen, making it easy to retrieve daily files without using the API.
- After signing in, try downloading various data from [Quick DL for Latest](https://jpx-jquants.com/en/dashboard/downloads/quick).
- A date query parameter has been added to the [List of Downloadable Files API](https://jpx-jquants.com/en/spec/bulk-list). You can now retrieve data updated on a given day from the API in a single request.
**Feb 9, 2026** \[New Feature]
A button has been added to the API specification page that allows you to view pages in Markdown format.
**Jan 23, 2026** \[Fix]
[Data correction history](https://jpx-jquants.com/en/spec/fix-data-info) has been updated.
**Jan 19, 2026** \[New Feature]
Stock price minute bar and tick data are now available. CSV file downloads are also now available for other datasets for Light plan and above.
## 2025
**Dec 22, 2025** \[Update]
We have updated our landing page and the post-login dashboard. You can continue to use your existing email address and password. Please [sign in here](https://jpx-jquants.com/login). The API usage has been updated. For more details, please see [Changes from V1 API to V2 API](https://jpx-jquants.com/en/spec/migration-v1-v2).
**Oct 17, 2025** \[New Feature]
Cash flow statements have been added to the [Financial Statements](https://jpx-jquants.com/en/spec/fin-details) dataset.
**Aug 22, 2025** \[New Feature]
New API has been released to retrieve Margin Trading Outstanding (Issues Subject to Daily Publication) data available under the standard and premium plan.
**Jul 18, 2025** \[Update]
The Update Timing of Provided Data in the Cash Dividend Data has been corrected.
**May 30, 2025** \[New Feature]
New API has been released to retrieve the outstanding short selling positions reported data available under the standard and premium plan.
**May 2, 2025** \[Fix]
Data correction history has been updated.
**Jan 27, 2025** \[Update]
More details have been added to the API overview of Listed Issue Information. The Update Timing of Provided Data in the Listed Issue Information, Stock Prices (OHLC), Indices (OHLC), TOPIX Prices (OHLC), and Short Sale Value and Ratio by Sector has been corrected.
## 2024
**Dec 3, 2024** \[Update]
Data refreshes timing in error corrections of Trading by Type of Investors has been updated.
**Nov 5, 2024** \[Update]
The Update Timing of Provided Data in the Stock Prices (OHLC), Indices (OHLC), TOPIX Prices (OHLC), and Short Sale Value and Ratio by Sector has been corrected.
**Sep 20, 2024** \[Fix]
Data correction history has been updated.
**Aug 26, 2024** \[Update]
Known issues and restrictions is updated.
**Aug 20, 2024** \[Update]
Attention of Earnings Calendar has been updated.
**Aug 16, 2024** \[New Feature]
New API has been released to retrieve prices (OHLC) on futures and options available under the premium plan.
**Aug 2, 2024** \[Fix]
Data correction history has been updated.
**Jul 22, 2024** \[Update]
In response to the "Revision of the Quarterly Disclosure System", the item "SignificantChangesInTheScopeOfConsolidation" is added to the [Financial Data API](https://jpx-jquants.com/en/spec/fin-summary).
**Jun 17, 2024** \[Fix]
Data correction history has been updated.
**Mar 28, 2024** \[New Feature]
Indices by industry and market have been added to the Indices (OHLC). The [Update Timing of Provided Data](https://jpx-jquants.com/en/spec/data-update) in the Trading Calendar has been corrected.
**Feb 28, 2024** \[Fix]
Data correction history has been updated.
## 2023
**Dec 20, 2023** \[New Feature]
A new API (/indices) has been released to retrieve various indices available in the Standard and Premium plans.
**Nov 28, 2023** \[Fix]
An omission of AfternoonTurnoverValue in data item list of the API specification for stock prices (OHLC) has been fixed.
**Nov 7, 2023** \[Fix]
Data correction history has been updated.
**Oct 27, 2023** \[Update]
The response from the API is changed to Gzip. Some action may be required on the client side depending on the usage pattern. Please refer to [this page](https://jpx-jquants.com/en/spec/gzip-compression).
**Sep 22, 2023** \[Fix]
Data correction history has been updated.
**Aug 29, 2023** \[Fix]
The [Available APIs and Data Periods per Plan](https://jpx-jquants.com/en/spec/data-spec) in the financial statements (BS/PL/CF) has been corrected.
**Aug 28, 2023** \[New Feature]
New API has been released to retrieve detailed information on financial statements available under the premium plan.
**Jun 30, 2023** \[New Feature]
MarginCode available for standard and premium plan have been added to the Listed Issue Information.
**Jun 16, 2023** \[New Feature]
Flags of upper price limit and lower price limit have been added to the Stock Prices (OHLC). Due to this change, paging of responses may be required. Please refer to [this page](https://jpx-jquants.com/en/spec/pagination) for details on paging of responses.
**Jun 12, 2023** \[Update]
Future release schedule is updated. Please note that we are planning to restrict the use of the Stock Prices API due to maintenance work on June 16.
**Jun 9, 2023** \[Update]
Known issues and restrictions is updated.
**May 12, 2023** \[Update]
Future release schedule is updated.
**May 8, 2023** \[New Feature]
New API has been released to retrieve business day calendar.
**Apr 27, 2023** \[New Feature]
Paging functionality has been released. The future release schedule has been updated. Please note that API usage will be restricted on May 10 due to our maintenance.
**Apr 3, 2023** \[Important]
The paid version has been officially released.
---
Source: https://jpx-jquants.com/en/spec/response-status
# Response Status
The result of requests to J-Quants API is indicated by HTTP status codes.
If the request is successful, `200` is returned, and if an error occurs, error codes in the `400` or `500` range are returned.
The error response Body may contain a JSON object with error details.
## Status Code List
| Status Code | Name | Description |
| :---------- | :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **200** | OK | The request was successful. |
| **210** | No Content (Partial) | Data could not be retrieved due to reasons such as being outside the available time window or non-existent issue codes (used in some APIs such as the Morning Session Stock Prices (OHLC) API). |
| **400** | Bad Request | Request parameters are invalid or required parameters are missing. |
| **403** | Forbidden | Access permission is denied. This may occur when accessing data not included in your subscription plan. Status code 403 is also returned when an incorrect API key is configured or an incorrect resource path is specified. |
| **429** | Too Many Requests | The number of requests exceeded the limit (rate limit). Please wait for a certain period before retrying. |
| **500** | Internal Server Error | An error occurred on the server. Please retry after some time. |
## When No Matching Data Exists
If no data matches the specified search conditions, the API does not return an error. A response with status code `200` and an empty array in `data` is returned.
```json
{
"data": []
}
```
## Example Error Message
When an error occurs, details are returned in JSON format as shown below.
```json
{
"message": "This API requires at least 1 parameter as follows; date, code"
}
```
---
Source: https://jpx-jquants.com/en/spec/td-bulk
# TDnet/Company Disclosure Index CSV Download (/td/bulk)
`GET` /v2/td/bulk
## Overview
You can retrieve the download URL and last updated timestamp for a CSV file (gzip compressed) containing the past 5 years of timely disclosure index information.\
Use the returned URL to download the CSV file. URLs expire in 15 minutes.
### Attention
> **Info**
>
> - This API requires the TimelyDisclosure add-on.
> - The CSV contains disclosure data for the past 5 years.
> - download URLs expire in 15 minutes.
> - The CSV file is gzip compressed.
> - No webhook is provided to notify you of file updates.
## Retrieve TDnet/Company Disclosure Index CSV Download URL
`GET` `https://api.jquants.com/v2/td/bulk`
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
No query parameters.
### Sample Code
/v2/td/bulk
**cURL**
```bash
curl -G https://api.jquants.com/v2/td/bulk \
-H "x-api-key: {{apiKey}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/td/bulk')
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/td/bulk",
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ----------- | ------ | -------- | ---------------------------------------------------------------------------- |
| lastUpdated | string | Required | Last updated timestamp of the CSV file (ISO 8601, e.g. 2025-04-01T08:00:00Z) |
| url | string | Required | download URL for the CSV file (gzip compressed) |
### Response Sample
```bash {{ title: "200:OK" }}
{
"lastUpdated": "2025-04-01T08:00:00Z",
"url": "https://example.com/download-url-bulk-csv"
}
```
## CSV Data Items
| Parameter | Type | Required | Description |
| ---------- | ------ | -------- | ---------------------------------------------------------------------------------------------------- |
| DiscNo | string | Required | Disclosure number (14 digits) |
| Code | string | Required | Issue code |
| Name | string | Required | Company name (Japanese) |
| DiscDate | string | Required | Disclosure date (YYYY-MM-DD) |
| DiscTime | string | Required | Disclosure time (HH:MM) |
| Title | string | Required | Disclosure title (Japanese) |
| DiscStatus | string | Required | Handling type (null: new disclosure, 'revision': corrected disclosure, 'delete': deleted disclosure) |
| RevNo | string | Required | Disclosure revision number (1 to 99) |
| DiscItems | string | Required | Public item codes (`\|` separated) |
| Docs | string | Required | Document types (`\|` separated) (g: full PDF, s: summary PDF, x: XBRL) |
## CSV Data Sample
```csv
DiscNo,Code,Name,DiscDate,DiscTime,Title,DiscStatus,RevNo,DiscItems,Docs
20250401130100,86970,日本取引所グループ,2025-04-01,08:00,2025年3月期 決算短信〔日本基準〕（連結）,,1,11101,g|s|x
20250401130200,86970,日本取引所グループ,2025-04-01,09:00,2025年3月期 有価証券報告書,,1,11102,g|x
```
---
Source: https://jpx-jquants.com/en/spec/td-files
# TDnet/Company Disclosure Files (/td/files)
`GET` /v2/td/files
## Overview
You can retrieve download URLs for files associated with a disclosure number (discNo).\
Use the returned URLs to download PDF and XBRL files. URLs expire in 15 minutes.
### Attention
> **Info**
>
> - This API requires the TimelyDisclosure add-on.
> - Data is available for the past 5 years.
> - download URLs expire in 15 minutes.
## Retrieve download URLs for TDnet/Company Disclosure Files
`GET` `https://api.jquants.com/v2/td/files`
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| discNo | string | Required | Disclosure number (14 digits) (e.g. 20250401130100) |
| docs | string | Optional | Types of files to retrieve (multiple values can be specified separated by commas) g: full PDF, s: summary PDF, x: XBRL If omitted, all types are returned (e.g. g or g,s,x) |
### Sample Code
/v2/td/files
**cURL**
```bash
curl -G https://api.jquants.com/v2/td/files \
-H "x-api-key: {{apiKey}}" \
-d discNo="{{discNo}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/td/files', {
params: {
discNo: '{{discNo}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/td/files",
params={"discNo": "{{discNo}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| ---------------- | ------ | -------- | -------------------------------- |
| discNo | string | Required | Disclosure number (14 digits) |
| files | object | Required | download URL map for files |
| files.pdf | string | Required | download URL for the full PDF |
| files.summaryPdf | string | Required | download URL for the summary PDF |
| files.xbrl | string | Required | download URL for the XBRL file |
### Response Sample
```bash {{ title: "200:OK" }}
{
"discNo": "20250401130100",
"files": {
"pdf": "https://example.com/download-url-pdf",
"summaryPdf": "https://example.com/download-url-summary",
"xbrl": "https://example.com/download-url-xbrl"
}
}
```
---
Source: https://jpx-jquants.com/en/spec/td-list
# TDnet/Company Disclosure Index List (/td/list)
`GET` /v2/td/list
## Overview
You can retrieve a list of timely disclosure index information (e.g. disclosure number, date/time, title).\
Specify a date or issue code to retrieve data.
### Attention
> **Info**
>
> - This API requires the TimelyDisclosure add-on.
> - Data is available for the past 5 years.
> - No webhook is provided to notify you of new or updated disclosures. To retrieve same-day disclosures incrementally, use [Retrieving Differential Data Using Cursor](https://jpx-jquants.com/en/spec/cursor).
> - In the current implementation, the following behavior applies when a timely disclosure is corrected or deleted:
> - If the title of a disclosure file is corrected, the correction is not reflected in the data returned by this API.
> - If a disclosure file itself is corrected, a new disclosure number is assigned and it is treated as a new record.
> - Even if a disclosure is deleted, this API continues to return the disclosure.
> - In the current implementation, DiscStatus is always null and RevNo is always 1.
## Retrieve TDnet/Company Disclosure Index List
`GET` `https://api.jquants.com/v2/td/list`
Either a date (date) or an issue code (code) must be specified to retrieve data.
### Parameter and Response
Either a date (date) or an issue code (code) must be specified.\
Parameter in the request and results are as below:
- date: ✓, code: –, from/to: – → List of disclosures on the specified date
- date: –, code: ✓, from/to: – → List of disclosures for the specified issue (last 5 years)
- date: –, code: ✓, from/to: ✓ → List of disclosures for the specified issue during the specified period
### Retrieving disclosures using cursor
For the cursor-based real-time differential retrieval specification, see [Retrieving Differential Data Using Cursor](https://jpx-jquants.com/en/spec/cursor).
### Requests
### Headers
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | API Key |
### Query Parameters
> **Note**
>
> Either **date** or **code** must be specified.
| Parameter | Type | Required | Description |
| --------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| date | string | Optional | Disclosure date (e.g. 20250401 or 2025-04-01) |
| code | string | Optional | Issue code (e.g. 13010 or 1301) If a 4-character code is specified, 0 is appended at the end. |
| from | string | Optional | Start date (e.g. 20250301 or 2025-03-01) Used in combination with code. Must be specified together with to. |
| to | string | Optional | End date (e.g. 20250401 or 2025-04-01) Used in combination with code. Must be specified together with from. |
| discItems | string | Optional | Filter by public item code (multiple values can be specified separated by commas, AND condition) (e.g. 11101 or 11101,11102) For the list of public item codes, refer to [Appendix 1 of the TDnet API Specifications](https://www.jpx.co.jp/english/markets/paid-info-listing/tdnet/p1j4l40000000q03-att/tdnetapi_specificationsE.pdf). |
| cursor | string | Optional | Pagination key for real-time retrieval of today's data Use the value returned as cursor in the previous response. Cannot be specified together with pagination\_key. |
| pagination\_key | string | Optional | Pagination key Use the value returned as pagination\_key in the previous response. Cannot be specified together with cursor. |
### Sample Code
/v2/td/list
**cURL**
```bash
curl -G https://api.jquants.com/v2/td/list \
-H "x-api-key: {{apiKey}}" \
-d date="{{date}}"
```
**JavaScript**
```javascript
import axios from 'axios'
const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})
await client.get('/v2/td/list', {
params: {
date: '{{date}}',
},
})
```
**Python**
```python
import requests
headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
"https://api.jquants.com/v2/td/list",
params={"date": "{{date}}"},
headers=headers,
)
print(resp.json())
```
### Responses
### Data Item
| Parameter | Type | Required | Description |
| --------------- | --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| DiscNo | string | Required | Disclosure number (14 digits) |
| Code | string | Required | Issue code |
| Name | string | Required | Company name (Japanese) |
| DiscDate | string | Required | Disclosure date (YYYY-MM-DD) |
| DiscTime | string | Required | Disclosure time (HH:MM) |
| Title | string | Required | Disclosure title (Japanese) |
| DiscStatus | string | Required | Handling type (null: new disclosure, 'revision': corrected disclosure, 'delete': deleted disclosure) |
| RevNo | number | Required | Disclosure revision number (1 to 99) |
| DiscItems | string\[] | Required | List of public item codes |
| Docs | string\[] | Required | List of document types (g: full PDF, s: summary PDF, x: XBRL) |
| cursor | string | Required | Time pointer indicating up to which disclosure has been fetched (returned only when date equals today and all results fit in a single response without pagination) |
| pagination\_key | string | Required | Pagination key |
### Response Sample
```bash {{ title: "200:OK" }}
{
"data": [
{
"DiscNo": "20250401130100",
"Code": "86970",
"Name": "日本取引所グループ",
"DiscDate": "2025-04-01",
"DiscTime": "08:00",
"Title": "2025年3月期 決算短信〔日本基準〕（連結）",
"DiscStatus": null,
"RevNo": 1,
"DiscItems": ["11101"],
"Docs": ["g", "s", "x"]
}
],
"cursor": "eyJkIjoiMjAyNS0wNC0wMSIsInQiOiIyMDI1LTA0LTAxVDA4OjAwOjAwWiMyMDI1MDQwMTEzMDEwMCJ9"
}
```
---
Source: https://jpx-jquants.com/en/help/about
# About the Service (FAQ)
## What can the J-Quants API service do?
J-Quants API is a service that allows users to obtain financial data such as historical stock prices (OHLC), trading volume, and Company earnings via API. It aims to make it easier for individuals to obtain well-formatted financial data. J-Quants API democratizes financial data, providing individuals with the same data sets as institutional investors.
## What kind of data is provided by the J-Quants API?
See the [available datasets](https://jpx-jquants.com/en/#dataset) currently offered.
## I don't know how to use J-Quants API. What should I do first?
For first-time users, please refer to the [Quick Start Guide](https://jpx-jquants.com/en/spec/quickstart). The basic flow is as follows. See also the [API Spec Documentation](https://jpx-jquants.com/en/spec/data-spec) for details.
- Create an account and sign in
- Issue and obtain an API key from the 'API Keys' page on the dashboard
- Send requests to data endpoints with the x-api-key: header
## Is it possible to get data in file format such as CSV instead of API?
You can download CSV files (Free plan users can only access Trading Calendar). See [File Downloads](https://jpx-jquants.com/en/spec/bulk) for details.
## Where can I obtain data that is not provided by J-Quants API?
Data and usage patterns not provided by J-Quants API may be available through [J-Quants DataCube](https://dc.jpx-jquants.com) or [J-Quants Pro](https://pro.jpx-jquants.com). Please check each service's website for availability and details.
- Data outside the provided data period → J-Quants DataCube
- Corporate use and academic research use → J-Quants Pro
## When is data updated?
Update timing varies by data type. See the [data update schedule](https://jpx-jquants.com/en/spec/data-update) and [endpoint spec documentation](https://jpx-jquants.com/en/spec/data-spec) for details.
- OHLC prices: Updated after market close on trading days
- Financial data: Updated at 18:00 and 24:30 JST (API updated continuously for Premium plan)
- Equities master: Next business day data available from 17:30 JST
## Are there rate limits for the API?
Each plan has a per-minute request limit. If you exceed the rate limit, you will receive a 429 Too Many Requests error. Please wait and try again. See [Rate limits](https://jpx-jquants.com/en/spec/rate-limits) for details.
- Free: 5 requests/min
- Light: 60 requests/min
- Standard: 120 requests/min
- Premium: 500 requests/min
## I get an error when specifying date parameters in my request.
Date parameters must be in YYYYMMDD (e.g., 20240101) or YYYY-MM-DD (e.g., 2024-01-01) format, and must be a valid calendar date. Specifying a non-existent date (e.g., 20240230) will cause an error.
## I'm getting a 403 error with an 'invalid or expired' message.
Your API key may not be sent correctly. Please check the following:
- You are not sending the x-api-key header and the Authorization header at the same time (sending both is not supported; use only the x-api-key header in V2)
- No extra spaces or newlines are included in your API key
- To isolate the cause, also check the status code: 400 errors are caused by invalid request parameters and 429 errors by exceeding the rate limit, which are different causes from 403
## I registered but haven't received a confirmation email.
Your registration may already be complete. Try signing in with your email and password at the [sign-in page](https://jpx-jquants.com/en/login). If you cannot find the email, please also check your spam folder.
## Can I use V1 API endpoints?
J-Quants API has migrated from V1 to V2, changing authentication from the token method to the API key method. V1 has been closed, and all users can only use V2. In V2, include your API key in the x-api-key request header. See the [V1→V2 migration guide](https://jpx-jquants.com/en/spec/migration-v1-v2) and [Quick Start Guide (V2 auth)](https://jpx-jquants.com/en/spec/quickstart) for details.
## What are the V2 equivalents of the V1 endpoints I was using?
Key V1→V2 endpoint mappings are listed below (partial). Note that some response column names have also been shortened in V2 (e.g., stock price Open → O, Close → C). See the full mapping at the [V1→V2 migration guide](https://jpx-jquants.com/en/spec/migration-v1-v2).
- OHLC prices: /v1/prices/daily_quotes → /v2/equities/bars/daily
- Listed stocks: /v1/listed/info → /v2/equities/master
- Financial info: /v1/fins/statements → /v2/fins/summary
- Financial statements: /v1/fins/fs_details → /v2/fins/details
- Trading calendar: /v1/markets/trading_calendar → /v2/markets/calendar
- Short-selling ratio: /v1/markets/short_selling → /v2/markets/short-ratio
- Index OHLC: /v1/indices → /v2/indices/bars/daily
## V1 sample code using auth_user / auth_refresh stopped working.
The V1 endpoints /v1/token/auth_user and /v1/token/auth_refresh have been discontinued. V2 uses API key authentication via the x-api-key request header. Update your sample code authentication as follows. See also the [V1→V2 migration guide](https://jpx-jquants.com/en/spec/migration-v1-v2) and [Quick Start Guide](https://jpx-jquants.com/en/spec/quickstart).
- Old (V1): Get refresh token via auth_user → Get ID token via auth_refresh → Set Authorization: Bearer
- New (V2): Get API key from dashboard → Set x-api-key:
---
Source: https://jpx-jquants.com/en/help/usage
# Usage & License (FAQ)
## What can I use the J-Quants API for?
J-Quants API is a service limited to private use by individuals. Use by corporations, distribution of data to third parties or provision of applications using the data by individuals is prohibited, regardless of whether it is for commercial/profit or non-profit. For corporate use or external distribution, please use [J-Quants Pro](https://pro.jpx-jquants.com).
## What do you mean by private use?
Private use refers to utilizing this data for one's own investment analysis, portfolio management, etc. Providing or distributing the results of investment analysis conducted using this data to third parties on a recurring basis does not qualify as private use.
While it is permissible to utilize this data for portfolio management services provided by third parties, please note that when the data is accessible to others, it does not fall under private use.
## Can a corporation use the service if the use is internal-only and non-profit?
No. Even for internal-only, non-profit purposes, corporations cannot use J-Quants API. For corporate use, please consider [J-Quants Pro](https://pro.jpx-jquants.com).
## Can I use J-Quants API data for blogs or SNS articles, etc.?
You are welcome to disclose the results of your analysis or your analytical methods.
However, please note that it is prohibited to distribute or share the data itself obtained by J-Quants API in a form that can be viewed. Also, providing or distributing the results of investment analysis conducted using this data to third parties on a recurring basis does not qualify as private use.
## Can I publish analysis results (charts, etc.) on websites or SNS?
Distributing or sharing raw data directly is prohibited, but sharing analysis results (charts, graphs, reports, etc.) is permitted. However, continuously and repeatedly publishing analysis results is not considered personal use (e.g., repeatedly streaming analysis on YouTube is not considered personal use). Note that no source attribution is required for private, non-public personal use. If you plan to use analysis results in commercial publications such as books, individual confirmation is required, so please contact us.
## Can I publish analysis results in YouTube videos? Does ad revenue make it commercial use?
Publishing your own analysis results and methods is acceptable. However, avoid displaying raw data in a form viewable by viewers. Continuously distributing analysis results to third parties is not personal use. Ad revenue alone does not immediately constitute 'commercial use,' but the above conditions must be met.
## Can I publish or distribute an app that integrates J-Quants API to other users?
The following cases do not qualify as private use and are therefore prohibited:
- Providing functionality to share or publish J-Quants data or analysis results among users.
- Configurations where J-Quants-derived data is stored or relayed on the app operator's server.
The following design is acceptable under the terms of use:
- Each user of the app individually subscribes to J-Quants API and obtains data using their own API key.
- The obtained data and analysis results are not disclosed to anyone other than that individual user.
If you provide an app where each user uses their own API key, please note the following:
- State on the app's introduction page and in its terms of use that each user individually subscribes to J-Quants API and obtains data with their own API key.
- Use of the J-Quants logo and expressions implying a relationship with us, such as 'official', 'partnered', or 'Powered by', are prohibited.
## Can I use J-Quants API data to write my graduation thesis?
Students may use J-Quants API for academic purposes only to write their own graduation theses. However, use by classes or groups of students in classes or seminars, use by faculty members for the purpose of teaching classes or providing guidance, and use by researchers for the purpose of writing papers or presenting papers at academic conferences are prohibited. Please use [J-Quants Pro](https://pro.jpx-jquants.com) if you plan to use it for these purposes.
## During my subscription, can I store the acquired data in an external cloud service?
As long as the data can be viewed only by you, storing it in an external cloud service managed by you is also permitted. There are no specific requirements on the amount of data stored or the storage location; however, you are responsible for appropriate safeguards such as access control and encryption so that the data cannot be viewed by third parties. Note that after cancellation or a plan downgrade, you must delete the stored data, its copies, and any derivatives from which the original data can be reconstructed (reverse-engineered). Derivatives from which the original data cannot be reconstructed do not need to be deleted, as long as you do not distribute or publish them externally.
## Can I input the acquired data into generative AI for analysis?
If all four of the following conditions are met, such use is within the scope of private use. You are responsible for confirming that each condition is met (the AI service's terms, training-use settings, and data handling); if you are unsure, please contact us.
- The use is for your own analysis purposes.
- The AI is configured so that the input data is not reused for training.
- The input data cannot be viewed by third parties.
- The generated results are not distributed or published.
## Can I use the data after I cancel my subscription or withdraw from the service?
No. J-Quants API is a data usage service, not a data sales service, so after you cancel your subscription or withdraw from the service, you must delete all data you acquired up to that point, together with any copies and any derivatives from which the original data can be reconstructed (reverse-engineered). Derivatives from which the original data cannot be reconstructed (such as trained model weights) do not need to be deleted, as long as you do not distribute or publish them externally.
## After changing plans, is it possible to use the data from the previous plan?
J-Quants API is a data usage service, not a data sales service, so after changing plans, you will not be able to use the data you have previously acquired with a higher plan. Please delete the data acquired under the higher plan, together with any copies and any derivatives from which the original data can be reconstructed (reverse-engineered). Derivatives from which the original data cannot be reconstructed do not need to be deleted, as long as you do not distribute or publish them externally.
## After cancellation or a plan downgrade, do I also need to delete models and aggregates created from the acquired data?
After cancellation (withdrawal) or a plan downgrade, please delete the acquired data, its copies, and any derivatives from which the original data can be reconstructed (reverse-engineered). Derivatives from which the original data cannot be reconstructed do not need to be deleted, as long as you do not distribute or publish them externally.
---
Source: https://jpx-jquants.com/en/help/plan
# Plans, Changes & Cancellation (FAQ)
## What are the pricing and available data for each plan?
Please see the [data specs by plan](https://jpx-jquants.com/en/spec/data-spec) for pricing and available data. Some data is available even on the Free plan.
## What subscription plans are available?
Four base plans are available: (1) Free Plan, (2) Light Plan, (3) Standard Plan, and (4) Premium Plan. Add-on plans that allow access to additional data not available in base plans are also available. To subscribe to an add-on plan, you must be on a paid plan (Light Plan or higher). Please see the [plan chart](https://jpx-jquants.com/en/#pricing) for details.
A credit card is required at sign-up to use paid plans.
## What is the difference between user registration and subscription plan selection?
Registering with J-Quants allows you to obtain sample data, but you must select a plan to obtain daily data.
## Can't I get today's stock price with the free plan?
No. With the free plan, data is delivered with a 12-week delay.
## What is the expiration of the free plan?
The free plan is available for one year only. Your free plan will be automatically cancelled after one year.
You can re-subscribe after the plan is cancelled.
## Can I subscribe to the add-on plan only?
To use the add-on plan, you must be subscribed to the Light Plan or higher. The add-on plan cannot be used on its own.
## How do I make payment?
All are monthly plans, and the monthly fee is deducted from your credit card.
Payment is made through Stripe Japan.
Your credit card information is handled by Stripe Japan and is not viewed by us.
## How can I check my credit balance?
Credits incurred or used through subscription plan changes can be viewed on your receipts and invoices. Receipts and invoices are available in the Stripe customer portal, which you can access from the 'Billing' page of the dashboard.
## I received an unexpected charge.
We will check your contract status. Please provide the following information via the inquiry form.
- Your registered email address
- Date and amount of the charge
- Your current plan
## My credit card payment is not going through (authentication error).
J-Quants API uses Stripe for payment. Please check the following. If the issue persists, try a different card or contact your card issuer directly.
- Card details (number, expiry, security code) are correct
- Card has sufficient credit limit
- No online payment restrictions set by your card issuer
- Complete 3D Secure authentication (SMS, etc.) if prompted
## Can I change my plan?
You can change your plan at any time. For base plan changes, there is no limit on upgrades to higher plans, but downgrades are limited to once per month.
When changing your subscription plan, the change takes effect immediately and the difference is charged on a pro-rata basis.
If you downgrade during a billing cycle, a credit balance for the remaining period will be issued for future payments.
## After downgrading, my plan switched immediately and I lost the remaining period.
Plan downgrades take effect immediately upon completion. A credit balance for the remaining period will be issued for future payments. If you want to switch plans from next month, we recommend selecting 'Cancel' (which applies at billing period end) rather than 'Downgrade', then re-subscribing afterward.
## How do I cancel my plan?
Select 'Cancel plan' on the Dashboard > Subscription screen. Cancellation applies at the end of the billing period, and you can continue using the current plan until then.
## Can I cancel my subscription?
Both free and paid subscriptions can be cancelled at any time.
Plans are cancelled at the end of the billing period and will remain available from the date you indicate cancellation until the end of the billing period. Note that prorated refunds are not provided.
## I cancelled my plan but would like to undo the cancellation and continue.
After submitting a plan cancellation request, you can cancel the cancellation before the effective date. Select the 'Undo cancellation' button on the 'Subscription' page of the dashboard to reverse the cancellation. After undoing, the plan will renew on the regular billing cycle.
## Can I keep using the add-on plan after cancelling the base plan?
The add-on plan requires an active paid base plan.
If the paid base plan cancellation takes effect, or if you switch from the paid base plan to the Free plan, the add-on plan will be automatically cancelled on its next renewal date.
You can continue using the add-on plan until its cancellation takes effect.
## What is the difference between withdrawal and subscription plan cancellation?
Cancelling your subscription plan stops plan access, but your user information remains in J-Quants API and you can still log in.
Withdrawal deletes your user information from all J-Quants API services, and you will no longer be able to log in.
## How do I withdraw from the service?
Follow these steps to withdraw. Note that withdrawal permanently deletes all personal information and you will lose access to all records including invoices. 'Cancellation' only stops the plan while retaining user data; 'Withdrawal' deletes everything.
- Log in to the J-Quants API site
- Open the 'Profile' screen on the dashboard
- Click 'Proceed with withdrawal' at the bottom of the screen
## Can I withdraw from the service at any time?
You may withdraw at any time. Upon withdrawal, your personal information in J-Quants API will be deleted. Please note that you will lose access to all information including paid invoices after withdrawal. You can withdraw by clicking 'Proceed with withdrawal' at the bottom of the 'Profile' screen after logging in.
Please note that any credit balance you hold will also be lost upon withdrawal.
---
Source: https://jpx-jquants.com/en/help/payment
# Payment & Invoices (FAQ)
## Can I register without a credit card?
Only credit card payments are accepted. Note that the free plan is also registered via Stripe Checkout, but no card information is required to register for the free plan.
## The credit card registration screen (authentication screen) won't open.
The credit card authentication screen is displayed as a popup and may be blocked by your browser's popup blocker. Please try the following:
- Allow popups for this site (jpx-jquants.com) in your browser settings
- Try a different browser (Chrome, Safari, Firefox, etc.)
- Try a different device (PC or smartphone)
- If the issue persists, try a different credit card
## Can you explain the billing cycle?
The monthly usage fee is billed in one-month cycles starting from the date you registered for a paid plan. The first payment is made at the time of plan registration, and the next payment is due on the same date of the following month (if that date does not exist in the following month, the last day of that month applies).
For example, if you subscribe on April 25th, the service period does not end on April 30th, but continues until May 25th — the same date in the following month. The next payment is also made on May 25th, and billing continues on the 25th of each month thereafter.
## I received a payment confirmation email from my credit card company.
To prevent unauthorized use, your credit card company may send a confirmation email about card usage. Please sign in to J-Quants API and verify your credit card from the portal.
## My plan was cancelled because my credit card payment failed.
If payment fails, your plan will be automatically cancelled. Please re-register for the plan.
## Where can I view or download receipts?
A receipt link is included in the Stripe payment confirmation email. You can also download receipts from the billing history on the Dashboard > Billing screen.
## Can you issue a qualified invoice (Japanese consumption tax invoice)?
Please contact us via the inquiry form for qualified invoice issuance. We will respond after reviewing your request.
---
Source: https://jpx-jquants.com/en/help/account
# Account Management (FAQ)
## Why do I need to create an account?
An account is required to use the J-Quants API. After logging in with your created account, you will be able to retrieve sample data and purchase plans.
## Is there a fee to create an account?
Creating an account is free.
## I forgot my password.
Please reset your password at the [password reset page](https://jpx-jquants.com/en/login). If you signed up with Google, no password is required for either website login or data retrieval.
## I'm not receiving the MFA authentication code by email.
Please check the following:
- Check your spam/junk mail folder
- Verify your email client and domain settings allow emails from no-reply@jpx-jquants.com
- The authentication code expires after 10 minutes. If expired, use the 'Resend confirmation code' button on the login screen
- Switching to an authenticator app (TOTP) avoids email delays (configurable from Profile screen » Multi-Factor Authentication (MFA) Settings)
## MFA (multi-factor authentication) is required. Can I disable it?
MFA cannot be disabled as it is required for security. Please note the following:
- By default, Email OTP is configured — a 6-digit code is automatically sent to your registered email address at login
- Email subject: 「【J-Quants API】多要素認証コードのご案内 / Your Multi-Factor Authentication Code」
- Sender: no-reply@jpx-jquants.com
- To switch to an authenticator app (TOTP such as Google Authenticator), go to 'Multi-Factor Authentication (MFA) Settings' on the Profile screen in the dashboard
## Can I change my email address?
You can change your email address from the Profile screen in the dashboard after signing in. However, changing from a Google-linked account to an email/password account is not supported by the system.
## I accidentally registered with a corporate email address. Can I delete my account?
You can withdraw by clicking 'Proceed with withdrawal' at the bottom of the Profile screen in your dashboard.
## My account was automatically cancelled after one year of using a free plan. Will my account be deleted?
Free plans are automatically cancelled after one year, but your account will not be deleted. To delete your account, please use the profile page after signing in.
---
Source: https://jpx-jquants.com/en/help/data
# Data & Specs (FAQ)
## Which endpoint provides specific data such as average volume or dividend yield?
Please refer to the [data specs & endpoint list](https://jpx-jquants.com/en/spec/data-spec) for a full list of data and endpoints. If you cannot find what you need, please contact us via the inquiry form.
## 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.
## API response format (column names) has changed from before.
V2 API has changed the response structure and column names. See [V1→V2 migration guide](https://jpx-jquants.com/en/spec/migration-v1-v2) 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
## 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](https://jpx-jquants.com/en/spec/fix-data-info) 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
## 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](https://jpx-jquants.com/en/spec/data-spec) for details.
## 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](https://jpx-jquants.com/en/spec/data-spec) and [adjusted price spec](https://jpx-jquants.com/en/spec/eq-bars-daily/adj) for details.
## How do I calculate market capitalization?
The Valuation Indicators API response includes market capitalization (MktCap, in millions of yen), so no calculation is needed. It is computed as the closing price (or the base price on days when no trade is executed) multiplied by the share count excluding treasury shares. Market capitalization in the Daily Stock Prices (OHLC) API uses a share count that includes treasury shares, so the two values may not match. See [Valuation Indicators](https://jpx-jquants.com/en/spec/eq-valuation) for details.
## Can I retrieve data for delisted stocks?
Yes. Data for the period during which a delisted stock was listed remains available, and can be retrieved by specifying a date or period within its listing period. In the equities master (/v2/equities/master), specify a `date` on which the stock was still listed; if you specify a `code` with a date after delisting, the response will be empty. Note that listing/delisting dates and a list of delisted stocks are not provided. See the [equities master API spec](https://jpx-jquants.com/en/spec/eq-master) and [Daily OHLC](https://jpx-jquants.com/en/spec/eq-bars-daily) for details.
## 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](https://jpx-jquants.com/en/spec/fin-summary) 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](https://jpx-jquants.com/en/spec/fin-summary) 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. For Japanese GAAP, API keys correspond to Column E 'verbose label (English)' of each sheet in the 'Account Item List'; for IFRS, they correspond to Column D 'verbose label (English)' of each sheet in the 'IFRS Taxonomy Element List'. For details on each list, see the [EDINET taxonomy pages](https://disclosure2dl.edinet-fsa.go.jp/guide/static/disclosure/WZEK0110.html).
## Which indices are available in the index OHLC endpoint?
The list of available indices is in the [index code list](https://jpx-jquants.com/en/spec/idx-bars-daily/indexcodes). Note that data coverage periods vary by index.
## 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.
## 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](https://jpx-jquants.com/en/spec/eq-bars-minute) 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](https://jpx-jquants.com/en/spec/data-update) for details.
## 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](https://jpx-jquants.com/en/spec/eq-master).
## Is there a way to distinguish common shares from preferred shares?
The issue code (`Code`) consists of five characters, and the last (fifth) character is a reserve code assigned by share class. You can use this character to distinguish them: common shares have `0`. Also, when you specify a 4-character code in `code` on the J-Quants API, only common share data is returned for issuers that have both common and preferred shares listed. See the [equities master API spec](https://jpx-jquants.com/en/spec/eq-master) for details. For the list of currently listed preferred stocks, see [Listed Issues (Preferred Stocks, etc.)](https://www.jpx.co.jp/english/equities/products/preferred-stocks/issues/) on the JPX website.
---
Source: https://jpx-jquants.com/en/help/incident
# Service Disruptions (FAQ)
## The service is not available.
Please check [X (formerly Twitter) @jpx_JQuants](https://x.com/jpx_JQuants) for information on the outage.
## The website does not load.
If no outage has been announced, the issue may be caused by your environment. Please try the following:
- Check whether the site loads in an incognito (private browsing) window
- If you use a VPN or proxy, try switching it off. Check whether security software is blocking the connection in its settings or logs (if you change any settings, be sure to restore them after checking)
- Disable browser extensions
- Clear your browser cache
- Check whether the site loads on a different network connection
## Where can I check for outage or maintenance information?
Outage and maintenance information is available on [X (formerly Twitter) @jpx_JQuants](https://x.com/jpx_JQuants) and the announcements section of the J-Quants API website. For urgent inquiries, please contact us via the inquiry form after checking the current status.
## How long does it take to restore service?
Although we aim to restore the service as soon as possible, it may take some time depending on the situation. Please note that since this service delivers historical data, most failures will be restored on the next business day or later.
## Will I get a refund if the service is suspended?
In principle, no refunds will be made. Please understand that this service achieves low-cost data delivery without guaranteeing high service uptime.
However, the conditions under which refunds may be issued, such as prolonged service suspension, are set out in the [Terms of Service](https://jpx-jquants.com/en/termsofservice). Please refer to the Terms of Service for details. No refunds will be issued for free plans.
---
Source: J-Quants FAQ "auth" (no dedicated page; provided via the website chatbot at https://jpx-jquants.com/en/help)
# API Auth & Login (FAQ)
## I signed in with Google but auth_user says my password is incorrect.
Even with a Google-linked account, you can issue an API key from the dashboard. Go to the 'API Keys' page on the dashboard, issue a key, and include it in the x-api-key header.
## How do I get a refresh token?
V2 API uses API key authentication instead of the token method. Email/password authentication (auth_user / auth_refresh) is no longer required. Issue an API key from the dashboard and specify it in the x-api-key request header. See also the [Quick Start Guide](https://jpx-jquants.com/en/spec/quickstart) and [V1→V2 migration guide](https://jpx-jquants.com/en/spec/migration-v1-v2) for details.
## Requests with my API key return 401/403 errors, but browser login works.
Please check the following:
- The x-api-key: header is set (Authorization: Bearer ... is V1-only and not supported in V2)
- You are using the latest API key (creating a new API key invalidates the existing one)
- No extra spaces or newlines were included when copying the API key (a missing or invalid API key returns a 403 error)
- For 403 errors, verify that your plan includes access to the endpoint in the spec documentation
## I'm getting 403 Forbidden errors on certain endpoints.
403 errors may have the following causes. V1 endpoints (/v1/...) are not available in V2 — please use V2 endpoints (/v2/...). See the [V1→V2 migration guide](https://jpx-jquants.com/en/spec/migration-v1-v2) for the endpoint mapping. Also check the [data specs by plan](https://jpx-jquants.com/en/spec/data-spec) to verify the endpoint is available under your current plan. If you recently changed plans, it may take several minutes to take effect.
## What is the expiry period of the ID token?
V2 API uses API key authentication, and API keys do not expire. If your key is compromised or you want to stop access, create a new API key from the 'API Keys' page on the dashboard (creating a new API key invalidates the existing one). See the [Quick Start Guide](https://jpx-jquants.com/en/spec/quickstart) for details.
Note: V1 API (legacy) has been closed. If you have not yet migrated, please migrate to V2.
## I'm getting 401 Unauthorized errors on my requests.
401 errors occur when token authentication via the Authorization header fails. A missing or invalid API key returns a 403 error, not a 401. Please check the following:
- If using V1's Authorization: Bearer method, switch to the API key method (x-api-key header) as it is not supported in V2
- The x-api-key: header is specified in your request
- You are using the latest API key (creating a new API key invalidates the existing one)
- No extra spaces or newlines were included when copying the API key
## What should I do if my API key is leaked?
Create a new API key from the 'API Keys' page on the dashboard. Creating a new API key invalidates the existing one. API keys do not expire, but can be reissued at any time. Note that only one API key can be active at a time. See the [Quick Start Guide](https://jpx-jquants.com/en/spec/quickstart) for details.
---
Source: J-Quants FAQ "website" (no dedicated page; provided via the website chatbot at https://jpx-jquants.com/en/help)
# Website & Downloads (FAQ)
## Downloaded CSV files are showing garbled characters.
J-Quants API CSV files are UTF-8 encoded. Opening them directly in Excel may cause garbled text. In Excel, use the 'Data' tab → 'From Text/CSV', then set the encoding to 'UTF-8' when importing.
## I cannot download data from the website.
Free plan users cannot use the CSV download feature, except for the Trading Calendar. If you are on a paid plan and cannot download data, there may be an issue with the download feature. Please provide the following information via the inquiry form. If urgent, you can also retrieve data via the [Quick Start Guide](https://jpx-jquants.com/en/spec/quickstart).
- Browser you are using (Chrome, Safari, etc.)
- Error message content (if any)
- Target stock code or data type