年次バリュエーション時系列

単一銘柄の年次バリュエーション時系列を決算期末の新しい順で返す。株価 / 時価総額 / PER / PBR (報告基準・調整後) / EPS (報告基準・調整後) / BPS (報告基準・調整後) / ROE / 配当利回り (報告基準・調整後) / 発行済株式数と、トップレベルの per_5y_avg (直近5年 PER の単純平均)。各数値プロパティの単位は fields[].unit を参照 (金額は円)。fiscal_year と per_source は数値ではないため fields[] の対象外。PER は有報報告値 EPS を優先し、欠測する決算期のみ計算値で補完する (採用元は per_source)。ROE は報告値 (roe) と計算値 (roe_computed) を別項目で返す (/financials と同じ分け方)。該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。

GET/valuations

Authorization

AuthorizationBearer token · headerrequired

IRBANK Connect (app.irbank.net/mcp-api) で発行した API キー

Query parameters

security_codestringrequired

証券コード (4 桁)

matches ^[0-9A-Z]{4,5}$

yearsinteger

取得する直近の決算期数 (1〜50、既定 20)

min 1 · max 50 · default: 20

Responses

200OK

fieldsobject[]required

history[] 数値プロパティの単位メタデータ (self-describing)

Show properties

Array of object

keystringrequired

history[] 内の対象数値プロパティのキー

labelstringrequired

日本語の表示名

unitstringrequired

単位識別子 (jpy / jpy_per_share / times / percent 等)

notestring

補足 (任意)

security_codestringrequired

リクエストした銘柄の証券コード (4 桁)

historyValuationHistoryPoint[]required

年次バリュエーション時系列 (決算期末の新しい順)

Show properties

Array of ValuationHistoryPoint

fiscal_yearstringrequired

決算期 (YYYY/MM 形式)

stock_pricenumber | nullrequired

株価・期末終値 (円)。決算期末日以前の直近営業日の実際の終値で、その時点の株数基準。同一行の stock_price_high / stock_price_low / per / pbr_reported も同じ基準に揃えてある。market_cap は現株数基準 (stock_price_adjusted × 調整済み発行済株式数) で算出するためこの基準とは異なる。決算期末が株式分割の権利落ち日と効力発生日の間に挟まる決算期では、同一行の shares_outstanding (旧株数基準) とも基準が異なる

stock_price_highnumber | nullrequired

株価・期中高値 (円、stock_price と同一株数基準へ換算済み)

stock_price_lownumber | nullrequired

株価・期中安値 (円、stock_price と同一株数基準へ換算済み)

stock_price_adjustednumber | nullrequired

株価・期末終値 (円、分割/併合調整後・現株数基準)

stock_price_high_adjustednumber | nullrequired

株価・期中高値 (円、分割/併合調整後・現株数基準)

stock_price_low_adjustednumber | nullrequired

株価・期中安値 (円、分割/併合調整後・現株数基準)

market_capnumber | nullrequired

時価総額・終値ベース (円)。価格と株数を必ず同一の株数基準の組み合わせで算出する。分子は stock_price_adjusted (現株数基準)、分母は株式分割・併合を遡及調整した発行済株式数 (同じく現株数基準) で、同一行の stock_price と shares_outstanding (as-reported の未調整値) の積では一般に再現できない。時価総額は本フィールドを参照すること。調整済み株数が取得できない決算期は null

market_cap_highnumber | nullrequired

時価総額・高値ベース (円)

market_cap_lownumber | nullrequired

時価総額・安値ベース (円)

pernumber | nullrequired

PER・終値ベース (倍)。stock_price_adjusted ÷ 実績 EPS (どちらも現株数基準)。実績 EPS は決算期ごとに会計文脈 (連結 → 会計基準 → 期首) を先に決め、その文脈の報告値 EPS を株式分割・併合で現株数基準へ遡及調整したものを優先し、無い決算期は計算値 EPS (eps_adjusted と同じ値) を使う。どちらを使ったかは per_source を参照。同一行の eps (有報記載のまま) は分母に使わない。**株数基準を検証できない決算期は null**: 当該決算期の発行済株式数 (現株数基準) が現在の発行済株式数と乖離して分割・併合等で説明できない (最新の決算期は 1.5 倍超、それより前の決算期は桁違い)、または取得できない場合、分子 (株価) と分母 (1株あたり値) が同じ株数基準である保証が無いため、per / pbr / 配当利回りをまとめて返さない

per_sourcestring | nullrequired

**終値ベース per の**分母の出所。reported = 報告値 EPS を現株数基準へ遡及調整した値 (eps_adjusted フィールドとは別の値)、computed = 計算値 EPS (eps_adjusted フィールドと同じ値)。値が無ければ null。どちらも現株数基準で、同一行の eps とは株数基準が異なる。per_high / per_low の分母も per と同じ

Allowed:reportedcomputednull

per_highnumber | nullrequired

