Question 1

特定のデータ（平均出来高・配当利回り等）はどのエンドポイントで取得できますか？

Accepted Answer

J-Quants APIで提供しているデータとエンドポイントの一覧はデータ仕様・エンドポイント一覧でご確認ください。お探しのデータが見つからない場合はお問い合わせフォームよりお気軽にお問い合わせください。

Question 2

APIで一度に返却されるデータが上限を超えた場合の取得方法は？

Accepted Answer

レスポンスに `pagination_key` が含まれている場合、データが続きとして存在することを示します。次のリクエストで `pagination_key` クエリパラメータに前回のレスポンスの値を指定することで、続きのデータが取得できます。`pagination_key` が空または含まれなくなるまで繰り返すことで全件取得可能です。

Question 3

APIレスポンスの形式（カラム名）が以前と変わっています。

Accepted Answer

V2 APIではレスポンス構造とカラム名が変更されています。詳細はV1→V2の変更点でご確認ください。
・レスポンス構造: 原則として `data` キーの配列形式で返却されます。ページネーション時は `pagination_key` も含まれます
・カラム名: 株価四本値などで短縮形が採用されています。例: Open → O、High → H、Low → L、Close → C、Volume → Vo、TurnoverValue → Va、AdjustmentFactor → AdjFactor

Question 4

特定の銘柄でデータが欠損している、または誤ったデータが表示されています。

Accepted Answer

データの欠損・不整合についてご報告ありがとうございます。以下の情報をお問い合わせフォームよりお知らせください。データ修正の状況はデータ修正情報でも随時更新しております。
・対象の銘柄コード
・対象のエンドポイント（例：/v2/equities/bars/daily）
・不具合の内容（例：特定日のデータ欠損、数値が異常 等）
・確認された日付または期間

Question 5

株価四本値の値が東証の公式な値と一致しているか確認する方法はありますか？

Accepted Answer

東京証券取引所が公表している株式相場表（日報）で当該日の値をご確認いただけます。なお、約定時刻・約定価格単位での照合はJ-Quants APIの提供範囲外です。

Question 6

契約前に、対象銘柄の収録範囲を確認できますか？

Accepted Answer

プランごとのAPI利用可否およびデータ格納期間は契約ごとに利用可能なAPIとデータ格納期間をご確認ください。個別銘柄の履歴は、データ格納期間内かつ各銘柄の上場日以降が対象となります。加えて、各APIの収録条件（日々公表銘柄への選定の有無、0.5％以上の空売り残高報告の有無等）により、レコードが存在しない期間がございます。個別銘柄ごとの収録状況につきましては、ご契約のプランにて実際にAPIをご利用いただきご確認ください。

Question 7

調整済み株価は過去のデータまでさかのぼって修正されますか？

Accepted Answer

株式分割・併合が発生した銘柄について、配信対象データの最も古いデータまで遡って調整済み株価が再計算されます。遡及期間に上限はありません。取得可能なデータ期間はプランによって異なります。詳細はプラン別データ仕様をご確認ください。

Question 8

無料プランでは直近12週間のデータは取得できませんが、この期間内に株式分割などが生じた場合には株価はどうなりますか？

Accepted Answer

株式分割が発生した場合には効力発生日から遡り、過去の株価が調整されます。そのため、12週間前時点と現在までの間に株式分割が発生した場合には、12週間前以前の株価も分割調整されます。詳しくはプラン別データ仕様および調整済み株価仕様をご確認ください。

Question 9

時価総額を計算するにはどうすればよいですか？

Accepted Answer

バリュエーション指標APIのレスポンスに時価総額（`MktCap`、百万円単位）が含まれているため、計算は不要です。時価総額は終値（売買が成立しなかった日は基準値段）×自己株式を控除した株式数で算出されています。株価四本値APIの時価総額は自己株式を含む株式数を用いるため、両者の値が一致しない場合があります。詳細はバリュエーション指標をご確認ください。

Question 10

上場廃止となった銘柄のデータは取得できますか？

Accepted Answer

取得できます。上場廃止銘柄であっても、上場していた期間のデータはそのまま残っており、上場していた期間内の日付・期間を指定すれば取得可能です。銘柄マスタ（/v2/equities/master）では上場していた時点の日付を `date` に指定すると取得できますが、上場廃止後の日付と `code` を併せて指定した場合はレスポンスが空になります。なお、上場日・上場廃止日の項目や上場廃止銘柄の一覧は提供していません。詳細は銘柄マスタAPI仕様および株価四本値（日足）をご確認ください。

Question 11

財務情報API（fins/summary）の数値は累計値ですか？四半期単体の値ですか？

Accepted Answer

`Sales`（売上高）/ `OP`（営業利益）/ `OdP`（経常利益）/ `NP`（当期純利益）は期首からの累計値です（四半期単体の値ではありません）。例えば `CurPerType=3Q` の場合は9ヶ月間（1Q+2Q+3Q）の累計値です。JGAAP・IFRS・米国基準すべてで共通です。なお、`OdP`（経常利益）はIFRS・米国基準には存在しないため空欄となります。詳細は財務情報API仕様をご確認ください。

