ドキュメント
定義の根拠
Ratio units (0–1 decimals)
比率・割合はすべて 0〜1 の小数で返します（0.25 = 25%）。利益率・ROE・利回り・騰落率・保有比率・増配率なども同じです。たとえば配当利回りは、API では 0.0323、画面では 3.23% です。
百分率 = API の値 × 100Period basis (full year, year to date, TTM)
fiscalPeriod は期末月（YYYY-MM）、period は Q1〜Q3 と FY（通期）です。Q2・Q3 の損益とキャッシュフローは期首からの累計で、四半期単独の値は返しません。
直近 12 か月（TTM）= 当期の四半期累計 + 前期の通期 − 前期の同じ四半期の累計。FY の行はその期の値（12 か月でない期は年率に換算）fiscalPeriodperiodfiscalPeriodDaysStock split adjustment
分割・併合の前後を比べられるよう、1 株当たりの値と株価を現在の株数に合わせた値も返します。係数 1 は調整なしです。
調整後 EPS = EPS × splitAdjustmentFactor。調整後 BPS・調整後配当も同じ係数。株価は調整後終値（adjustedClose）splitAdjustmentFactoradjustedCloseHow null is used
計算できない値は 0 で埋めず、null にします。key-metrics では、metricNullReasons に理由（例: insufficient_prices:200）が入ることがあります。
—metricNullReasonsROE (return on equity)
親会社株主に帰属する当期純利益を、期首と期末の平均の自己資本で割った値です。API では 0.098、画面では 9.8% のように返します。
ROE = 当期純利益 × 年率換算の係数 ÷ 平均自己資本。平均自己資本 =（1 年前の同じ期の自己資本 + 当期末の自己資本）÷ 2。自己資本 = 純資産 − 非支配株主持分 − 新株予約権（取れなければ純資産）roeROA (return on assets)
当期純利益を、期首と期末の平均の総資産で割った値です。0〜1 の小数で返します。
ROA = 当期純利益 × 年率換算の係数 ÷ 平均総資産（平均と年率換算の決まりは ROE と同じ）roaROE and ROA (TTM)
直近 12 か月（TTM）の純利益を、平均の自己資本（ROA は平均の総資産）で割った値です。年率換算はしません。
roeTtm = 直近 12 か月の純利益 ÷ 平均自己資本、roaTtm = 直近 12 か月の純利益 ÷ 平均総資産roeTtmroaTtmPre-tax return on assets (as disclosed)
決算短信のサマリーに会社が書いた値を、そのまま返します。
計算しない（開示値）roaPretaxROIC (return on invested capital)
税引後の営業利益を、投下資本（有利子負債 + 自己資本 + 非支配株主持分）で割った値です。税率は一律 30% とみなします。現金は引きません。
ROIC = 営業利益 ×（1 − 税率 30%）× 年率換算の係数 ÷ 投下資本。投下資本 = 有利子負債 + 自己資本 + 非支配株主持分（期首と期末の平均。純資産を上限にする）roicGross margin
売上総利益を売上高で割った値です。0〜1 の小数で返します。
売上総利益率 = 売上総利益 ÷ 売上高grossMarginOperating margin
営業利益を売上高で割った値です。0〜1 の小数で返します。
営業利益率 = 営業利益 ÷ 売上高operatingMarginOrdinary-income margin
経常利益を売上高で割った値です。経常利益は日本基準に固有の利益の区分です。
経常利益率 = 経常利益 ÷ 売上高ordinaryMarginNet margin
当期純利益を売上高で割った値です。0〜1 の小数で返します。
純利益率 = 当期純利益（親会社株主に帰属）÷ 売上高netMarginRevenue (banks and insurers)
開示された売上高です（連結を優先、実績）。銀行・保険は売上高の代わりに経常収益、証券会社は営業収益を入れています。
計算しない（開示値）revenueSG&A and R&D ratios
販管費や研究開発費が、売上高・売上総利益のどれだけに当たるかを API が計算します。
sgaToRevenue = 販管費 ÷ 売上高、sgaToGrossProfit = 販管費 ÷ 売上総利益、researchAndDevelopmentToRevenue = 研究開発費 ÷ 売上高、items[].share = 費目 ÷ 販管費の合計（いずれも小数 6 桁に丸め）sgaToRevenuesgaToGrossProfitresearchAndDevelopmentToRevenuesharePER (price-to-earnings ratio)
株価を 1 株当たり利益（分割調整後の EPS）で割った値です。key-metrics-latest などは最新の終値と最新の通期 EPS、key-metrics は各期末の株価とその期の EPS を使います。
PER = 終値 ÷（調整後 EPS × 年率換算の係数）。調整後 EPS が無ければ開示 EPS。年率換算の係数は、期間が 120〜329 日なら 365 ÷ 日数（Q2・Q3・半期決算）、それ以外は 1（Q1 は換算しない）。年間ベースで比べるなら perTtmperPER (TTM) and forward PER
perTtm は終値を直近 12 か月（TTM）の EPS で、perForecast は終値を会社予想の EPS で割った値です。
perTtm = 終値 ÷ epsTtm（直近 12 か月の EPS は分割調整後の EPS から作る）。perForecast = 終値 ÷ 会社予想 EPS（通期の予想なので、FY の行以外では年率換算しない）perTtmperForecastepsTtmepsForecastPBR (price-to-book ratio)
株価を 1 株当たり純資産（分割調整後の BPS）で割った値です。
PBR = 終値 ÷ 調整後 BPS（無ければ BPS）。BPS は残高なので年率換算しないpbrPSR (price-to-sales ratio)
時価総額を売上高で割った値です。psrTtm は直近 12 か月（TTM）の売上高を使います。
PSR = 時価総額 ÷（売上高 × 年率換算の係数）、psrTtm = 時価総額 ÷ 直近 12 か月の売上高。年率換算の係数は、期間が 120〜329 日なら 365 ÷ 日数（Q2・Q3・半期決算）、それ以外は 1（Q1 は換算しない）psrpsrTtmPEG ratio
PER を EPS の伸び率（百分率の数値）で割った値です。pegRatioForecast は、予想 PER を予想 EPS の伸び率で割ります。
pegRatio = perTtm ÷（EPS の伸び率 × 100）。pegRatioForecast = 予想 PER ÷（（予想 EPS ÷ 直近 12 か月の EPS − 1）× 100）pegRatiopegRatioForecastMarket capitalization
終値に、発行済株式数から自己株式を除いた株数を掛けた値です（どちらも分割調整後）。
時価総額 = 終値（分割調整後）× 流通株式数（分割調整後。無ければ 発行済株式数 − 自己株式数）marketCapEV (enterprise value)
時価総額に有利子負債と非支配株主持分を足し、現金及び現金同等物を引いた値です。
EV = 時価総額 + 有利子負債 + 非支配株主持分（無ければ 0）− 現金及び現金同等物（CF 計算書の期末残高）enterpriseValueEV/EBITDA
EV を直近 12 か月（TTM）の EBITDA で割った値です。
EV/EBITDA = EV ÷ 直近 12 か月の EBITDA（通期の行では通期の値）。無ければ nullevToEbitdaValuation history (PER, PBR, dividend yield)
日々の調整後終値と、その日までに公表された最新の EPS・BPS・配当から API が計算します。後から出た決算を先取りしません。
per = 調整後終値 ÷ EPS（EPS > 0 のときだけ、小数 4 桁）、pbr = 調整後終値 ÷ BPS（BPS > 0、4 桁）、dividendYield = 1 株配当 ÷ 調整後終値（6 桁）。EPS・BPS・配当は分割調整の係数で現在の株数にそろえるperpbrdividendYieldepsbpsdividendPerShareepsPeriodbpsPerioddividendPeriodMarket cap history
日々の調整後終値に、その日までに公表された最新の株式数（分割調整後）を掛けて API が計算します。
marketCap = 調整後終値 × 株式数（円に丸め）。株式数は、調整後の流通株式数 → 流通株式数 ÷ 分割係数 → 調整後の発行済株式数 → 発行済株式数 ÷ 分割係数 の順に、最初に取れたものmarketCapsharessharesBasissharesPeriodadjustedCloseDividend per share (DPS)
通期の行は年間配当、四半期の行はその四半期末が基準日の配当です。金額は分割調整後です。
通期: 年間配当の行（実績を予想より優先）。無ければ前期末の翌日から期末までの各回の合計。四半期: 基準日がその四半期末の配当。金額は分割調整後（無ければ開示額）dividendPerShareDividend amount (history)
amount は分割調整後の 1 株配当（無ければ開示額）、rawAmount は開示どおりの金額です。
amount = 調整後の配当額（無ければ開示額）amountrawAmountAnnual dividend
annualDividend は最新の決算年度の年間配当です（会社予想を含みます）。年間の行が無ければ、中間の実績 + 期末の予想です。
annualDividend = 最新の決算年度の年間配当（会社予想を含む）。年間の行が無ければ 中間（実績）+ 期末（予想）annualDividendlatestAnnualDividendDividend yield
年間配当を株価で割った値です。API では 0.0323、画面では 3.23% のように返します。
dividendYield = 年間配当 ÷ 終値dividendYielddistributionYieldPayout ratio
1 株配当を分割調整後の EPS で割った値です。API では 0.3218、画面では 32.18% のように返します。payoutRatioForecast は会社予想の EPS で計算します。
配当性向 = 1 株配当 ÷ 調整後 EPS（開示 EPS では代用しない）payoutRatiopayoutRatioForecastDOE (dividend on equity)
1 株配当を、平均の BPS（分割調整後）で割った値です。会社が開示した DOE ではなく、計算した値です。
DOE = 1 株配当 ÷ 平均の調整後 BPS。平均 =（1 年前の同じ期 + 当期）÷ 2（9〜18 か月前の値が正のときだけ）。無ければ当期の値doedividendToNetAssetsRatioDividend CAGR (3 and 5 years)
年間配当の 3 年・5 年の年平均成長率（CAGR）です。0〜1 の小数で返します。
3 年 =（最新の年度の年間配当 ÷ 3 年前の年度の年間配当）^(1/3) − 1、5 年 =（最新の年度 ÷ 5 年前の年度）^(1/5) − 1。年で数えますdividendCagr3ydividendCagr5yProgressive dividend years (pipeline value)
年間配当が前年度以上だった年度が、直近から何年続いているかです。名前に「増配」とありますが、据え置きの年も数えます。
直近の年度から遡り、年度が連続していて、かつ 当年度 ≥ 前年度 のあいだだけ数えるprogressiveDividendYearsreportedNonDecreaseYearsConsecutive non-decrease and increase years (API)
API が配当履歴から年度ごとの年間配当を作り、据え置きを含む連続非減配年数と、前年度より多い年だけの連続増配年数を数えます。
年度の合計 = 年間配当の行（0 より大きければ）。無ければ各回の実績と予想の合計。直近から遡り、年度が連続し 当年度 ≥ 前年度（増配年数は >）のあいだだけ数える。changeAmount = 当年度 − 前年度（小数 4 桁）、changeRatio = 当年度 ÷ 前年度 − 1（6 桁）consecutiveNonDecreaseYearsconsecutiveIncreaseYearsmatchesReportedyearschangeAmountchangeRatioDividend change rate
決算短信などから検知した年間配当の変更です。変動率と利回りは、ほかの比率と同じく 0〜1 の小数（0.1 = 10%）です。
変動率 = 変更後 ÷ 変更前 − 1、利回り = 年間配当 ÷ 検知日の終値（計算はデータ基盤）changeRatepreviousDividendYieldnewDividendYieldpreviousAnnualDividendnewAnnualDividendRevenue, net income and EPS CAGR (3 and 5 years)
最新の通期と、N 年前の通期を比べた年平均成長率（CAGR）です。0〜1 の小数で返します。
CAGR =（最新の通期 ÷ N 年前の同じ月の通期）^(1/N) − 1（N = 3・5、小数 6 桁）。EPS は分割調整後revenueCagr3yrevenueCagr5ynetIncomeCagr3ynetIncomeCagr5yepsCagr3yepsCagr5yYear-on-year change (as disclosed)
決算短信のサマリーに会社が書いた前年同期比を、そのまま返します。
計算しない（開示値）。一般的な定義は 当期 ÷ 前年同期 − 1revenueChangeRateoperatingIncomeChangeRateordinaryIncomeChangeRatenetIncomeChangeRateForecast growth and forecast margins
会社予想が直前の通期の実績から何割伸びるか、予想の売上高に対する予想利益の割合を API が計算します。
*GrowthVsActual = 予想 ÷ 実績 − 1（通期の行だけ、小数 6 桁）。operatingMarginForecast = 予想営業利益 ÷ 予想売上高、netMarginForecast = 予想純利益 ÷ 予想売上高（6 桁）revenueGrowthVsActualoperatingIncomeGrowthVsActualnetIncomeGrowthVsActualepsGrowthVsActualoperatingMarginForecastnetMarginForecastEquity ratio
自己資本を総資産で割った値です。会社の開示値があれば単位をそろえて使い、無ければ計算します。
自己資本比率 = 自己資本 ÷ 総資産equityRatioEquity and common equity
ownersEquity は純資産から非支配株主持分と新株予約権を引いた額です（優先株を含みます）。commonEquity は、さらに優先株を除いた額です。
自己資本 = 純資産 − 非支配株主持分 − 新株予約権ownersEquitycommonEquityshareholdersEquityFinancial leverage
総資産を自己資本で割った値です。
財務レバレッジ = 総資産 ÷ 自己資本financialLeverageInterest-bearing debt and net debt
会社が開示した有利子負債（リース負債を足す）を使い、無ければ借入金・社債・CP・リース負債などを合計します。ネットは現金を引いた額です。
有利子負債 = 開示値（+ リース負債）。無ければ 短期・長期借入金 + 社債 + 1 年内返済分 + CP + リース負債 + …。ネット有利子負債 = 有利子負債 − 現金及び現金同等物（CF の期末残高）interestBearingDebtnetInterestBearingDebtEBITDA
営業利益に、減価償却費とのれんの償却額を足した値です。減価償却費が取れない期は null です。
EBITDA = 営業利益 + 減価償却費（CF 計算書の値を優先）+ のれん償却額（無ければ 0）ebitdaebitdaTtmFree cash flow
営業活動による CF と投資活動による CF の合計です。
FCF = 営業 CF + 投資 CF（投資 CF はふつうマイナス）freeCashFlowCash and cash equivalents
CF 計算書の期末残高です。無ければ BS の値を使います。
計算しない（CF の期末残高。無ければ BS の値）cashAndCashEquivalentscashAtEndOfPeriodTotal liabilities
開示された負債合計です。無ければ、流動負債と固定負債を API が足します。
負債合計 = 開示値（無ければ 流動負債 + 固定負債）totalLiabilitiesPrice (close)
最新の取引日の終値（分割調整後）です。取引所データで、ログインした利用者だけに表示します。
計算しない（調整後終値、無ければ終値）pricepriceDatecloseclosePricePrice change (1 day to 1 year, year to date)
最新の調整後終値を、基準日の調整後終値と比べた変化率です。基準日は、暦の日数で遡った日以前の最後の取引日です。
騰落率 =（最新の調整後終値 − 基準日の調整後終値）÷ |基準日の調整後終値|（小数 6 桁）。基準日: 1 日 = 前の取引日、1 週 = 7 日前以前、1 か月・3 か月・6 か月・1 年 = その月数・年数前以前、年初来 = 前年 12 月 31 日以前の最後の取引日changePct1dchangePct1wchangePct1mchangePct3mchangePct6mchangePct1ychangePctYtd52-week high and low
直近 365 日の、分割調整後の高値の最大と安値の最小です。取引日が 200 日に満たない銘柄は null です。
52 週高値 = 調整後高値の最大、52 週安値 = 調整後安値の最小（直近 365 日）week52Highweek52Lowhigh52low52highDatelowDateMoving averages (50 and 200 days)
直近 50・200 取引日の調整後終値の単純平均です。
ma50 = 直近 50 本の平均、ma200 = 直近 200 本の平均（直近 365 日の中から）ma50ma200Volatility (1 year)
日々の値動き（対数リターン）の標準偏差を、年率に直した値です。0〜1 の小数で返します。
σ = 標本標準偏差（ln(終値_t ÷ 終値_t−1)）× √252volatility1yMaximum drawdown (1 year)
直近 1 年で、それまでの最高値からいちばん大きく下がった割合です。負の小数で返します（−0.35 は 35% の下落）。
最小値（終値_t ÷ それまでの最高終値 − 1）maxDrawdown1y3-year annualized return and Sharpe ratio
3 年前以前の最後の終値から最新までの年率リターンと、そこから無リスク金利を引いて 3 年のボラティリティで割ったシャープレシオです。
return3yAnnualized =（最新 ÷ 起点）^(365 ÷ 日数) − 1。sharpeRatio3y =（return3yAnnualized − 無リスク金利）÷ 3 年の年率ボラティリティreturn3yAnnualizedsharpeRatio3yAverage trading value (90 days)
直近 90 取引日の売買代金（調整前の終値 × 出来高）の平均です。
平均売買代金 = （終値 × 出来高）の平均。実際に売買された金額なので、調整前の終値を使うavgTurnover90dBeta
TOPIX 連動型 ETF（1306）に対する、週次リターンの 2 年間の回帰の傾きです。
β = 共分散（銘柄, 1306）÷ 分散（1306）（週次リターン・2 年）betaWACC and cost of equity
CAPM による株主資本コストと、負債コストとの加重平均（WACC）です。データ基盤が計算します。
株主資本コスト = 無リスク金利 + β × 市場リスクプレミアム。WACC = 株主資本コスト × E/(D+E) + 負債コスト ×（1 − 税率）× D/(D+E)（一般的な定義）wacccostOfEquityDaily move and trading value
最新の取引日と前の取引日の調整後終値から、API が計算します。売買代金は調整前の終値 × 出来高です。
change = 終値 − 前日の終値、changePct = 終値 ÷ 前日の終値 − 1（どちらも小数 6 桁）、turnover = 調整前の終値 × 出来高（円に丸め）changechangePctprevCloseturnovervolume52-week new highs and lows
52 週高値（安値）を付けた日が、直近 days 日以内の銘柄です。distanceFromHigh は終値が 52 週高値からどれだけ離れているかです。
新高値: 高値を付けた日 ≥ 最新の取引日 −（days − 1）日（days は 1〜30、既定 1）。distanceFromHigh = 終値 ÷ 52 週高値 − 1、distanceFromLow = 終値 ÷ 52 週安値 − 1（小数 6 桁）distanceFromHighdistanceFromLownewHighsnewLowsAdvancers, decliners and advance/decline ratio
値上がり・値下がり・変わらずの銘柄数と、値上がり数 ÷ 値下がり数（その日だけの騰落レシオ）です。
advanceDeclineRatio = 値上がり数 ÷ 値下がり数、pctAdvancing = 値上がり数 ÷（値上がり + 値下がり + 変わらず）。universe = 値上がり + 値下がり + 変わらず + 比較できない + 分割で除外advancersdeclinersunchangednoComparisonsplitExcludedadvanceDeclineRatiopctAdvancinguniverseSector performance (median and cap-weighted)
東証 33 業種ごとの騰落率の中央値と、期初の時価総額で重み付けした平均です。
Median = 騰落率の中央値（線形補間）。Weighted = Σ(w × r) ÷ Σw、w = 現在の時価総額 ÷ (1 + r)（期初の時価総額の近似）changePct1dMedianchangePct1dWeightedchangePct1dCountchangePct1wMedianchangePct1wWeightedchangePct1wCountchangePct1mMedianchangePct1mWeightedchangePct1mCountchangePctYtdMedianchangePctYtdWeightedchangePctYtdCountIndustry median and quartiles
東証 33 業種ごとに、各指標の第 1 四分位・中央値・第 3 四分位と有効な件数を返します。平均・最大・最小は返しません。
p 分位 = x[⌊h⌋] + (h − ⌊h⌋)(x[⌈h⌉] − x[⌊h⌋])、h = (n − 1)p（Excel の PERCENTILE.INC と同じ線形補間、小数 6 桁）countperCountperQ1perMedianperQ3pbrCountpbrQ1pbrMedianpbrQ3psrCountpsrQ1psrMedianpsrQ3evToEbitdaCountevToEbitdaQ1evToEbitdaMedianevToEbitdaQ3roeCountroeQ1roeMedianroeQ3roaCountroaQ1roaMedianroaQ3dividendYieldCountdividendYieldQ1dividendYieldMediandividendYieldQ3marketCapCountmarketCapQ1marketCapMedianmarketCapQ3revenueCagr3yCountrevenueCagr3yQ1revenueCagr3yMedianrevenueCagr3yQ3epsCagr3yCountepsCagr3yQ1epsCagr3yMedianepsCagr3yQ3Peer selection and rank
同じ業種の普通株を、時価総額が対象の銘柄に近い順に並べます。最後の行は業種の中央値です。
近さ = |ln(時価総額 ÷ 対象の時価総額)|。marketCapRank = 業種内の時価総額の順位（1 が最大）、marketCapRatio = 時価総額 ÷ 対象の時価総額（小数 6 桁）rolemarketCapRankmarketCapRatiosectorCountScreener filters
条件はすべて境目を含みます（MoreThan は以上、LowerThan は以下）。値が null の銘柄は、条件に合いません。
marketCap・per・pbr・dividendYield は以上と以下、roe・roa は以上、evToEbitda は以下。比率の条件は 0〜1 の小数で指定します（5% なら 0.05）Screener presets
高配当・割安・高 ROE・成長・連続非減配（dividend-growth）・モメンタムの 6 種類です。どれも時価総額 50 億円以上が条件です。条件に合う銘柄の一覧で、投資の推奨ではありません。
high-dividend: 4% ≤ 配当利回り ≤ 12% かつ PER > 0／value: 0 < PER ≤ 15・0 < PBR ≤ 1・ROE ≥ 5%／high-roe: 15% ≤ ROE ≤ 100%／growth: 売上と EPS の 3 年 CAGR ≥ 10%・8% ≤ ROE ≤ 100%／dividend-growth: 連続非減配 5 年以上・利回り 2% 以上／momentum: 1 か月 ≥ +10%・年初来 ≥ +20%rankvalueRankings
引数 metric で選んだ指標で並べた順位です。value はその指標の値です。ROE だけ、1（100%）を超える値を外れ値として除きます。
rank = 並べ替えた順番（1 から）rankvalueFear & Greed index
0〜100 の市場心理のスコアです（0 は極度の恐怖、100 は極度の強欲）。外部の集計サービスの値をそのまま返します。
VIX 連動 ETF（VIXY）の終値から、RSI(14) を反転した値と、20 日移動平均からの乖離を組み合わせたもの。重みとラベルの境目は確認していませんscorelabelpreviousCloselastMonthcomponents定義は 2026 年 10 月 20 日時点の実装に基づきます。計算方法を変えたときは更新履歴でお知らせします。このページは指標の定義の説明で、投資の助言ではありません。