股票 API 參考文件

上市股票的價格、歷史資料、公司事件與估值比率

概覽

上市股票的價格、歷史價格、公司事件、市值與估值比率。每個請求都需要 Bearer 金鑰，REST 與 MCP 共用同一份餘額。

標的 ID 由交易所的四個字母代碼、冒號與股票代號組成，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應中一律附上標準 ID。價格與金額皆為十進位字串。

每個標的可帶有 company_id，用來將標的連結到 Filings API 中的公司，讓價格、估值與財務報表都能以同一個 ID 對應。

基礎網址： https://api.narwhalapi.com。 MCP 工具是 equities, with one action ，適用於下列每個路由。

A company_id 可將標的串接到申報文件 API：財務報表、申報文件與持有人。

每個帳戶都能取得的內容

費用	所有帳戶
最新價格	在線
價格附帶的當日成交量	已包含
日 K 線，以及歷史股利、股票分割與財報	完整歷史資料
1 分鐘 K 線	已包含
搜尋與公司簡介	已包含
漲跌幅排行	已包含
市值、P/E、P/S、P/B 與股息殖利率	已包含
估值歷史	完整歷史資料
資金成本與 Beta	已包含

查看定價說明每次呼叫的費用。除非路由另有說明，請求依其所屬 API 的價格計費。

估值涵蓋可對應到我們財報資料中公司的美國與韓國標的。韓國目前僅提供 P/E。
無法正確計算的比率會省略，不會以 0 回傳。
財報中的 eps_actual 採市場資料口徑，而 pe_ratio 所用的 EPS 來自公司申報文件。兩者可能不同，請勿直接比較。
資金成本涵蓋可對應到我們財報資料中公司的美國與韓國標的。你以 erp 傳入自己的股權風險溢酬。計算方法統一記載於資金成本方法說明，每個回應都會附上連結。
銀行或保險公司會回傳 422 not_applicable，因為利息對它們屬於營運成本。無法計算的輸入項會列在 422 inputs_unavailable 中，不會自行補值。
估值歷史在每個會計期間結束日（季末或年末）各有一個資料點，而不是每天一個。每個資料點採用當日或之前最近一個交易日的收盤價（僅依股票分割調整），以及該期間申報的數字。
財報僅含已公布的結果，尚未提供即將公布的財報日期。
日本標的的簡介只有名稱、交易所、國家、幣別與 company_id。

端點

每個路由都是 GET 請求，並需要將你的金鑰放在以下請求標頭中： Authorization: Bearer 標頭。範例僅展示回應的結構，並非即時資料。

依股票代號或名稱搜尋股票

GET /v1/equities/search

回傳代號或名稱以 q 開頭的標的，不分大小寫，排序為完全相符的代號、其他代號、名稱。可選用 country（三個字母）與 type 篩選。每頁最多 50 筆，並附 next_cursor。資料來自我們自己的代號清單，所有帳號皆可使用，計為一次呼叫。

MCP：工具 equities, action search。

參數

參數	位置	必填	類型	含義
`q`	query	是	字串	股票代號或公司名稱的開頭，不分大小寫，至少 2 個字元（例如 `ms` 或 `micro`）。排序：完全相符的代號、其他代號、名稱開頭、名稱中後面單字的開頭；各組內美國主要標的優先。
`country`	query	否	字串	僅回傳此國家的標的，使用三個字母（USA、KOR）。
`type`	query	否	下列其一：common_stock、preferred_stock、depositary_receipt、reit、closed_end_fund、unit、right、warrant、other	僅回傳此類型的標的。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。

回應欄位

欄位	類型	傳送	含義
`results`	物件陣列	固定回傳	每頁最多 50 筆。
`results[].id`	字串	固定回傳	標準標的 ID。
`results[].symbol`	字串	固定回傳	該交易所上的股票代號。
`results[].name`	字串	固定回傳	名稱，依我們代號清單所載。
`results[].type`	下列其一：common_stock、preferred_stock、depositary_receipt、reit、closed_end_fund、unit、right、warrant、other	固定回傳	商品的類型。
`results[].mic`	字串	固定回傳	交易所的四個字母代碼。
`results[].country`	字串	選填	標的所屬國家，三個字母。
`results[].currency`	字串	固定回傳	價格的幣別。
`results[].company_id`	字串	選填	標的能明確對應時，此為該公司的財報資料 ID。
`next_cursor`	字串	固定回傳	傳回此值即可讀取下一頁。最後一頁為 null。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/search?q=micro"

{
  "results": [
    {
      "id": "XNAS:MSFT",
      "symbol": "MSFT",
      "name": "Microsoft Corporation",
      "type": "common_stock",
      "mic": "XNAS",
      "country": "USA",
      "currency": "USD",
      "company_id": "usa:0000789019"
    }
  ],
  "next_cursor": null
}

單一股票的簡介

GET /v1/equities/{id}

包含標的資料（代號、名稱、類型、交易所、國家、幣別）、公司的產業類別、行業與網站，以及標的對應到我們財報資料中公司時的 company_id。所有帳號皆可使用。日本標的只有名稱、交易所、國家、幣別與 company_id。未知的欄位會省略。

MCP：工具 equities, action profile。

參數

參數	位置	必填	類型	含義
`id`	path	是	字串	標的 ID：交易所的四個字母代碼、冒號與股票代號，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應會附上標準 ID。股別以句點表示（BRK.B），也接受 BRK-B。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	標準標的 ID。
`symbol`	字串	固定回傳	該交易所上的股票代號。
`name`	字串	固定回傳	名稱，依我們代號清單所載。
`type`	下列其一：common_stock、preferred_stock、depositary_receipt、reit、closed_end_fund、unit、right、warrant、other	固定回傳	商品的類型。
`mic`	字串	固定回傳	交易所的四個字母代碼。
`country`	字串	選填	標的所屬國家，三個字母。
`currency`	字串	固定回傳	價格的幣別。
`sector`	字串	選填	產業類別。日本標的沒有簡介文字，因此省略。
`industry`	字串	選填	行業。日本標的省略。
`website`	字串	選填	公司網站。日本標的省略。
`logo_url`	字串	選填	我們自行保存的公司標誌。沒有時省略。
`company_id`	字串	選填	標的能明確對應時，此為該公司的財報資料 ID。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/XNAS:MSFT"