Question 12

発行済み株式総数はどのエンドポイントで取得できますか？

Accepted Answer

期末の発行済株式数は財務情報API（/v2/fins/summary）から取得できます。ShOutFY（期末発行済株式数・自己株式含む）からTrShFY（期末自己株式数）を引くと自己株式を除く発行済株式数が算出できます。なお銘柄一覧（/v2/equities/master）には発行済み株式総数フィールドはありません。詳細は財務情報API仕様をご確認ください。

Question 13

財務諸表詳細（fins/details）の勘定科目名が毎年変わります。新旧の対応付けはどうすればよいですか？

Accepted Answer

/v2/fins/detailsのキーはEDINET XBRLタクソノミの「冗長ラベル（英語）」を使用しており、タクソノミ改訂により変更される場合があります。会計基準が日本基準の場合は「勘定科目リスト」の各シートのE列「冗長ラベル（英語）」、IFRSの場合は「国際会計基準タクソノミ要素リスト」の各シートのD列「冗長ラベル（英語）」が本APIのキーに対応します。各リストの詳細はEDINETタクソノミ関連ページでご確認ください。

Question 14

指数四本値ではどの指数のデータが取得できますか？

Accepted Answer

配信対象の指数は指数コード一覧に記載されています。指数によってデータ収録期間が異なりますのでご留意ください。

Question 15

地方取引所やPTSのデータは取得可能ですか？今後の配信予定はありますか？

Accepted Answer

配信するデータは東京証券取引所に上場する銘柄のデータのみです。地方取引所やPTSのデータの配信予定はございません。なお、配当金情報（/v2/fins/dividend）は、地方取引所単独上場銘柄の配当通知も収録しています。

Question 16

分足・ティックデータで先物のデータは取得できますか？

Accepted Answer

現在J-Quants APIでは先物の分足データは提供していません。アドオンの分足・ティックでは現物株のデータのみ取得可能です。詳細は分足データ仕様をご確認ください。

Question 17

分足データの更新タイミングはリアルタイムですか？

Accepted Answer

分足データは日次で更新されます。リアルタイムでの配信ではございません。詳しくはデータ更新スケジュールをご確認ください。

Question 18

ISINコードやFIGIコードは取得できますか？

Accepted Answer

J-Quants APIではISINコードおよびFIGIコードは提供しておりません。利用可能なデータ項目については銘柄マスタAPI仕様をご確認ください。

Question 19

普通株式と優先株式を判別する方法はありますか？

Accepted Answer

銘柄コード（`Code`）は5桁で構成され、末尾の5桁目は株券の種類ごとに付番される「予備コード」です。この予備コードで判別でき、普通株式は「0」となります。また、J-Quants APIで4桁の銘柄コードを `code` に指定した場合、普通株式と優先株式の両方が上場している銘柄では普通株式のデータのみが取得されます。詳細は銘柄マスタAPI仕様をご確認ください。なお、現在上場している優先株式等の一覧は、JPXウェブサイトの銘柄一覧（優先株等）に掲載されています。

Question 20

バックテストや指標の再計算が正しくできるか、計算方法について教えてもらえますか？

Accepted Answer

特定の日付範囲のデータを利用して、個別のバックテスト、ランキングまたは損益計算を再構築できるかは、お客様の計算条件にも依存するため、当社では判定・保証しておりません。公開仕様に基づき、お客様ご自身でご判断ください。

同様に、時系列計算における取引が成立しなかった日の扱い（前営業日の終値で補完する、当該日を欠損として扱う等）についても、J-Quantsとして推奨する取扱いは定めておりません。利用目的に応じてご判断ください。

Question 21

売買停止やコーポレートアクションを収録したデータは提供していますか？

Accepted Answer

個人向けJ-Quants APIでは、売買停止に関する情報は提供しておりません。また、株式分割・株式併合・商号変更などのコーポレートアクション（Corporate Action）を収録したデータセットも提供しておりません。

ただし、株価四本値では、権利落ち日に、株式分割・株式併合・ライツイシューの3種類のコーポレートアクションが権利落種類（ExRT）に設定されます。また、コーポレートアクションに伴って過去データを遡及的に調整するのは株価四本値の調整済み項目のみで、それ以外のAPIでは遡及的な調整は行っておりません。

ご契約ごとに利用可能なデータは契約ごとに利用可能なAPIとデータ格納期間をご確認ください。

Question 22

データセットの更新や訂正を知らせるプッシュ通知（Webhook等）の仕組みはありますか？

Accepted Answer

ございません。データ更新の完了を通知するAPIやWebhook、データの版番号・ETagは提供しておりません。各データの更新タイミングは提供データの更新タイミングに記載していますので、これを踏まえてお客様側で定期的に取得してください。訂正の内容はデータ修正履歴・制約事項に掲載しますので、訂正を確実に取り込みたい場合は、必要な範囲のデータを定期的に再取得いただくことを推奨します。

Question 23

プランの取得可能範囲外の日付を指定するとどうなりますか？

Accepted Answer

