模型預測：方法說明

它是什麼，不是什麼

GET /v1/company/estimates 針對一家公司傳回四項內容：未來四個季度和兩個會計年度的基準預測、公司自行給出的業績指引、描述性訊號，以及方法的歷史準確度。對應的 MCP 工具是 company_estimates。

curl "https://api.financial.md/v1/company/estimates?company=ticker:AAPL&metric=revenue"

• 它是模型輸出。每筆預測都標明 generated_by: model，註明方法版本 fmd-baseline-1，並列出所讀取之已披露資料的證據 id。
• 它不是市場共識預估。沒有任何分析師、券商或資料供應商作為來源。我們不提供華爾街預測、評級或目標價，GET /v1/company/estimates/consensus 傳回 not_covered。
• 它只是基準。方法只知道公司自己的歷史和自己的指引，不知道新聞、股價或產業觀點。請根據隨每個數字一同傳回的歷史準確度來判斷它。
• 僅供參考，不構成投資建議。這裡的任何內容都不表示應當如何處置某檔證券。

輸入

預測五個科目：營收、營業利益、淨利、稀釋每股盈餘和自由現金流。輸入是該科目的季度序列，取自標準化報表，而標準化報表來自公司在 SEC EDGAR 上的 XBRL 申報文件。第四季度等於全年減去前三個季度。

方法需要連續八個已披露的季度。不足時不提供預測，並在回傳結果中說明原因。

每股類序列做兩項修正，均只使用已申報的數值。缺失的第四季度數值按第四季度淨利乘以全年每股盈餘再除以全年淨利計算。當淨利與每股盈餘隱含的股數出現類似股票分割比率的跳變時，此前各季度會重編至最新基準。

公式

以 y 表示按時間由早到晚排列的已披露季度，n 表示季度數。對於往後第 h 個季度的目標，k = ceil(h / 4) 是回到同一會計季度所需的年數，b = n - 1 + h - 4k 是該季度的索引。計算四個分量：

f1 = y[b]
f2 = y[b] + k * mean(d[-8:])            d[i] = y[i] - y[i-4]
f3 = y[b] * g^k                         g = clip(median(r[-4:]), 0.5, 2.0),  r[i] = y[i] / y[i-4]
f4 = y[b] + k * s                       s = exponential smoothing of d, alpha from {0.2, 0.4, 0.6, 0.8}
estimate = median(f1, f2, f3, f4)
scale = mean(|y[-4:]|)

• f1，季節性樸素法：一年前的同一季度。
• f2，季節性漂移法：該季度加上最近八個季度的平均年增減額，每往後一年加一次。
• f3，季節性成長法：該季度乘以最近四個季度與去年同期比率的中位數，限制在 0.5 到 2 之間。僅當最近八個季度全部為正時使用。
• f4，平滑漂移法：與 f2 相同，但變動經過指數平滑；權重取四個候選值中在歷史資料上單步誤差最小的那個。

預測值是現有分量的中位數。有四個數值時即中間兩個的平均，因此單個失控的分量不會帶偏結果。所有分量的數值都在回傳結果中。

會計年度預測等於已披露的季度加上其餘季度的預測。對每股盈餘而言，四個季度之和只是全年數值的近似，因為年內股數會變化。

公司指引

指引取自公司在 EDGAR 上的自有文件：Form 8-K 所附的業績新聞稿（附件 99），以及 10-Q 和 10-K 的正文。只有當同一句話同時包含前瞻用語、未來的會計期間、已知指標和數值時，才予以保留。每條指引都附帶原句、其在文件中的字元偏移位置、申報編號和文件連結。

句中寫明時，指引標為 GAAP、調整後或固定匯率基準；否則標為未說明。未說明絕不當作 GAAP。同一份申報文件中的兩份文件說法不一致時，該指標在該期間不發布任何數值。

部分句子由語言模型而非規則讀取。這些列標明 generated_by: model 並寫出模型名稱。只有當引用的句子逐字出現在文件中，且每個數字都印在句中時，才保留模型的答案。