{
  "id": "XNAS:MSFT",
  "symbol": "MSFT",
  "name": "Microsoft Corporation",
  "type": "common_stock",
  "mic": "XNAS",
  "country": "USA",
  "currency": "USD",
  "sector": "Technology",
  "industry": "Software",
  "website": "https://www.microsoft.com",
  "company_id": "usa:0000789019"
}

單一股票的最新價格

GET /v1/equities/{id}/price

單一標的的最新價格。change_percent 以百分比表示。未知的 ID 回傳 404 not_found；尚無價格的市場回傳 404 not_covered。

MCP：工具 equities, action price。

參數

參數	位置	必填	類型	含義
`id`	path	是	字串	標的 ID：交易所的四個字母代碼、冒號與股票代號，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應會附上標準 ID。股別以句點表示（BRK.B），也接受 BRK-B。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	標準標的 ID。
`symbol`	字串	固定回傳	該交易所上的股票代號。
`currency`	字串	固定回傳	所有價格欄位的幣別。便士會換算為英鎊。
`price`	字串	固定回傳	最新成交價，以 `currency` 計。
`previous_close`	字串	選填	前一個交易時段的收盤價。未知時省略。
`change`	字串	選填	`price` 減去 `previous_close`。`previous_close` 省略時一併省略。
`change_percent`	字串	選填	相對於 `previous_close` 的漲跌幅，以百分比表示（1.5 代表 1.5%）。
`volume`	字串	選填	今日成交股數。未知時省略，延遲報價一律省略。
`market_session`	下列其一：pre、open、post、closed	固定回傳	標的所屬交易所在 `timestamp` 時的狀態：pre、open、post 或 closed。只有美國交易所有 pre 與 post。
`timestamp`	日期時間	固定回傳	價格有效的時間（UTC，精確到秒）。
`stale`	布林值	固定回傳	交易所開盤期間價格已超過 15 分鐘，或無法更新時為 true。休市時永遠不算過時。
`delayed`	一律為 true	選填	不會回傳：所有帳號的價格皆為即時。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/price"

{
  "id": "XNAS:MSFT",
  "symbol": "MSFT",
  "currency": "USD",
  "price": "421.35",
  "previous_close": "418.90",
  "change": "2.45",
  "change_percent": "0.58",
  "volume": "18234100",
  "market_session": "open",
  "timestamp": "2026-10-26T15:42:00Z",
  "stale": false
}

最多 50 檔股票的最新價格

GET /v1/equities/prices

回傳所列每個 ID 的最新價格。每個有回傳價格的 ID 計為一次呼叫，並一次扣款：若餘額不足以支付可解析的 ID，整個請求會以 402 insufficient_credits 拒絕。沒有回傳價格的 ID 會列在 errors 中，不收費。change_percent 以百分比表示。

最多可傳入 50 個 ID。批次一次扣款：若餘額不足以支付可解析的 ID，整個請求會回傳 402 insufficient_credits。

MCP：工具 equities, action prices。

參數

參數	位置	必填	類型	含義
`ids`	query	是	字串	以逗號分隔的標的 ID，移除重複後最多 50 個。每個 ID 的規則與單一價格路由相同。每個有回傳價格的 ID 計為一次呼叫。

回應欄位

欄位	類型	傳送	含義
`prices`	物件陣列	固定回傳	每個成功解析的 ID 各有一筆價格，以 ID 為鍵。
`prices[].id`	字串	固定回傳	標準標的 ID。
`prices[].symbol`	字串	固定回傳	該交易所上的股票代號。
`prices[].currency`	字串	固定回傳	所有價格欄位的幣別。便士會換算為英鎊。
`prices[].price`	字串	固定回傳	最新成交價，以 `currency` 計。
`prices[].previous_close`	字串	選填	前一個交易時段的收盤價。未知時省略。
`prices[].change`	字串	選填	`price` 減去 `previous_close`。`previous_close` 省略時一併省略。
`prices[].change_percent`	字串	選填	相對於 `previous_close` 的漲跌幅，以百分比表示（1.5 代表 1.5%）。
`prices[].volume`	字串	選填	今日成交股數。未知時省略，延遲報價一律省略。
`prices[].market_session`	下列其一：pre、open、post、closed	固定回傳	標的所屬交易所在 `timestamp` 時的狀態：pre、open、post 或 closed。只有美國交易所有 pre 與 post。
`prices[].timestamp`	日期時間	固定回傳	價格有效的時間（UTC，精確到秒）。
`prices[].stale`	布林值	固定回傳	交易所開盤期間價格已超過 15 分鐘，或無法更新時為 true。休市時永遠不算過時。
`prices[].delayed`	一律為 true	選填	不會回傳：所有帳號的價格皆為即時。
`errors`	物件陣列	固定回傳	沒有回傳價格的 ID，不收費。
`errors[].id`	字串	固定回傳	請求時傳入的 ID。
`errors[].code`	下列其一：not_found、not_covered、upstream_busy	固定回傳	not_found：沒有這個標的。not_covered：該交易所尚無價格。upstream_busy：目前無法取得價格，請稍後再試。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/prices?ids=XNAS:MSFT,XNAS:NVDA"

{
  "prices": [
    {
      "id": "XNAS:MSFT",
      "symbol": "MSFT",
      "currency": "USD",
      "price": "421.35",
      "previous_close": "418.90",
      "change": "2.45",
      "change_percent": "0.58",
      "volume": "18234100",
      "market_session": "open",
      "timestamp": "2026-10-26T15:42:00Z",
      "stale": false
    },
    {
      "id": "XNAS:NVDA",
      "symbol": "NVDA",
      "currency": "USD",
      "price": "188.20",
      "previous_close": "187.10",
      "change": "1.10",
      "change_percent": "0.59",
      "volume": "152003400",
      "market_session": "open",
      "timestamp": "2026-10-26T15:42:00Z",
      "stale": false
    }
  ],
  "errors": [
    {
      "id": "XNAS:NOPE",
      "code": "not_found"
    }
  ]
}