PER・高値ベース (倍)。stock_price_high_adjusted ÷ 実績 EPS (どちらも現株数基準)。分母は per と同じ実績 EPS (出所は per_source)

per_lownumber | nullrequired

PER・安値ベース (倍)。stock_price_low_adjusted ÷ 実績 EPS (どちらも現株数基準)。分母は per と同じ実績 EPS (出所は per_source)

pbr_reportednumber | nullrequired

PBR・報告基準 (倍)。**計算値**: 報告値 BPS (bps_reported) を分母に IRBANK が算出したもので、有報に PBR の記載があるわけではない (「報告基準」は分母の基準を指す)。株数基準を検証できない決算期は null (条件は per の説明を参照)

pbr_high_reportednumber | nullrequired

PBR・報告基準・高値 (倍)。株数基準を検証できない決算期は null

pbr_low_reportednumber | nullrequired

PBR・報告基準・安値 (倍)。株数基準を検証できない決算期は null

pbr_adjustednumber | nullrequired

PBR・分割/併合調整後・現株数基準 (倍)。株数基準を検証できない決算期は null (条件は per の説明を参照)

pbr_high_adjustednumber | nullrequired

PBR・調整後・高値 (倍)。株数基準を検証できない決算期は null

pbr_low_adjustednumber | nullrequired

PBR・調整後・安値 (倍)。株数基準を検証できない決算期は null

bps_adjustednumber | nullrequired

BPS・調整後・現株数基準 (円/株)。**株数基準を検証できない決算期は null**: 現株数基準に揃っていることを保証できないため、株価と組める値としては返さない (条件は per の説明を参照)

dps_adjustednumber | nullrequired

DPS・調整後・現株数基準 (円/株)。**株数基準を検証できない決算期は null**: 現株数基準に揃っていることを保証できないため、株価と組める値としては返さない (条件は per の説明を参照)

eps_adjustednumber | nullrequired

EPS・調整後・現株数基準 (円/株)。計算値ベースで株式分割・併合を遡及調整済み。eps (報告値そのまま、分割の前後で株数基準が変わりうる) とは算出基準が異なるため直接比較しないこと。決算期をまたぐ EPS の比較にはこちらを使う。GET /financials・GET /indicators にも同名の eps_adjusted があるが、本フィールドとは算出元が異なり値が食い違うことがある (GET /financials・GET /indicators では eps_computed_adjusted が本フィールドと同一算出元)。未算出の期は null (報告値へのフォールバックはしない)。**株数基準を検証できない決算期は null**: 現株数基準に揃っていることを保証できないため、株価と組める値としては返さない (条件は per の説明を参照)

epsnumber | nullrequired

EPS (円/株)。有報報告値のみ (as-reported)。IRBANK 側の分割調整はしないが、決算日後・報告書提出前に効力発生した分割は発行体が遡及再表示するため、分割の前後で株数基準が切り替わり不連続になることがある。決算期をまたぐ比較には eps_adjusted を使うこと。**per の分母はこの値ではない** (現株数基準の実績 EPS。出所は per_source)

bps_reportednumber | nullrequired

BPS・報告基準 (円/株)。有報報告値のみ。pbr_reported 系の分母と一致する。eps と同じく発行体の遡及再表示により分割の前後で株数基準が切り替わることがある。決算期をまたぐ比較や、報告値が欠測する決算期には bps_adjusted / pbr_adjusted (現株数基準) を使うこと。**株数基準を検証できない決算期は pbr_reported が null になるが、本フィールドは有報記載値としてそのまま返す** (記載値であること自体は株数基準の検証可否と独立なため)

shares_outstandingnumber | nullrequired

発行済株式数 (株)。各決算期末時点の有価証券報告書・決算短信の記載値 (as-reported) で、株式分割・併合の遡及調整をしていない。決算期末が権利落ち日と効力発生日の間に挟まる決算期では、stock_price が新株数基準・本フィールドが旧株数基準となり基準が食い違う。market_cap の分母は本フィールドではなく遡及調整済みの別値なので、時価総額は stock_price との積ではなく market_cap を参照すること

roenumber | nullrequired

ROE (%)。**有報報告値のみ**。決算期によって XBRL タグ自体が無く欠測することがある (収録期間全体で約 8 割の決算期にのみ存在)。欠測期を埋めたい場合は roe_computed を参照

roe_computednumber | nullrequired

ROE・計算値 (%)。当期純利益 ÷ 平均自己資本。報告値が欠測する決算期も埋まるため、穴の無い系列がほしい場合は roe ?? roe_computed で合成する。金額同士の比率で株式分割の影響を受けない。自己資本が極小・負の決算期で発散するため、絶対値が 1000% を超える値は採用せず null を返す (値のクランプはしない)

dividend_yield_reportednumber | nullrequired

