先読みしないデータ（point-in-time）の作り方

先読みバイアスは、過去のある日の判断に、その日より後に分かった情報を使ってしまう誤りです。

たとえば 3 月期の決算は、3 月 31 日の時点ではまだ公表されていません。決算期末の日付で決算をつなぐと、5 月の発表までの約 1〜2 か月、未来の数字で銘柄を選ぶことになります。

PER や PBR のように、株価と決算を掛け合わせる指標で特に起きやすい誤りです。

時価総額とバリュエーションの時系列では、日ごとに「その日までに開示済みで、期末が最も新しい決算」を使います。

• 開示日: 決算の出典情報に記録された公表日時のうち、期末以降で最も早い日です。通常は決算短信の日です。
• 開示日が分からない決算: 期末から 45 日後（決算短信の開示の目安）から使います。
• 株価の日付が開示日より前: 前の決算のままです。開示日になって初めて新しい決算に切り替わります。
• 分割調整: 株価・1 株当たりの値・株数は、すべて今の株数の基準にそろえます。分割の日に指標が飛びません。

各指標は、その日の分割調整後の終値と、その日に使える決算から計算します。

トヨタ自動車の時価総額の時系列（週ごと）では、株数の出典（sharesPeriod）が 2026 年 8 月 7 日の行で切り替わります。2027 年 3 月期 第 1 四半期の短信（2026 年 8 月 4 日公表）が出たあとの最初の週末だからです。

それまでは 2026 年 3 月期の通期の株数（130 億 3,338 万株）を使い、切り替え後は第 1 四半期末の株数（118 億 4,183 万株）を使っています。

同じ期間の PER（basis=fy）は、通期の決算だけを使うため、epsPeriod は 2026-03/FY のままです。四半期ごとに切り替えたいときは basis=ttm を使います。

日付の範囲と間引き（interval = daily・weekly・monthly）を指定して取ります。バックテストでは、売買を判断する日付に対して「その日以前で最も新しい行」を結び付けます。

curl -sG "https://api.zenithcode.net/stable/valuation-history" \
  --data-urlencode "symbol=7203" \
  --data-urlencode "from=2025-01-01" \
  --data-urlencode "to=2025-12-31" \
  --data-urlencode "interval=monthly" \
  --data-urlencode "basis=ttm" \
  -H "x-api-key: YOUR_API_KEY"

import requests
import pandas as pd

BASE = "https://api.zenithcode.net/stable"
HEADERS = {"x-api-key": "YOUR_API_KEY"}

def get(path, **params):
    r = requests.get(f"{BASE}{path}", params=params, headers=HEADERS, timeout=30)
    r.raise_for_status()
    return r.json()

# Daily PER / PBR built only from results disclosed on or before each date
val = pd.DataFrame(get("/valuation-history", symbol="7203", basis="ttm",
                       **{"from": "2021-01-01", "to": "2025-12-31"}))
val["date"] = pd.to_datetime(val["date"])

# Your decision dates (e.g. month-end rebalancing)
signals = pd.DataFrame({"date": pd.date_range("2021-01-31", "2025-12-31", freq="ME")})

# merge_asof attaches the latest row on or before each date: no look-ahead
panel = pd.merge_asof(signals, val.sort_values("date"), on="date", direction="backward")
print(panel[["date", "per", "pbr", "epsPeriod", "bpsPeriod"]].tail())

ZENITH Code が守っているのは「どの決算を、いつから使うか」です。次の点は、利用者の側で考慮してください。

• 値の版は保存していません。 有報や訂正で値が置き換わると、過去の日付にも置き換わった値が使われます。公表当時に見えていた数字そのものではありません。
• 開示日は最初の公表日です。 短信の日から有報で確定した値を使うため、短信と有報で数字が違う会社では、短信の公表から有報の提出までの期間に差が出ます。
• 財務のエンドポイントは最新の値を返します。 income-statement などを自分でつなぐ場合、provenance.announcedAt 以降に使うと保守的（遅め）になります。announcedAt は今の出典の公表日時なので、有報に置き換わった期は有報の日付です。
• 株価は 2010 年 1 月からです。 それより前の時価総額・PER の時系列は作れません。