美國股票漲跌幅排行

GET /v1/equities/movers

依 direction 回傳前 25 檔美國股票與 ETF：gainers、losers 或 active（在當日漲跌幅最大的股票中，依成交值排序，並非全市場）。僅納入股價在 $1 以上、今日成交至少 100,000 股且成交金額至少 $1 million 的普通股與 ETF；由我們自行排名並快取 10 分鐘。change_percent 以百分比表示。market 目前只有 us；其他市場回傳 404 not_covered，未知的 direction 回傳 400 invalid_query。計為一次呼叫。

漲跌幅排行僅提供美國市場。其他市場回傳 404 not_covered。

MCP：工具 equities, action movers。

參數

參數	位置	必填	類型	含義
`market`	query	否	字串	要排名的市場。目前只有 `us`；其他市場回傳 404 not_covered。
`direction`	query	否	字串	`gainers`（漲幅最大）、`losers`（跌幅最大）或 `active`（在當日漲跌幅最大的股票中，成交值最高者，並非全市場）。其他值回傳 400 invalid_query。

回應欄位

欄位	類型	傳送	含義
`market`	一律為 "us"	固定回傳	已排名的市場。
`direction`	下列其一：gainers、losers、active	固定回傳	所請求的排名類型。
`movers`	物件陣列	固定回傳	最多 25 筆，名次最前者在先。僅納入股價在 $1 以上、今日成交至少 100,000 股且成交金額至少 $1 million 的普通股與 ETF。
`movers[].id`	字串	固定回傳	標準標的 ID。
`movers[].symbol`	字串	固定回傳	該交易所上的股票代號。
`movers[].name`	字串	固定回傳	公司或基金名稱。
`movers[].price`	字串	固定回傳	最新價格，以美元計。
`movers[].change_percent`	字串	固定回傳	相對於前一日收盤價的漲跌幅，以百分比表示（31.4 代表 31.4%），小數 2 位。
`movers[].volume`	字串	固定回傳	今日成交股數。
`timestamp`	日期時間	固定回傳	清單中最新一筆價格的有效時間（UTC）。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/movers?market=us&direction=gainers"

{
  "market": "us",
  "direction": "gainers",
  "movers": [
    {
      "id": "XNAS:NVDA",
      "symbol": "NVDA",
      "name": "NVIDIA Corporation",
      "price": "188.20",
      "change_percent": "4.12",
      "volume": "152003400"
    }
  ],
  "timestamp": "2026-10-26T15:42:00Z"
}

單一股票的價格 K 線

GET /v1/equities/{id}/bars

日 K 線（1d）或 1 分鐘 K 線（1m），由舊到新排列，已依股票分割與股利調整。歷史範圍：所有帳號皆可取得全部資料。1 分鐘 K 線可回溯到 2020 年，每次呼叫最多涵蓋 5 天（400 range_too_large）。當日的日 K 線在交易所收盤後才會出現。每頁最多 5,000 根 K 線，並附 next_cursor；游標與價格不再相符時回傳 409 cursor_expired。每頁計為一次呼叫。

K 線已依股票分割與股利調整。若在兩頁之間因分割或股利而使歷史資料改變，游標會失效並回傳 409 cursor_expired。

MCP：工具 equities, action bars。

參數

參數	位置	必填	類型	含義
`id`	path	是	字串	標的 ID：交易所的四個字母代碼、冒號與股票代號，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應會附上標準 ID。股別以句點表示（BRK.B），也接受 BRK-B。
`interval`	query	否	下列其一：1d、1m	`1d`（每個交易時段一根 K 線）或 `1m`（1 分鐘 K 線）。其他值回傳 400 invalid_interval。
`start`	query	否	字串	第一根 K 線。`1d`：日期（YYYY-MM-DD），含該日；省略時為最舊的一根。`1m`：UTC 時間（YYYY-MM-DDTHH:MM:SSZ，或以日期代表 UTC 00:00），含該時間；省略時為 `end` 的前一天。
`end`	query	否	字串	最後一根 K 線。`1d`：日期，含該日；省略時為已有 K 線的最新交易日。`1m`：UTC 時間，不含該時間；省略時為現在，或 `start` 之後五天。`1m` 的 `start` 與 `end` 相隔最多 5 天（400 range_too_large）。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。游標背後的價格改變（股票分割或股利）時會失效：409 cursor_expired。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	標準標的 ID。
`currency`	字串	固定回傳	所有價格的幣別。便士會換算為英鎊。
`adjusted`	布林值	固定回傳	一律為 true：價格已依股票分割與股利調整。相鄰兩頁的資料保持一致；若在兩頁之間因分割或股利而使歷史資料改變，游標會失效（409 cursor_expired），不會混用兩種資料。
`start`	字串	選填	不會回傳：`start` 不會被調整。
`end`	字串	選填	不會回傳：日 K 線不會被截斷。
`bars`	物件陣列	固定回傳	每頁最多 5,000 根 K 線。
`bars[].date`	字串	選填	交易日（YYYY-MM-DD）。僅日 K 線有，1 分鐘 K 線省略。
`bars[].timestamp`	日期時間	固定回傳	K 線期間的起點（UTC）：日 K 線為交易所開盤時間，1 分鐘 K 線為該分鐘。
`bars[].open`	字串	固定回傳	期間的第一個價格。
`bars[].high`	字串	固定回傳	期間的最高價。
`bars[].low`	字串	固定回傳	期間的最低價。
`bars[].close`	字串	固定回傳	期間的最後價格。
`bars[].volume`	字串	選填	該期間的成交股數。未知時省略。
`next_cursor`	字串	固定回傳	傳回此值即可讀取下一頁。最後一頁為 null。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/bars?interval=1d&start=2026-10-01"

{
  "id": "XNAS:MSFT",
  "currency": "USD",
  "adjusted": true,
  "bars": [
    {
      "date": "2026-10-23",
      "timestamp": "2026-10-23T13:30:00Z",
      "open": "417.10",
      "high": "420.55",
      "low": "415.80",
      "close": "418.90",
      "volume": "21034500"
    }
  ],
  "next_cursor": null
}

