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

単一銘柄の年次バリュエーション時系列を決算期末の新しい順で返す。株価 / 時価総額 / 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 / market_cap も同じ基準に揃えてある。決算期末が株式分割の権利落ち日と効力発生日の間に挟まる決算期では、同一行の 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 と shares_outstanding の積と一致するが、次の 2 つの決算期では一致しない。(1) 決算期末が株式分割の権利落ち日と効力発生日の間に挟まる決算期 (shares_outstanding が旧株数基準のままのため株数を株価の基準へ揃え直す)。(2) shares_outstanding が null の決算期 (本フィールドは算出されるが同一行の積では再現できない)。時価総額は本フィールドを参照すること

market_cap_highnumber | nullrequired

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

market_cap_lownumber | nullrequired

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

pernumber | nullrequired

PER・終値ベース (倍)。有報報告値 EPS がある決算期は stock_price ÷ eps、欠測する決算期は stock_price_adjusted ÷ 計算値EPS(現株数基準) で算出する。PER は比率なのでどちらの基準でも同値 — 出所は per_source を参照

per_sourcestring | nullrequired

**終値ベース per の**出所。reported=有報報告値 EPS ベース / computed=計算値EPSベース / null=per が値なし。computed の決算期では per の分母は同一行の eps とは株数基準が異なる。per_high / per_low の分母も同じ規則で決まる (報告値 EPS があれば報告基準) が、stock_price が無く per が null になる決算期では per_source も null になるため、その場合の高安の基準はレスポンスからは判別できない

Allowed:reportedcomputednull

per_highnumber | nullrequired

PER・高値ベース (倍)。分母は per と同じ規則 (報告値 EPS があれば報告値、無ければ現株数基準の計算値 EPS)

per_lownumber | nullrequired

PER・安値ベース (倍)。分母は per と同じ規則 (報告値 EPS があれば報告値、無ければ現株数基準の計算値 EPS)

pbr_reportednumber | nullrequired

PBR・報告基準 (倍)

pbr_high_reportednumber | nullrequired

PBR・報告基準・高値 (倍)

pbr_low_reportednumber | nullrequired

PBR・報告基準・安値 (倍)

pbr_adjustednumber | nullrequired

PBR・分割/併合調整後・現株数基準 (倍)

pbr_high_adjustednumber | nullrequired

PBR・調整後・高値 (倍)

pbr_low_adjustednumber | nullrequired

PBR・調整後・安値 (倍)

bps_adjustednumber | nullrequired

BPS・調整後・現株数基準 (円/株)

dps_adjustednumber | nullrequired

DPS・調整後・現株数基準 (円/株)

eps_adjustednumber | nullrequired

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

epsnumber | nullrequired

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

bps_reportednumber | nullrequired

BPS・報告基準 (円/株)。有報報告値のみ。pbr_reported 系の分母と一致する。eps と同じく発行体の遡及再表示により分割の前後で株数基準が切り替わることがある。決算期をまたぐ比較や、報告値が欠測する決算期には bps_adjusted / pbr_adjusted (現株数基準) を使うこと

shares_outstandingnumber | nullrequired

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

roenumber | nullrequired

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

roe_computednumber | nullrequired

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

dividend_yield_reportednumber | nullrequired

配当利回り・報告基準 (%)

dividend_yield_high_reportednumber | nullrequired

配当利回り・報告基準・利回り最大 (安値ベース、%)

dividend_yield_low_reportednumber | nullrequired

配当利回り・報告基準・利回り最小 (高値ベース、%)

dividend_yield_adjustednumber | nullrequired

配当利回り・調整後 (%)

dividend_yield_high_adjustednumber | nullrequired

配当利回り・調整後・利回り最大 (%)

dividend_yield_low_adjustednumber | nullrequired

配当利回り・調整後・利回り最小 (%)

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"
      }
    ]
  }
}