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

`GET`    /v2/equities/valuation

## APIの概要

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

### 本APIの留意点

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