單一股票的股利

GET /v1/equities/{id}/dividends

單一標的的現金股利，依除息日由新到舊排列，分頁回傳。清單可能包含已公告的未來資料列。所有帳號皆可取得完整歷史。即將發生的資料列不會被截掉。每次請求計為一次呼叫。未知的 ID 回傳 404 not_found；尚無資料的市場回傳 404 not_covered。

MCP：工具 equities, action dividends。

參數

參數	位置	必填	類型	含義
`id`	path	是	字串	標的 ID：交易所的四個字母代碼、冒號與股票代號，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應會附上標準 ID。股別以句點表示（BRK.B），也接受 BRK-B。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	標準標的 ID。
`start`	日期	選填	不會回傳：所有帳號皆可取得完整歷史。
`dividends`	物件陣列	固定回傳	依除息日由新到舊排列。可能包含已公告的未來資料列。
`dividends[].ex_date`	日期	固定回傳	股票開始不含該筆股利交易的第一天。
`dividends[].amount`	字串	固定回傳	每股股利，以 `currency` 計。
`dividends[].currency`	字串	固定回傳	`amount` 的幣別。便士會換算為英鎊。
`dividends[].pay_date`	日期	選填	發放日。未知時省略。
`dividends[].record_date`	日期	選填	股東須登記在冊的日期。未知時省略。
`next_cursor`	字串	固定回傳	作為 `cursor` 傳入即可取得下一頁；最後一頁為 null。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/dividends"

{
  "id": "XNAS:MSFT",
  "dividends": [
    {
      "ex_date": "2026-08-20",
      "amount": "0.91",
      "currency": "USD",
      "pay_date": "2026-09-10",
      "record_date": "2026-08-20"
    }
  ],
  "next_cursor": null
}

單一股票的股票分割

GET /v1/equities/{id}/splits

單一標的的股票分割，由新到舊排列。所有帳號皆可取得完整歷史。即將發生的資料列不會被截掉。每次請求計為一次呼叫。未知的 ID 回傳 404 not_found；尚無資料的市場回傳 404 not_covered。

MCP：工具 equities, action splits。

參數

參數	位置	必填	類型	含義
`id`	path	是	字串	標的 ID：交易所的四個字母代碼、冒號與股票代號，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應會附上標準 ID。股別以句點表示（BRK.B），也接受 BRK-B。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	標準標的 ID。
`start`	日期	選填	不會回傳：所有帳號皆可取得完整歷史。
`splits`	物件陣列	固定回傳	由新到舊排列。
`splits[].date`	日期	固定回傳	股票開始以分割後基準交易的第一天。
`splits[].ratio`	字串	固定回傳	新股對舊股的比例：10:1 表示每持有一股可得十股；1:10 為反向分割。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/XNAS:NFLX/splits"

{
  "id": "XNAS:NFLX",
  "splits": [
    {
      "date": "2025-11-17",
      "ratio": "10:1"
    }
  ]
}

單一股票的財報

GET /v1/equities/{id}/earnings

單一標的已公布的財報（在交易所當地日期為今日或更早），含預估值、實際值與意外幅度，由新到舊排列，分頁回傳。尚未提供即將公布的財報日期。surprise_percent 以百分比表示。eps_actual 採市場資料口徑，可能與估值中的申報文件 EPS 不同。若我們持有，filing_id 會指出涵蓋該筆財報的年報或季報。所有帳號皆可取得完整歷史。每次請求計為一次呼叫。未知的 ID 回傳 404 not_found；尚無資料的市場回傳 404 not_covered。

此路由只回傳已公布的財報，尚未提供即將公布的財報日期。

filing_id 將已公布的財報連結到涵蓋它的申報文件。可將它傳給 Filings API 的 GET /v1/filings/{filing_id}。

MCP：工具 equities, action earnings。

參數

參數	位置	必填	類型	含義
`id`	path	是	字串	標的 ID：交易所的四個字母代碼、冒號與股票代號，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應會附上標準 ID。股別以句點表示（BRK.B），也接受 BRK-B。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	標準標的 ID。
`start`	日期	選填	不會回傳：所有帳號皆可取得完整歷史。
`earnings`	物件陣列	固定回傳	僅含已公布的財報，由新到舊排列。尚未提供即將公布的財報日期。
`earnings[].date`	日期	固定回傳	財報公布日（在交易所當地日期為今日或更早）。
`earnings[].time`	下列其一：before_open、after_close、during	選填	當日公布的時段。未知時省略。
`earnings[].eps_estimate`	字串	選填	分析師預估的每股盈餘。沒有時省略。
`earnings[].eps_actual`	字串	選填	採市場資料口徑公布的每股盈餘，可能與估值中 `eps_ttm` 的申報文件 EPS 不同。公布前省略。
`earnings[].surprise`	字串	選填	`eps_actual` 減去 `eps_estimate`，四捨五入至小數 2 位。
`earnings[].surprise_percent`	字串	選填	`surprise` 占預估值的百分比（8.31 代表 8.31%），小數 2 位。
`earnings[].filing_id`	字串	選填	我們的申報資料中涵蓋這筆財報的年報、半年報或季報：可傳給 Filings 的 `GET /v1/filings/{filing_id}`。公司沒有對應的申報資料，或沒有符合該日期的報告時省略。
`next_cursor`	字串	固定回傳	作為 `cursor` 傳入即可取得下一頁；最後一頁為 null。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/earnings"

{
  "id": "XNAS:MSFT",
  "earnings": [
    {
      "date": "2026-07-29",
      "time": "after_close",
      "eps_estimate": "3.31",
      "eps_actual": "3.45",
      "surprise": "0.14",
      "surprise_percent": "4.23",
      "filing_id": "usa:0000789019:0000950170-26-000123"
    }
  ],
  "next_cursor": null
}

單一股票的市值、P/E、P/S、P/B 與股息殖利率

GET /v1/equities/{id}/valuation