指引在三種情況下會調整預測：GAAP 或未說明口徑的營收指引；相同口徑的營收成長率指引（套用於一年前的同一期間）；以及公司標明為 GAAP 的營業利益、淨利或每股盈餘指引。此時預測取指引區間的中點，anchor 會註明，並在旁列出統計值。調整後口徑的指引只展示，不會調整 GAAP 預測。自由現金流從不調整。

區間

每條預測帶有一個區間，目標是五次中有四次包含實際揭露值。區間由同一方法過去的誤差按分割保形規則建構：

scaled error e = (actual - estimate) / scale
w = r-th smallest |e| over the n past errors, r = ceil((n + 1) * 0.8)
interval = estimate ± scale * w

• company_history：使用該公司自己在相同預測期的歷史誤差，至少需要八個。
• pooled_history：不足時，使用所有公司在該預測期的誤差。
• guidance_range、guidance_history、guidance_and_history：對於已調整至指引的預測，區間為公司給出的範圍，並按其實際結果偏離自身指引中點的幅度加寬；這類歷史不足時按統計寬度加寬。

只使用在預測日期已經知道的誤差。兩類歷史都沒有時不提供區間，並在回傳結果中說明。

歷史準確度

方法在每家公司的歷史上回放。在每個季度首次揭露的時刻做一次預測，對每個期間只讀取當時已知的數值版本。之後才申報的數值或之後才申報的重編，都無法進入更早的預測。每條預測都與該期間首次揭露的數值比較評分。

ape = |estimate - actual| / |actual|
median_ape = median(ape)        mape = mean(ape)
wape = sum |estimate - actual| / sum |actual|
naive_wape = the same for f1, the same quarter one year earlier
bias = mean((estimate - actual) / |actual|)
interval_coverage = share of actuals inside the interval

這些統計按公司和全部公司、按科目、按季度或年度、按預測期分別提供，並隨每條預測一同回傳。naive_wape 用來判斷方法是否勝過最簡單的基準。在獲利類科目上往往勝出不多：依賴某個預測之前請先看這些數字。

實際值揭露後，揭露前生效的那條已儲存預測也會被評分，結果作為即時記錄保留。個別公司的記錄遵循 as_of。全部公司的彙總表在每次執行時重建，並帶有自己的日期。

訊號

訊號按固定規則描述已申報的事實，共四類：

• guidance_change：公司目前指引的中點與其先前對同一期間、同一口徑指引的比較：上調、下調、維持、收窄、放寬或首次給出。
• estimate_revision：我們自己的預測與自己上一版本的比較：上升、下降或不變。
• result_vs_guidance：首次揭露值與公司指引區間的比較：高於、位於區間內或低於。
• result_vs_own_estimate：首次揭露值與我們先前所做預測的比較：高於、相等或低於。

每條訊號都寫明規則及其依據的證據。沒有評級，沒有目標價，也沒有任何推薦用語。

侷限

• 方法只看一家公司自己的歷史，看不到需求、價格、競爭對手、一次性項目或電話會議上的任何內容。
• 獲利類科目和自由現金流的波動遠大於營收，誤差也反映了這一點。
• 只印在表格中的指引，或期間寫在較早句子中的指引，目前還讀不到。
• 未來期間的日期按財務日曆推算，對 52 或 53 週的會計年度可能相差幾天。
• 某科目沒有連續八個標準化季度的公司，該科目沒有預測。

如果某條預測或指引看起來有誤，請告訴我們。

來源與法律依據

• 來源：僅 SEC EDGAR。申報文件是公開文件；我們遵守 SEC 的公平存取規則，聲明使用者代理並限制請求速率。
• 指引：發行人自己公布的事實，附一句簡短引文和原文連結。我們不託管文件本身。
• 預測與訊號：我們基於上述事實的自有計算，並標明為模型輸出。
• 不使用：任何資料供應商的預測、分析師報告、市場共識數字、逐字稿或新聞正文。

適用條款。本頁描述方法版本 fmd-baseline-1；任何公式的變動都會更改版本號。