配当利回り・報告基準 (%)。**計算値**: 報告値ベースの配当と株価から IRBANK が算出したもので、有報に配当利回りの記載があるわけではない。株数基準を検証できない決算期は null (条件は per の説明を参照)。ただし**無配 (配当金総額 0) の決算期は 0 を返す**: 0 は株数基準に依存しないため

dividend_yield_high_reportednumber | nullrequired

配当利回り・報告基準・利回り最大 (安値ベース、%)。株数基準を検証できない決算期は null (無配は 0)

dividend_yield_low_reportednumber | nullrequired

配当利回り・報告基準・利回り最小 (高値ベース、%)。株数基準を検証できない決算期は null (無配は 0)

dividend_yield_adjustednumber | nullrequired

配当利回り・調整後 (%)。株数基準を検証できない決算期は null (条件は per の説明を参照)。ただし**無配 (配当金総額 0) の決算期は 0 を返す**: 0 は株数基準に依存しないため

dividend_yield_high_adjustednumber | nullrequired

配当利回り・調整後・利回り最大 (%)。株数基準を検証できない決算期は null (無配は 0)

dividend_yield_low_adjustednumber | nullrequired

配当利回り・調整後・利回り最小 (%)。株数基準を検証できない決算期は null (無配は 0)

per_5y_avgnumber | nullrequired

PER 5 年平均 (倍)。直近 5 年の正の PER (終値ベース) の単純平均

reasonEmptyReason | anyrequired

本体データが空のとき、その理由 (機械可読な code + 説明・対処ヒント)。本体データが 1 件以上のときは null

Show properties

One of:

EmptyReason

codestringrequired

no_results: このリクエストに該当するデータが 0 件。収録が無い場合と、指定した条件に合致しない場合の両方を含む (両者は現状の実装では区別できないため、機械可読な値としては区別しない)。TDnet 由来の値は開示から 24 時間は収録に反映されないため、直近開示分は後から追加され得る

Allowed:no_results

messagestringrequired

0 件になった状況の説明 (英語)。人間向けの補足であり、分岐は code で行うこと (文面は予告なく改善されうる)

any

any

attributionAttributionrequired

Show properties

source_labelstringrequired

出典表示ラベル（第三者に表示する際はこの表記を使う）

license_notestringrequired

出典・再配信条件の注記

processed_bystringrequired

400パラメータが不正

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

detailsExternalErrorDetail[]

Show properties

Array of ExternalErrorDetail

paramstringrequired

reasonstringrequired

Allowed:missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalid

expectedstring

受理される値の要約（範囲・型・列挙値）。示せない場合は省略する

404証券コードに対応する銘柄が存在しない

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

detailsExternalErrorDetail[]

Show properties

Array of ExternalErrorDetail

paramstringrequired

reasonstringrequired

Allowed:missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalid

expectedstring

受理される値の要約（範囲・型・列挙値）。示せない場合は省略する

Request

curl -X GET "https://api.irbank.net/v1/valuations?security_code=7203" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.irbank.net/v1/valuations?security_code=7203", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.irbank.net/v1/valuations?security_code=7203",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "fields": [
    {
      "key": "string",
      "label": "string",
      "unit": "string",
      "note": "string"
    }
  ],
  "security_code": "7203",
  "history": [
    {
      "fiscal_year": "2025/03",
      "stock_price": 0,
      "stock_price_high": 0,
      "stock_price_low": 0,
      "stock_price_adjusted": 0,
      "stock_price_high_adjusted": 0,
      "stock_price_low_adjusted": 0,
      "market_cap": 0,
      "market_cap_high": 0,
      "market_cap_low": 0,
      "per": 0,
      "per_source": "reported",
      "per_high": 0,
      "per_low": 0,
      "pbr_reported": 0,
      "pbr_high_reported": 0,
      "pbr_low_reported": 0,
      "pbr_adjusted": 0,
      "pbr_high_adjusted": 0,
      "pbr_low_adjusted": 0,
      "bps_adjusted": 0,
      "dps_adjusted": 0,
      "eps_adjusted": 0,
      "eps": 0,
      "bps_reported": 0,
      "shares_outstanding": 0,
      "roe": 0,
      "roe_computed": 0,
      "dividend_yield_reported": 0,
      "dividend_yield_high_reported": 0,
      "dividend_yield_low_reported": 0,
      "dividend_yield_adjusted": 0,
      "dividend_yield_high_adjusted": 0,
      "dividend_yield_low_adjusted": 0
    }
  ],
  "per_5y_avg": 0,
  "reason": {
    "code": "no_results",
    "message": "No segment disclosure is currently recorded for this organization."
  },
  "attribution": {
    "source_label": "金融庁 EDINET / TDnet",
    "license_note": "string",
    "processed_by": "IRBANK"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Security not found",
    "details": [
      {
        "param": "years",
        "reason": "out_of_range",
        "expected": ">= 1"
      }
    ]
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Security not found",
    "details": [
      {
        "param": "years",
        "reason": "out_of_range",
        "expected": ">= 1"
      }
    ]
  }
}