單一美國或韓國標的的市值（最新價格乘以流通在外股數）、P/E（最新價格除以公司申報文件中近 12 個月的稀釋後 EPS，依 GAAP 或 IFRS 原始申報）、P/S（市值除以近 12 個月營收）、P/B（市值除以最新資產負債表的權益總額）與股息殖利率（近 12 個月每股股利除以價格，以百分比表示），並附上輸入項與其對應日期。韓國目前僅提供 P/E；市值、P/S、P/B 與殖利率待取得股數與股利後提供。無法正確計算的數字會省略，不會以 0 回傳：股數日期之後發生股票分割時的市值、多個股別但各自沒有股數時的市值，以及存託憑證或外國申報公司的市值；EPS 為負值或低於 0.01、以其他幣別申報，或為存託憑證時的 P/E。同一公司的其他股別（例如特別股）沒有自己的數字，也不會顯示。美國與韓國以外的標的，或無法明確對應公司的標的，回傳 404 not_covered。計為一次呼叫。

每個比率都附有其輸入項與對應的日期：shares_as_of、eps_period_end、revenue_period_end、equity_as_of 與 dividends_period_end。

MCP：工具 equities, action valuation。

參數

參數	位置	必填	類型	含義
`id`	path	是	字串	標的 ID：交易所的四個字母代碼、冒號與股票代號，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應會附上標準 ID。股別以句點表示（BRK.B），也接受 BRK-B。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	標準標的 ID。
`currency`	字串	固定回傳	`market_cap` 的幣別，以及 `pe_ratio` 所用價格的幣別。
`market_cap`	字串	選填	最新價格乘以 `shares_outstanding`，以 `currency` 計，取整數單位。`shares_as_of` 之後發生股票分割、公司有多個股別但各自沒有股數，以及存託憑證或外國申報公司時省略。韓國尚無市值：其標的目前僅顯示 P/E。
`pe_ratio`	字串	選填	最新價格除以 `eps_ttm`，小數 2 位。`eps_ttm` 為負值或低於 0.01、申報幣別不是 `currency`、`eps_period_end` 之後發生股票分割，以及存託憑證時省略。
`ps_ratio`	字串	選填	股價營收比：`market_cap` 除以 `revenue_ttm`，小數 2 位。`market_cap` 省略時一併省略，營收不大於 0 或以 `currency` 以外的幣別申報時也省略。
`pb_ratio`	字串	選填	股價淨值比：`market_cap` 除以 `total_equity`，小數 2 位。`market_cap` 省略時一併省略，權益總額為 0 或負值，或以 `currency` 以外的幣別申報時也省略。
`dividend_yield`	字串	選填	近 12 個月每股股利除以最新價格，以百分比表示（0.71 代表 0.71%），小數 2 位。這 12 個月沒有股利紀錄（包含不配息的公司）、`dividends_period_end` 之後發生股票分割、股利幣別不是 `currency`，以及存託憑證時省略。
`shares_outstanding`	字串	選填	公司主要普通股別的流通在外股數。若標的屬於其他股別（例如特別股），此處沒有股數，故省略。
`shares_as_of`	日期	選填	`shares_outstanding` 的計算基準日。有股數時一併顯示。
`eps_ttm`	字串	選填	公司申報文件中近 12 個月的稀釋後 EPS（依 GAAP 或 IFRS 原始申報）；第四季為全年數字減去前三季。能計算時一律顯示；標的屬於公司其他股別時省略。它可能與股票財報中採市場資料口徑的 `eps_actual` 不同。
`eps_period_end`	日期	選填	`eps_ttm` 所含最新一季的結束日。`eps_ttm` 有值時一併顯示。
`revenue_ttm`	字串	選填	公司申報文件中近 12 個月的營收，以申報幣別的整數單位表示（第四季為全年數字減去前三季）。沒有完整四季或全年資料，以及標的屬於公司其他股別時省略。
`revenue_period_end`	日期	選填	`revenue_ttm` 所含最新一季的結束日。有值時一併顯示。
`total_equity`	字串	選填	最新資產負債表的權益總額，含非控制權益，以申報幣別的整數單位表示。可能為負值。
`equity_as_of`	日期	選填	`total_equity` 的資產負債表日期。有值時一併顯示。
`dividend_per_share_ttm`	字串	選填	主要普通股別近 12 個月宣告的每股股利，以申報幣別計。能計算時一律顯示。
`dividends_period_end`	日期	選填	`dividend_per_share_ttm` 所含最新一季的結束日。有值時一併顯示。
`company_id`	字串	固定回傳	標的所對應到的我們申報資料中的公司。
`timestamp`	日期時間	固定回傳	此回應所用價格的有效時間（UTC）。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/valuation"

{
  "id": "XNAS:MSFT",
  "currency": "USD",
  "market_cap": "3130000000000",
  "pe_ratio": "33.50",
  "ps_ratio": "11.40",
  "pb_ratio": "10.20",
  "dividend_yield": "0.86",
  "shares_outstanding": "7430000000",
  "shares_as_of": "2026-07-24",
  "eps_ttm": "12.58",
  "eps_period_end": "2026-06-30",
  "revenue_ttm": "274500000000",
  "revenue_period_end": "2026-06-30",
  "total_equity": "307000000000",
  "equity_as_of": "2026-06-30",
  "dividend_per_share_ttm": "3.64",
  "dividends_period_end": "2026-06-30",
  "company_id": "usa:0000789019",
  "timestamp": "2026-10-26T15:42:00Z"
}

單一股票的 Beta、股權成本、債務成本與 WACC

GET /v1/equities/{id}/cost-of-capital

單一美國或韓國股票相對於基準 ETF 的 Beta（預設使用兩年的週報酬，價格已依股票分割與股利調整）、無風險利率（該國政府殖利率曲線的 10 年期點位，或由你提供）、股權成本（無風險利率加上 Beta 乘以股權風險溢酬：你以 erp 傳入，或預設採用我們公布的該國總溢酬）、債務成本（公司申報文件中的利息費用除以平均總債務；無法使用時，改以無風險利率加上公開表格中對應公司利息保障倍數的預設利差；提供稅前與稅後數字，稅率採公開表格中的該國企業稅率，除非你傳入 tax_rate），以及依市值與總債務加權的 WACC。回應中每個輸入項都附有數值、依據與日期。銀行與保險公司回傳 422 not_applicable；無法正確計算的輸入項會列在 422 inputs_unavailable 中，不會自行修補；有顯示但需留意的數字會附上 warnings 項目。計為一次呼叫。