取得可能な範囲外の日付を明示的に指定した場合は、HTTP 400 とプランの取得可能範囲を示すメッセージが返却されます。`from`・`to` を省略した場合は、プランの取得可能範囲内に自動調整されます。

Question 24

過去の各営業日における実際のデータ更新時刻を確認できますか？

Accepted Answer

過去の各営業日における実際のデータ更新時刻の実績は公開しておりません。更新時刻の目安は提供データの更新タイミングをご参照ください。

Question 25

APIとCSV（一括提供ファイル）で更新タイミングは同じですか？

Accepted Answer

APIとCSV（一括提供ファイル）で更新タイミングが異なるデータもございます（例：財務諸表(BS/PL/CF)はCSVが日次、APIが随時更新）。データごとの取扱いは提供データの更新タイミングの表をご確認ください。

Question 26

各時点で実際に利用可能だった情報のみを用いた検証（Point-in-Time）はできますか？

Accepted Answer

開示・報告の単位で収録しているデータでは、訂正が別レコードとして追加され、訂正前のレコードも残ります。開示番号・開示日等の項目から、どの時点の開示に基づく値かを識別できます。各データセットの「データ更新・訂正のポリシー」をご参照ください。
・財務情報・財務諸表
・配当金情報
・決算発表予定日
・適時開示インデックス一覧・適時開示インデックス一括ダウンロード
・大量保有報告書・大株主の状況・政策保有株式

Question 27

データの訂正はどのように反映されますか？

Accepted Answer

訂正が別レコードとして追加されるデータセット（財務情報・財務諸表・配当金情報・決算発表予定日・適時開示・EDINET関連）では、各仕様書の「データ更新・訂正のポリシー」に反映方法を記載しています。データ不備・不足等によるデータの追加・上書き修正の履歴はデータ修正履歴・制約事項をご参照ください。

Question 28

CSVファイル（一括ダウンロード）とAPIで収録内容に差はありますか？

Accepted Answer

株価四本値においては、調整済み項目がCSVには存在しません。

それ以外のCSVファイルはAPIと同一のデータから作成されるため、収録項目に差異はありません。

Question 29

CSVファイルはどの単位で提供されますか？銘柄別のファイルはありますか？

Accepted Answer

ファイルはデータ種別（エンドポイント）ごと・月、日ごとのファイルとして提供しており、銘柄別のファイル分割は行っておりません。特定の銘柄のみを扱う場合は、ダウンロード後に抽出をお願いします。

Question 30

CSVファイルをExcelで開くと文字化けします。

Accepted Answer

ファイルの文字コードはUTF-8（BOMなし）です。Excelでファイルを直接開くと日本語が文字化けする場合がございます。Excelをご利用の場合は、「データ」タブ →「テキストまたはCSVから」を選択し、文字コードを「UTF-8」に設定して読み込んでください。

Question 31

ファイルダウンロードに件数・容量・回数の上限はありますか？

Accepted Answer

件数・容量・ダウンロード回数の上限は設けておりません。ただし、ダウンロード可能ファイル一覧（`/v2/bulk/list`）およびファイルダウンロード用URL取得（`/v2/bulk/get`）のAPI呼び出しはレートリミットの対象です。

Question 32

株価・指数の四本値データに速報値と確定値の区分はありますか？

Accepted Answer

株価四本値・指数四本値・TOPIX指数四本値は、いずれも1日1回の更新です。速報値／確定値という区分は設けておらず、配信をもって確定となります。

Question 33

株価分足・ティックの当日データはいつ追加されますか？

Accepted Answer

提供データの更新タイミングをご参照ください。

Question 34

財務情報は開示後すぐに取得できますか？

Accepted Answer

開示情報が発生次第、順次反映しますが、反映までに時間を要する場合があります。特に四半期決算など開示が集中する時期・時間帯は、遅延が大きくなることがあります。Premiumプラン以外では、開示検知後に財務情報APIを短い間隔でご確認いただいても、当該開示に対応するデータは日次反映のタイミング（18:00頃・24:30頃）まで返却されませんのでご注意ください。各データの更新タイミングは提供データの更新タイミングをご参照ください。

Question 35

適時開示インデックスはTDnetと同時に更新されますか？

Accepted Answer

TDnetの適時開示情報閲覧サービスと同時刻の更新ではなく、開示から反映までに時間差が生じます。決算発表が集中する時間帯（15:00・15:30前後など）や配信基盤の運用状況により、平常時より大きな遅延（最大1時間程度）が発生する場合がございます。ザラ場中も同様の扱いで、時間帯による差はございません。秒単位のリアルタイム性を保証するものではございません。

Question 36

CSVファイル（一括ダウンロード）に調整済み株価は含まれますか？

Accepted Answer

CSVファイルでは、株式分割・併合などによる調整済み株価（`AdjO` / `AdjH` / `AdjL` / `AdjC` / `AdjVo`）は提供されません。株価四本値のCSVファイルには、調整前の四本値・取引高に加えて、調整係数（`AdjFactor`）および権利落種類（`ExRT`）が含まれますので、調整済み株価の計算方法をご確認のうえ、ご自身で算出いただけます。

データ内容・仕様