J-Quants API
Markdownを表示

バリュエーション指標(/equities/valuation)

GET /v2/equities/valuation

APIの概要

決算短信の開示内容と株価から算出した、日次のバリュエーション指標と時価総額を取得できます。
実績値は直近12ヶ月（TTM：Trailing Twelve Months）の純利益をもとに、予想値は進行期の予想純利益をもとに算出します。

本APIの留意点

  • 決算短信の開示内容は、開示時刻にかかわらず、原則として翌営業日のデータから反映されます。日次の更新時刻については、提供データの更新タイミングをご確認ください。
  • 株価には当日の終値を用います。売買が成立しなかった日は、その日に適用される基準値段を用いて算出します。
  • ROEおよびFwdROEは小数で収録しています（例：0.2310は23.1%を表します）。
  • 算出に必要なデータが揃わない場合は、該当項目にNullが収録されます（上場後間もない銘柄、決算期変更の移行期など）。算出に用いる株式数や財務情報が揃っていない収録開始当初（2008年から2010年頃）は、Nullとなる銘柄や項目が多くなります。
  • ETF、ETN、優先出資証券など算出対象外の銘柄についてもデータ行は返却されますが、すべての指標がNullとなります。時価総額は、他の指標の算出対象外である銘柄についても算出する場合があります。そのため、優先出資証券、REIT等では、すべての指標がNullでも時価総額に値が入る場合があります。ETF、ETN等は、決算短信の開示がなく株式数を算出できないため、時価総額もNullとなります。
  • REIT等への指標の対応は今後を予定しています（時価総額は現時点でも収録しています）。
  • 各指標の定義、実績値と予想値の違い、および値がNullとなる条件については、指標の算出方法をご覧ください。

日次のバリュエーション指標データを取得します

GET https://api.jquants.com/v2/equities/valuation

データの取得では、銘柄コード（code）または日付（date）の指定が必須です。
各パラメータの組み合わせとレスポンスの結果は以下のとおりです。

codedatefrom /toレスポンスの結果
指定された銘柄について全期間分のデータ
指定された銘柄について指定された日付のデータ
指定された銘柄について指定された期間分のデータ
全上場銘柄について指定された日付のデータ

Requests

Headers

x-api-keystringrequired

APIキー

Query Parameters

code または date のいずれか一つの指定が必須です。

codestringoptional

銘柄コード（例：27800または2780）
4桁の銘柄コードを指定した場合、普通株式と優先株式等の両方が上場している銘柄については、普通株式のデータのみが取得されます。

datestringoptional

日付。fromとtoを指定しないときに使用します（例：20260826または2026-08-26）。

fromstringoptional

fromの指定（例：20260801または2026-08-01）

tostringoptional

toの指定（例：20260826または2026-08-26）

pagination_keystringoptional

検索の先頭を指定する文字列
過去の検索で返却された pagination_key を設定

APIコールサンプルコード

Request

GET
/v2/equities/valuation
curl -G https://api.jquants.com/v2/equities/valuation \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="20230324"

Responses

データ項目概要

Datestring
日付（YYYY-MM-DD）
Codestring
銘柄コード（5桁）
EPSnumber
1株当たり利益（実績・円）（※1、※4）
FwdEPSnumber
1株当たり利益（予想・円）（※2、※4）
BPSnumber
1株当たり純資産（円）（※4、※6）
ROEnumber
自己資本利益率（実績・小数）（※1、※5）
FwdROEnumber
自己資本利益率（予想・小数）（※2、※5）
PERnumber
株価収益率（実績・倍）（※3、※4）
FwdPERnumber
株価収益率（予想・倍）（※3、※4）
PBRnumber
株価純資産倍率（倍）（※3、※4）
MktCapnumber
時価総額（百万円）（※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となります。

レスポンスサンプル

{
    "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."
}

Was this page helpful?