必須提供 erp。此處沒有韓國的殖利率曲線，因此韓國股票需傳入 risk_free。每個輸入項都附有數值與日期，warnings 會列出在採用前需要確認的數字。

MCP：工具 equities, action cost_of_capital。

參數

參數	位置	必填	類型	含義
`id`	path	是	字串	標的 ID：交易所的四個字母代碼、冒號與股票代號，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應會附上標準 ID。股別以句點表示（BRK.B），也接受 BRK-B。
`erp`	query	否	字串	你的股權風險溢酬，以百分比表示（5 代表 5%）。省略時採用我們公布的該股票所屬國家的總股權風險溢酬（回應會註明其日期與依據）。我們沒有公布的國家，若未提供則回傳 400 erp_required。須大於 0 且不超過 25。
`benchmark`	query	否	字串	計算 Beta 所對照的市場代表標的 ID：與該股票同幣別計價的 ETF、基金或股票。省略時，美國股票用 ARCX:SPY，韓國股票用 XKRX:069500，日本股票用 XTKS:1306；其他市場必須提供。
`window`	query	否	下列其一：2y、5y	報酬率回溯的期間：`2y`（預設）或 `5y`。
`frequency`	query	否	下列其一：weekly、monthly	報酬率的間隔：`weekly`（預設；取每個 ISO 週的最後一個共同交易日）或 `monthly`。
`beta`	query	否	下列其一：raw、adjusted	股權成本採用哪一種 Beta：`raw`（預設）或 `adjusted`（0.67 乘以原始值再加 0.33）。兩者一律都會出現在回應中。
`risk_free`	query	否	字串	你自己的無風險利率，以百分比表示。省略時採用該國政府殖利率曲線的 10 年期點位。我們沒有曲線的地區（韓國）必須提供：未提供時回傳 422 risk_free_unavailable。
`tax_rate`	query	否	字串	你自己用於債務稅盾的稅率，以百分比表示。省略時採用 Damodaran 公開表格中該股票所屬國家的企業稅率（PwC 稅率）。範圍為 0 至 60。
`period`	query	否	下列其一：ttm、annual	利息費用的期間：近 12 個月（`ttm`，預設）或最近一個完整會計年度（`annual`）。韓國與日本只有年度數字，因此使用 `annual`。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	標準標的 ID。
`currency`	字串	固定回傳	金額欄位的幣別。
`company_id`	字串	固定回傳	標的所對應到的我們申報資料中的公司。
`beta`	對象	固定回傳
`beta.benchmark`	對象	固定回傳
`beta.benchmark.id`	字串	固定回傳	基準標的的 ID。
`beta.benchmark.default`	一律為 true	選填	基準為我們針對該股票所屬市場的預設值時，會出現並為 true。
`beta.window`	下列其一：2y、5y	固定回傳
`beta.frequency`	下列其一：weekly、monthly	固定回傳
`beta.start`	日期	固定回傳	第一筆報酬率所對應的第一個價格的日期。
`beta.end`	日期	固定回傳	最後一筆報酬率所對應的最後一個價格的日期。
`beta.observations`	整數	固定回傳	迴歸中使用的報酬率筆數。
`beta.raw`	字串	固定回傳	股票報酬率對基準報酬率的迴歸斜率，兩者所用的價格皆已依股票分割與股利調整。
`beta.adjusted`	字串	固定回傳	0.67 乘以 `raw` 再加 0.33。
`beta.used`	下列其一：raw、adjusted	固定回傳	`cost_of_equity` 所採用的 Beta。
`beta.r_squared`	字串	固定回傳	可解釋股票變異數的比例。
`beta.std_error`	字串	固定回傳	`raw` 的標準誤。
`risk_free`	對象	固定回傳
`risk_free.rate`	字串	固定回傳	無風險利率，以百分比表示（4.25 代表 4.25%）。
`risk_free.source`	下列其一：yield_curve、caller	固定回傳
`risk_free.basis`	下列其一：ours、caller	固定回傳	`ours`：我們公布的官方政府殖利率曲線。`caller`：由你提供。
`risk_free.country`	字串	選填	殖利率曲線所屬國家。`caller` 時不會回傳。
`risk_free.maturity`	一律為 "10y"	選填	曲線上的點位。`caller` 時不會回傳。
`risk_free.tenor`	一律為 "P10Y"	選填	`maturity` 的 ISO 8601 期間表示。`caller` 時不會回傳。
`risk_free.curve_type`	字串	選填	曲線的報價方式（平價、零息、Svensson、到期殖利率），各國略有不同。`caller` 時不會回傳。
`risk_free.as_of`	日期	選填	曲線的日期。`caller` 時不會回傳。
`equity_risk_premium`	對象	固定回傳
`equity_risk_premium.rate`	字串	固定回傳	股權風險溢酬，以百分比表示（4.25 代表 4.25%）。
`equity_risk_premium.source`	下列其一：narwhal、caller	固定回傳	由誰設定：`narwhal` 為我們公布的該股票所屬國家的總股權風險溢酬，`caller` 為你傳入的 `erp`。
`equity_risk_premium.country`	字串	選填	我們的溢酬所屬國家，ISO 3166-1 alpha-3。僅限 `narwhal`。
`equity_risk_premium.as_of`	日期	選填	我們的溢酬所對應的日期。僅限 `narwhal`。
`equity_risk_premium.basis`	下列其一：observed、modelled、table	選填	我們的總溢酬如何建立：`observed` 來自我們自己的資料，`modelled` 由我們的利差模型推估，`table` 的國家部分取自公開表格。僅限 `narwhal`。
`cost_of_equity`	字串	固定回傳	無風險利率加上 Beta 乘以股權風險溢酬，以百分比表示（4.25 代表 4.25%）。
`cost_of_debt`	對象	選填	公司沒有債務紀錄時省略。
`cost_of_debt.pre_tax`	字串	固定回傳	利息費用除以平均總債務，以百分比表示（4.25 代表 4.25%）。無法使用（利息不為正，或結果低於 0.1% 或高於 30%）且有 EBIT 紀錄時，改用無風險利率加上公開表格中對應公司利息保障倍數的預設利差；由 `basis` 說明採用哪一種。
`cost_of_debt.basis`	下列其一：ours、table	固定回傳	`ours`：公司申報文件中的利息費用除以平均債務。`table`：無風險利率加上表格中的預設利差。
`cost_of_debt.interest_coverage`	字串	選填	EBIT 除以利息費用。僅限 `table`；沒有利息時省略。
`cost_of_debt.default_spread`	字串	選填	該利息保障倍數對應的預設利差，以百分比表示（4.25 代表 4.25%）。僅限 `table`。
`cost_of_debt.table`	字串	選填	利差表格的名稱。僅限 `table`。
`cost_of_debt.table_update`	字串	選填	表格的更新時間，例如 `January 2026`。僅限 `table`。
`cost_of_debt.table_url`	字串	選填	表格的公布位置。僅限 `table`。
`cost_of_debt.after_tax`	字串	選填	`pre_tax` 乘以（1 減稅率）。稅率未知時省略。
`cost_of_debt.period`	下列其一：ttm、annual	固定回傳
`cost_of_debt.period_end`	日期	固定回傳	利息所含最新一季或一年的結束日。
`cost_of_debt.interest_expense`	字串	固定回傳	該期間的利息費用，以 `currency` 的整數單位表示。
`cost_of_debt.average_debt`	字串	固定回傳	期初與期末總債務的平均值；沒有期初紀錄時僅用期末餘額。以 `currency` 的整數單位表示，不含租賃。
`cost_of_debt.opening_debt`	字串	選填	`period_end` 一年前的總債務。沒有紀錄時省略。
`cost_of_debt.closing_debt`	字串	固定回傳	`period_end` 當日的總債務。
`tax_rate`	對象	選填	該國在表格中沒有稅率時省略。可傳入 `tax_rate` 自行設定。
`tax_rate.rate`	字串	固定回傳	債務適用的稅率，以百分比表示（4.25 代表 4.25%）。
`tax_rate.basis`	下列其一：table、caller	固定回傳	`table`：公開表格中的該國稅率。`caller`：由你提供。
`tax_rate.source`	下列其一：country_table、caller	固定回傳	`country_table`：公開表格中該股票所屬國家的企業稅率。`caller`：你傳入的 `tax_rate`。
`tax_rate.country`	字串	選填	稅率所屬國家的 ISO 3166-1 alpha-3 代碼。僅限表格稅率。
`tax_rate.table`	字串	選填	表格名稱，含發布者與來源。僅限表格稅率。
`tax_rate.table_update`	字串	選填	稅率所取自表格的更新時間，例如 `January 2026`。
`tax_rate.table_url`	字串	選填	表格的公布位置。僅限表格稅率。
`weights`	對象	固定回傳
`weights.equity`	字串	固定回傳	市值除以（市值加債務），以百分比表示（4.25 代表 4.25%）。
`weights.debt`	字串	固定回傳	債務除以（市值加債務），以百分比表示（4.25 代表 4.25%）。
`weights.market_cap`	字串	固定回傳	最新價格乘以流通在外股數，以 `currency` 的整數單位表示。
`weights.market_cap_as_of`	日期時間	固定回傳	`market_cap` 所用價格的有效時間。
`weights.total_debt`	字串	固定回傳	最新的總債務紀錄，以 `currency` 的整數單位表示，不含租賃。
`weights.total_debt_as_of`	日期	固定回傳	`total_debt` 的資產負債表日期。
`wacc`	字串	選填	加權平均資金成本，以百分比表示（4.25 代表 4.25%）。沒有債務的公司等於 `cost_of_equity`。有債務但稅率未知時省略。
`warnings`	物件陣列	固定回傳	使用這些數字前需要確認的事項。沒有時為空。
`warnings[].code`	字串	固定回傳	穩定且可供程式讀取的代碼。
`warnings[].message`	字串	固定回傳	以白話說明其意義。
`methodology_url`	字串	固定回傳	每個數字的計算方式。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/cost-of-capital?erp=5"

{
  "id": "XNAS:MSFT",
  "currency": "USD",
  "company_id": "usa:0000789019",
  "beta": {
    "benchmark": {
      "id": "ARCX:SPY",
      "default": true
    },
    "window": "2y",
    "frequency": "weekly",
    "start": "2024-10-25",
    "end": "2026-10-16",
    "observations": 103,
    "raw": "1.0842",
    "adjusted": "1.0564",
    "used": "raw",
    "r_squared": "0.5731",
    "std_error": "0.0894"
  },
  "risk_free": {
    "rate": "4.1200",
    "source": "yield_curve",
    "basis": "ours",
    "country": "USA",
    "maturity": "10y",
    "curve_type": "nominal_par",
    "as_of": "2026-10-22"
  },
  "equity_risk_premium": {
    "rate": "5.0000",
    "source": "caller"
  },
  "cost_of_equity": "9.5410",
  "cost_of_debt": {
    "pre_tax": "3.9100",
    "basis": "ours",
    "after_tax": "2.9078",
    "period": "ttm",
    "period_end": "2026-06-30",
    "interest_expense": "2900000000",
    "average_debt": "74200000000",
    "opening_debt": "72000000000",
    "closing_debt": "76400000000"
  },
  "tax_rate": {
    "rate": "25.6300",
    "source": "country_table",
    "basis": "table",
    "country": "USA",
    "table": "Damodaran, corporate marginal tax rates by country (PwC, January 2026 update)",
    "table_update": "January 2026",
    "table_url": "https://pages.stern.nyu.edu/~adamodar/New_Home_Page/datafile/countrytaxrates.html"
  },
  "weights": {
    "equity": "98.0000",
    "debt": "2.0000",
    "market_cap": "3893412000000",
    "market_cap_as_of": "2026-10-26T15:42:00Z",
    "total_debt": "76400000000",
    "total_debt_as_of": "2026-06-30"
  },
  "wacc": "9.4083",
  "warnings": [],
  "methodology_url": "https://narwhalapi.com/methodology/cost-of-capital"
}

單一股票的估值歷史

GET /v1/equities/{id}/valuation/history

單一美國或韓國標的在每個會計期間結束日（季末或年末）的市值、P/E、P/S、P/B 與股息殖利率，由舊到新排列。每個資料點採用當日或之前最近一個交易日的收盤價（僅依股票分割調整），以及該期間申報的數字（近 12 個月的 EPS、營收與股利、權益總額、最接近的股數），因此後續的重編也會反映其中。無法計算的數字會省略，不會以 0 回傳，規則與估值相同。歷史範圍：所有帳號皆可取得全部資料。美國與韓國以外的標的，或無法明確對應公司的標的，回傳 404 not_covered。計為一次呼叫。

MCP：工具 equities, action valuation_history。

參數

參數	位置	必填	類型	含義
`id`	path	是	字串	標的 ID：交易所的四個字母代碼、冒號與股票代號，例如 XNAS:MSFT 或 XNYS:BRK.B。只給美國股票代號（例如 MSFT）時，若僅對應一個美國標的也可使用，回應會附上標準 ID。股別以句點表示（BRK.B），也接受 BRK-B。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	標準標的 ID。
`currency`	字串	固定回傳	所有價格與市值的幣別。
`company_id`	字串	固定回傳	標的所對應到的我們申報資料中的公司。
`start`	日期	選填	不會回傳：所有帳號皆可取得完整歷史。
`points`	物件陣列	固定回傳	公司每個會計期間結束日各有一個資料點，由舊到新排列。每個資料點由該期間申報的數字與當日價格計算而得，並非依當時已知的資訊：後續的重編也會反映其中。沒有價格或沒有任何數字的期間不會有資料點。
`points[].date`	日期	固定回傳	公司的會計期間結束日（季末或年末）：此資料點的所有數字皆以這一天為基準。
`points[].price`	字串	選填	`price_date` 的收盤價，以 `currency` 計，僅依股票分割調整（不依股利調整），因此與今日的股份基準一致。目前無法讀取該期間的價格時，此欄與以下所有數字一併省略，請稍後再試。
`points[].price_date`	日期	選填	價格所屬的交易日：`date` 當日或之前最近的一個交易日（最多提早 7 天）。
`points[].market_cap`	字串	選填	`price` 乘以最接近 `date` 的股數（在其前 130 天到後 45 天內計算），採今日的股份基準，以 `currency` 的整數單位表示。沒有這樣的股數、多個股別但各自沒有股數，以及存託憑證或外國申報公司時省略。
`points[].pe_ratio`	字串	選填	`price` 除以截至 `date` 的四個季度的稀釋後 EPS，小數 2 位。EPS 為負值或低於 0.01、未以 `currency` 申報、沒有截至 `date` 的四個季度（或全年）資料，以及存託憑證時省略。
`points[].ps_ratio`	字串	選填	`market_cap` 除以截至 `date` 的四個季度營收，小數 2 位。`market_cap` 省略時一併省略，營收沒有紀錄、不大於 0 或不是以 `currency` 申報時也省略。
`points[].pb_ratio`	字串	選填	`market_cap` 除以日期為 `date` 的資產負債表的權益總額，小數 2 位。`market_cap` 省略時一併省略，權益沒有紀錄、不大於 0 或不是以 `currency` 申報時也省略。
`points[].dividend_yield`	字串	選填	截至 `date` 的四個季度每股股利除以 `price`，以百分比表示（0.71 代表 0.71%），小數 2 位。這些季度沒有股利紀錄、股利不是以 `currency` 計，以及存託憑證時省略。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/valuation/history"

{
  "id": "XNAS:MSFT",
  "currency": "USD",
  "company_id": "usa:0000789019",
  "points": [
    {
      "date": "2026-06-30",
      "price": "497.40",
      "price_date": "2026-06-30",
      "market_cap": "3697000000000",
      "pe_ratio": "39.54",
      "ps_ratio": "13.47",
      "pb_ratio": "12.04",
      "dividend_yield": "0.73"
    }
  ]
}

錯誤

錯誤使用共用的問題格式，並包含 request_id。查看 API 錯誤處理：錯誤碼、額度與重試了解格式與額度標頭。失敗的請求不計費。

代碼	狀態	含義
`invalid_query`	400	參數缺漏、未知、重複，或超出範圍。
`invalid_id`	400	id 或交易對的寫法不符合此 API 的要求。
`too_many_ids`	400	批次包含超過 50 個 id。
`invalid_interval`	400	間隔不是 1d 或 1m，或此商品不支援該間隔。
`range_too_large`	400	區間超過此路由允許的長度。
`not_found`	404	沒有此標的、基金或交易對。
`not_covered`	404	尚未支援此市場、國家或公司。
`invalid_cursor`	400	此游標不是這個請求所回傳的，或來自不同的請求。
`cursor_expired`	409	游標所對應的價格已變動。請不帶游標重新開始。
`insufficient_credits`	402	您的額度餘額不足以支付此請求的費用。
`upstream_busy`	503	目前無法取得價格。在批次中會列在 errors。請稍後再試。
`area_unavailable`	503	此區域目前無法回應。
`erp_required`	400	請傳入 erp，即以百分比表示的股權風險溢酬。
`insufficient_history`	422	該股票與其基準共有的報酬率筆數，少於區間的 80%。
`risk_free_unavailable`	422	此國家沒有殖利率曲線。請傳入 risk_free。
`not_applicable`	422	WACC 對銀行或保險公司沒有意義。
`currency_mismatch`	422	基準或申報文件的幣別與價格不同。
`inputs_unavailable`	422	某個輸入無法正確計算。detail 會指出是哪一個。

此頁面對你有幫助嗎?