股票数据接口参考
上市股票的价格、历史、公司事件和估值比率
概览
上市股票的价格、历史价格、公司事件、市值和估值比率。每个请求都需要 Bearer 密钥,REST 与 MCP 共用同一个额度余额。
标的 id 由交易所的四位字母代码、冒号和股票代码组成,例如 XNAS:MSFT 或 XNYS:BRK.B。当单独的美股代码(如 MSFT)只对应一个美国标的时,也可以直接使用,返回结果中始终带有规范 id。价格和金额均为十进制字符串。
每个标的可以带有 company_id。它把标的关联到 Filings API 中的公司,因此价格、估值和财务报表可以通过同一个 id 对应起来。
基础 URL: https:/。 MCP 工具是 equities, with one action ,适用于下方每个路由。
A company_ 把标的关联到 披露文件 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_。数据来自我们自己的代码列表,所有账户均可使用,计 1 次调用。
MCP:工具 equities, action search。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
q | 查询参数 | 是 | 字符串 | 股票代码或公司名称的开头,不区分大小写,至少 2 个字符(例如 ms 或 micro)。排序:完全匹配的代码、其他代码、名称开头、名称中后续单词的开头;每一组内美国主上市标的优先。 |
country | 查询参数 | 否 | 字符串 | 只返回该国家的标的,三位字母(USA、KOR)。 |
type | 查询参数 | 否 | 取值之一:common_stock、preferred_stock、depositary_receipt、reit、closed_end_fund、unit、right、warrant、other | 只返回该类型的标的。 |
cursor | 查询参数 | 否 | 字符串 | 上一页返回的 next_,其他参数保持不变。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
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,仅在标的能明确匹配到公司时返回。 |
next_ | 字符串 | 总是 | 回传该值即可读取下一页。最后一页为 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_。所有账户均可使用。日本标的只包含名称、交易所、国家、币种和 company_。未知的字段会被省略。
MCP:工具 equities, action profile。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
id | 路径参数 | 是 | 字符串 | 标的 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_ | 字符串 | 可选 | 我们自己保存的公司标志图。没有时省略。 |
company_ | 字符串 | 可选 | 公司的财报 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_ 以百分比表示。未知的 id 返回 404 not_found;尚无价格数据的市场返回 404 not_covered。
MCP:工具 equities, action price。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
id | 路径参数 | 是 | 字符串 | 标的 id:交易所的四位字母代码、冒号和股票代码,例如 XNAS:MSFT 或 XNYS:BRK.B。当单独的美股代码(如 MSFT)只对应一个美国标的时也可使用,返回结果带有规范 id。股份类别用点号表示(BRK.B),也接受 BRK-B。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
id | 字符串 | 总是 | 规范的标的 id。 |
symbol | 字符串 | 总是 | 该交易所上的股票代码。 |
currency | 字符串 | 总是 | 所有价格字段的币种。便士会换算为英镑。 |
price | 字符串 | 总是 | 最新成交价,单位为 currency。 |
previous_ | 字符串 | 可选 | 上一交易日的收盘价。未知时省略。 |
change | 字符串 | 可选 | price 减去 previous_。previous_ 省略时它也省略。 |
change_ | 字符串 | 可选 | 相对 previous_ 的涨跌幅,以百分比表示(1.5 表示 1.5%)。 |
volume | 字符串 | 可选 | 今日成交股数。未知时省略,延迟数据中一律省略。 |
market_ | 取值之一: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 计 1 次调用,并一次性扣除:如果余额不足以支付已解析的 id,整个请求会被拒绝并返回 402 insufficient_credits。未返回价格的 id 列在 errors 中,不计费。change_ 以百分比表示。
最多传入 50 个 id。批量请求一次性计费:如果余额不足以支付能解析出的 id,整个请求返回 402 insufficient_credits。
MCP:工具 equities, action prices。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
ids | 查询参数 | 是 | 字符串 | 以逗号分隔的标的 id,去重后最多 50 个。每个 id 的规则与单个价格路由相同。每个返回价格的 id 计 1 次调用。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
prices | 对象数组 | 总是 | 按 id 给出每个已解析 id 的价格。 |
prices[].id | 字符串 | 总是 | 规范的标的 id。 |
prices[].symbol | 字符串 | 总是 | 该交易所上的股票代码。 |
prices[].currency | 字符串 | 总是 | 所有价格字段的币种。便士会换算为英镑。 |
prices[].price | 字符串 | 总是 | 最新成交价,单位为 currency。 |
prices[].previous_ | 字符串 | 可选 | 上一交易日的收盘价。未知时省略。 |
prices[].change | 字符串 | 可选 | price 减去 previous_。previous_ 省略时它也省略。 |
prices[].change_ | 字符串 | 可选 | 相对 previous_ 的涨跌幅,以百分比表示(1.5 表示 1.5%)。 |
prices[].volume | 字符串 | 可选 | 今日成交股数。未知时省略,延迟数据中一律省略。 |
prices[].market_ | 取值之一: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 股且成交额至少 100 万美元的普通股和 ETF;由我们自行排名,缓存 10 分钟。change_ 以百分比表示。market 目前只能是 us,其他市场返回 404 not_covered,未知的 direction 返回 400 invalid_query。计 1 次调用。
涨跌榜仅支持美国市场。其他市场返回 404 not_covered。
MCP:工具 equities, action movers。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
market | 查询参数 | 否 | 字符串 | 要排名的市场。目前只支持 us,其他市场返回 404 not_covered。 |
direction | 查询参数 | 否 | 字符串 | gainers(涨幅最大)、losers(跌幅最大)或 active(当日涨幅和跌幅最大的股票中成交额最高者,不是全市场)。其他值返回 400 invalid_query。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
market | 恒为 "us" | 总是 | 所排名的市场。 |
direction | 取值之一:gainers、losers、active | 总是 | 请求的榜单类型。 |
movers | 对象数组 | 总是 | 最多 25 条,排名靠前者在先。仅包含价格不低于 1 美元、今日成交至少 100,000 股且成交额至少 100 万美元的普通股和 ETF。 |
movers[].id | 字符串 | 总是 | 规范的标的 id。 |
movers[].symbol | 字符串 | 总是 | 该交易所上的股票代码。 |
movers[].name | 字符串 | 总是 | 公司或基金名称。 |
movers[].price | 字符串 | 总是 | 最新价格,单位为美元。 |
movers[].change_ | 字符串 | 总是 | 相对上一收盘价的涨跌幅,以百分比表示(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_;与价格不再匹配的游标返回 409 cursor_expired。每页计 1 次调用。
K线已按拆股和分红调整。如果两次翻页之间发生拆股或分红导致历史数据变化,游标会失效并返回 409 cursor_expired。
MCP:工具 equities, action bars。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
id | 路径参数 | 是 | 字符串 | 标的 id:交易所的四位字母代码、冒号和股票代码,例如 XNAS:MSFT 或 XNYS:BRK.B。当单独的美股代码(如 MSFT)只对应一个美国标的时也可使用,返回结果带有规范 id。股份类别用点号表示(BRK.B),也接受 BRK-B。 |
interval | 查询参数 | 否 | 取值之一:1d、1m | 1d(每个交易日一根 K线)或 1m(1 分钟 K线)。其他值返回 400 invalid_interval。 |
start | 查询参数 | 否 | 字符串 | 第一根 K线。1d:日期(YYYY-MM-DD),包含该日;省略表示取最早的一根。1m:UTC 时间(YYYY-MM-DDTHH:MM:SSZ,或表示 UTC 00:00 的日期),包含该时刻;省略表示 end 之前一天。 |
end | 查询参数 | 否 | 字符串 | 最后一根 K线。1d:日期,包含该日;省略表示已出 K线的最近一个交易日。1m:UTC 时间,不包含该时刻;省略表示当前时间,或 start 之后五天。1m 的 start 与 end 之间最多相隔 5 天(400 range_too_large)。 |
cursor | 查询参数 | 否 | 字符串 | 上一页返回的 next_,其他参数保持不变。游标背后的价格发生变化(拆股或分红)时会失效: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_ | 字符串 | 总是 | 回传该值即可读取下一页。最后一页为 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
单个标的的现金分红,按除息日从新到旧排列,分页返回。列表可能包含已公布的未来记录。所有账户都能获取完整历史。未来记录不会被截掉。每个请求计 1 次调用。未知的 id 返回 404 not_found;尚无数据的市场返回 404 not_covered。
MCP:工具 equities, action dividends。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
id | 路径参数 | 是 | 字符串 | 标的 id:交易所的四位字母代码、冒号和股票代码,例如 XNAS:MSFT 或 XNYS:BRK.B。当单独的美股代码(如 MSFT)只对应一个美国标的时也可使用,返回结果带有规范 id。股份类别用点号表示(BRK.B),也接受 BRK-B。 |
cursor | 查询参数 | 否 | 字符串 | 上一页返回的 next_,其他参数保持不变。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
id | 字符串 | 总是 | 规范的标的 id。 |
start | 日期 | 可选 | 不返回:所有账户都能获取完整历史。 |
dividends | 对象数组 | 总是 | 按除息日从新到旧排列。可能包含已公布的未来记录。 |
dividends[].ex_ | 日期 | 总是 | 股票开始不含该笔分红交易的第一天(除息日)。 |
dividends[].amount | 字符串 | 总是 | 每股分红,单位为 currency。 |
dividends[].currency | 字符串 | 总是 | amount 的币种。便士会换算为英镑。 |
dividends[].pay_ | 日期 | 可选 | 发放日。未知时省略。 |
dividends[].record_ | 日期 | 可选 | 持有人须登记在册的日期(股权登记日)。未知时省略。 |
next_ | 字符串 | 总是 | 作为 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
单个标的的拆股记录,从新到旧排列。所有账户都能获取完整历史。未来记录不会被截掉。每个请求计 1 次调用。未知的 id 返回 404 not_found;尚无数据的市场返回 404 not_covered。
MCP:工具 equities, action splits。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
id | 路径参数 | 是 | 字符串 | 标的 id:交易所的四位字母代码、冒号和股票代码,例如 XNAS:MSFT 或 XNYS:BRK.B。当单独的美股代码(如 MSFT)只对应一个美国标的时也可使用,返回结果带有规范 id。股份类别用点号表示(BRK.B),也接受 BRK-B。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
id | 字符串 | 总是 | 规范的标的 id。 |
start | 日期 | 可选 | 不返回:所有账户都能获取完整历史。 |
splits | 对象数组 | 总是 | 从新到旧排列。 |
splits[].date | 日期 | 总是 | 股票开始按拆股后口径交易的第一天。 |
splits[].ratio | 字符串 | 总是 | 新股对旧股的比例:10:1 表示每持有 1 股得到 10 股;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_ 以百分比表示。eps_ 按市场数据口径计算,可能与估值中的财报 EPS 不同。当我们持有相应报告时,filing_ 指向涵盖该次财报的年报或季报。所有账户都能获取完整历史。每个请求计 1 次调用。未知的 id 返回 404 not_found;尚无数据的市场返回 404 not_covered。
此路由只返回已发布的财报,暂不包含即将发布的财报日期。
filing_id 把一份已发布的财报与涵盖它的披露文件关联起来。将它传给 Filings API 的 GET /v1/filings/{filing_id} 即可。
MCP:工具 equities, action earnings。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
id | 路径参数 | 是 | 字符串 | 标的 id:交易所的四位字母代码、冒号和股票代码,例如 XNAS:MSFT 或 XNYS:BRK.B。当单独的美股代码(如 MSFT)只对应一个美国标的时也可使用,返回结果带有规范 id。股份类别用点号表示(BRK.B),也接受 BRK-B。 |
cursor | 查询参数 | 否 | 字符串 | 上一页返回的 next_,其他参数保持不变。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
id | 字符串 | 总是 | 规范的标的 id。 |
start | 日期 | 可选 | 不返回:所有账户都能获取完整历史。 |
earnings | 对象数组 | 总是 | 只包含已发布的财报,从新到旧排列。暂不包含即将发布的财报日期。 |
earnings[].date | 日期 | 总是 | 财报发布日(按交易所所在地,今天或更早)。 |
earnings[].time | 取值之一:before_open、after_close、during | 可选 | 当天发布的时段。未知时省略。 |
earnings[].eps_ | 字符串 | 可选 | 分析师预期的每股收益。没有时省略。 |
earnings[].eps_ | 字符串 | 可选 | 按市场数据口径公布的每股收益,可能与估值中 eps_ 的财报 EPS 不同。公布之前省略。 |
earnings[].surprise | 字符串 | 可选 | eps_ 减去 eps_,保留 2 位小数。 |
earnings[].surprise_ | 字符串 | 可选 | surprise 占预期值的百分比(8.31 表示 8.31%),保留 2 位小数。 |
earnings[].filing_ | 字符串 | 可选 | 我们财报库中涵盖这次财报的年报、半年报或季报:将它传给 filings 的 GET /。公司没有匹配的财报,或没有报告与该日期吻合时省略。 |
next_ | 字符串 | 总是 | 作为 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。计 1 次调用。
每个比率都附带其输入项及对应日期:shares_as_of、eps_period_end、revenue_period_end、equity_as_of 和 dividends_period_end。
MCP:工具 equities, action valuation。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
id | 路径参数 | 是 | 字符串 | 标的 id:交易所的四位字母代码、冒号和股票代码,例如 XNAS:MSFT 或 XNYS:BRK.B。当单独的美股代码(如 MSFT)只对应一个美国标的时也可使用,返回结果带有规范 id。股份类别用点号表示(BRK.B),也接受 BRK-B。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
id | 字符串 | 总是 | 规范的标的 id。 |
currency | 字符串 | 总是 | market_ 以及 pe_ 所用价格的币种。 |
market_ | 字符串 | 可选 | 最新价格乘以 shares_,单位为 currency 的整数单位。在 shares_ 之后发生拆股、公司有多个股份类别但各自没有股本数、或为存托凭证或外国申报公司时省略。韩国暂无市值:其标的目前只显示 P/E。 |
pe_ | 字符串 | 可选 | 最新价格除以 eps_,保留 2 位小数。eps_ 为负数或小于 0.01、披露币种不是 currency、在 eps_ 之后发生拆股,以及存托凭证时省略。 |
ps_ | 字符串 | 可选 | 市销率:market_ 除以 revenue_,保留 2 位小数。market_ 省略时它也省略;营收不大于 0,或营收币种不是 currency 时同样省略。 |
pb_ | 字符串 | 可选 | 市净率:market_ 除以 total_,保留 2 位小数。market_ 省略时它也省略;总权益为 0 或负数,或币种不是 currency 时同样省略。 |
dividend_ | 字符串 | 可选 | 近 12 个月每股分红除以最新价格,以百分比表示(0.71 表示 0.71%),保留 2 位小数。这 12 个月没有分红记录(包括不分红的公司)、在 dividends_ 之后发生拆股、分红币种不是 currency,以及存托凭证时省略。 |
shares_ | 字符串 | 可选 | 公司主要普通股类别的流通股数。若标的属于其他类别(如优先股),此处没有股本数,则省略。 |
shares_ | 日期 | 可选 | shares_ 的统计日期。只要有股本数就会显示。 |
eps_ | 字符串 | 可选 | 来自公司财报的近 12 个月稀释后 EPS(按 GAAP 或 IFRS 原样披露);第四季度为全年数据减去前三个季度。只要能算出就会显示;若标的是公司的其他股份类别则省略。它可能与股票财报中的 eps_ 不同,后者按市场数据口径计算。 |
eps_ | 日期 | 可选 | eps_ 中最新一个季度的截止日。只要显示 eps_ 就会显示。 |
revenue_ | 字符串 | 可选 | 来自公司财报的近 12 个月营收,单位为披露币种的整数单位(第四季度为全年数据减去前三个季度)。没有连续四个季度或完整年度数据,以及标的是公司的其他股份类别时省略。 |
revenue_ | 日期 | 可选 | revenue_ 中最新一个季度的截止日。只要显示 revenue_ 就会显示。 |
total_ | 字符串 | 可选 | 最新资产负债表的总权益,含少数股东权益,单位为披露币种的整数单位。可能为负数。 |
equity_ | 日期 | 可选 | total_ 对应的资产负债表日期。只要显示 total_ 就会显示。 |
dividend_ | 字符串 | 可选 | 主要普通股类别近 12 个月宣告的每股分红,以披露币种计。只要能算出就会显示。 |
dividends_ | 日期 | 可选 | dividend_ 中最新一个季度的截止日。只要显示 dividend_ 就会显示。 |
company_ | 字符串 | 总是 | 该标的在我们财报库中匹配到的公司。 |
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_,否则税率取自公开表中该国的企业所得税率),以及按市值和总债务加权的 WACC。每个输入项都在结果中附带数值、依据和日期。银行和保险公司返回 422 not_applicable;无法正确算出的输入项会在 422 inputs_unavailable 中指明,绝不会自行修补;已显示但需谨慎对待的数字会附带一条 warnings。计 1 次调用。
erp 为必填。这里没有韩国的收益率曲线,因此韩国股票需要传入 risk_free。每个输入项都附带数值和日期,warnings 列出了在使用前需要核对的数字。
MCP:工具 equities, action cost_。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
id | 路径参数 | 是 | 字符串 | 标的 id:交易所的四位字母代码、冒号和股票代码,例如 XNAS:MSFT 或 XNYS:BRK.B。当单独的美股代码(如 MSFT)只对应一个美国标的时也可使用,返回结果带有规范 id。股份类别用点号表示(BRK.B),也接受 BRK-B。 |
erp | 查询参数 | 否 | 字符串 | 你的股权风险溢价,以百分比表示(5 表示 5%)。省略时使用我们公布的该股票所在国家的总股权风险溢价(结果中会注明其日期和依据)。我们没有公布该国溢价时,不传此参数会返回 400 erp_required。须大于 0 且不超过 25。 |
benchmark | 查询参数 | 否 | 字符串 | 计算 beta 时作为市场代表的标的 id:与该股票币种相同的 ETF、基金或股票。省略时,美国股票用 ARCX:SPY,韩国股票用 XKRX:069500,日本股票用 XTKS:1306;其他市场必须传入。 |
window | 查询参数 | 否 | 取值之一:2y、5y | 收益率回溯的时间跨度:2y(默认)或 5y。 |
frequency | 查询参数 | 否 | 取值之一:weekly、monthly | 收益率的计算间隔:weekly(默认;取每个 ISO 周内最后一个共同交易日)或 monthly。 |
beta | 查询参数 | 否 | 取值之一:raw、adjusted | 用哪个 beta 计算股权成本:raw(默认)或 adjusted(0.67 乘以 raw 再加 0.33)。结果中始终同时包含两者。 |
risk_ | 查询参数 | 否 | 字符串 | 你自己的无风险利率,以百分比表示。省略时使用该国国债收益率曲线的 10 年期点位。没有曲线的地区(韩国)必须传入:不传则返回 422 risk_free_unavailable。 |
tax_ | 查询参数 | 否 | 字符串 | 你自己用于债务税盾的税率,以百分比表示。省略时使用 Damodaran 公开表中(PwC 税率)该股票所在国家的企业所得税率。范围为 0 到 60。 |
period | 查询参数 | 否 | 取值之一:ttm、annual | 利息费用所取的期间:近 12 个月(ttm,默认)或最近一个完整财年(annual)。韩国和日本只有年度数据,因此只能使用 annual。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
id | 字符串 | 总是 | 规范的标的 id。 |
currency | 字符串 | 总是 | 金额字段的币种。 |
company_ | 字符串 | 总是 | 该标的在我们财报库中匹配到的公司。 |
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_ 的 beta。 |
beta.r_ | 字符串 | 总是 | 所解释的股票方差占比。 |
beta.std_ | 字符串 | 总是 | raw 的标准误差。 |
risk_ | 对象 | 总是 | |
risk_ | 字符串 | 总是 | 无风险利率,以百分比表示(4.25 表示 4.25%)。 |
risk_ | 取值之一:yield_curve、caller | 总是 | |
risk_ | 取值之一:ours、caller | 总是 | ours:我们发布的官方国债收益率曲线。caller:由你提供。 |
risk_ | 字符串 | 可选 | 收益率曲线所属国家。caller 时不返回。 |
risk_ | 恒为 "10y" | 可选 | 曲线上的期限点位。caller 时不返回。 |
risk_ | 恒为 "P10Y" | 可选 | maturity 对应的 ISO 8601 时长。caller 时不返回。 |
risk_ | 字符串 | 可选 | 曲线的报价方式(平价、零息、Svensson、到期收益率):各国之间略有不同。caller 时不返回。 |
risk_ | 日期 | 可选 | 曲线的日期。caller 时不返回。 |
equity_ | 对象 | 总是 | |
equity_ | 字符串 | 总是 | 股权风险溢价,以百分比表示(4.25 表示 4.25%)。 |
equity_ | 取值之一:narwhal、caller | 总是 | 由谁设定:narwhal 表示我们公布的该股票所在国家的总股权风险溢价,caller 表示你传入的 erp。 |
equity_ | 字符串 | 可选 | 我们溢价所属的国家,ISO 3166-1 alpha-3 代码。仅 narwhal 时返回。 |
equity_ | 日期 | 可选 | 我们溢价所对应的日期。仅 narwhal 时返回。 |
equity_ | 取值之一:observed、modelled、table | 可选 | 我们的总溢价如何得出:observed 来自我们自己的数据,modelled 由我们的利差模型得出,table 的国家部分取自公开表。仅 narwhal 时返回。 |
cost_ | 字符串 | 总是 | 无风险利率加 beta 乘以股权风险溢价,以百分比表示(4.25 表示 4.25%)。 |
cost_ | 对象 | 可选 | 没有债务记录的公司省略。 |
cost_ | 字符串 | 总是 | 利息费用除以平均总债务,以百分比表示(4.25 表示 4.25%)。无法使用该方法时(利息不为正,或结果低于 0.1% 或高于 30%),若有 EBIT 记录:取无风险利率加上公开表中该公司利息保障倍数对应的违约利差;basis 会说明使用了哪一种。 |
cost_ | 取值之一:ours、table | 总是 | ours:公司财报中的利息费用除以平均债务。table:无风险利率加上表中的违约利差。 |
cost_ | 字符串 | 可选 | EBIT 除以利息费用。仅 table 时返回;没有利息时省略。 |
cost_ | 字符串 | 可选 | 该利息保障倍数对应的违约利差,以百分比表示(4.25 表示 4.25%)。仅 table 时返回。 |
cost_ | 字符串 | 可选 | 利差表的名称。仅 table 时返回。 |
cost_ | 字符串 | 可选 | 该表的更新期次,例如 January 2026。仅 table 时返回。 |
cost_ | 字符串 | 可选 | 该表的发布位置。仅 table 时返回。 |
cost_ | 字符串 | 可选 | pre_ 乘以(1 减税率)。税率未知时省略。 |
cost_ | 取值之一:ttm、annual | 总是 | |
cost_ | 日期 | 总是 | 利息所含最新季度或年度的截止日。 |
cost_ | 字符串 | 总是 | 该期间的利息费用,单位为 currency 的整数单位。 |
cost_ | 字符串 | 总是 | 期初和期末总债务的平均值;没有期初数据时只用期末余额。单位为 currency 的整数单位;不含租赁。 |
cost_ | 字符串 | 可选 | period_ 一年前的总债务。没有记录时省略。 |
cost_ | 字符串 | 总是 | period_ 时的总债务。 |
tax_ | 对象 | 可选 | 该国在表中没有税率时省略。传入 tax_ 可自行设定。 |
tax_ | 字符串 | 总是 | 债务适用的税率,以百分比表示(4.25 表示 4.25%)。 |
tax_ | 取值之一:table、caller | 总是 | table:取自公开表的该国税率。caller:由你提供。 |
tax_ | 取值之一:country_table、caller | 总是 | country_:取自公开表的该股票所在国家的企业所得税率。caller:你传入的 tax_。 |
tax_ | 字符串 | 可选 | 税率所属国家的 ISO 3166-1 alpha-3 代码。仅表中税率返回。 |
tax_ | 字符串 | 可选 | 表的名称,含其发布方和来源。仅表中税率返回。 |
tax_ | 字符串 | 可选 | 税率所取自表的更新期次,例如 January 2026。 |
tax_ | 字符串 | 可选 | 该表的发布位置。仅表中税率返回。 |
weights | 对象 | 总是 | |
weights.equity | 字符串 | 总是 | 市值除以(市值加债务),以百分比表示(4.25 表示 4.25%)。 |
weights.debt | 字符串 | 总是 | 债务除以(市值加债务),以百分比表示(4.25 表示 4.25%)。 |
weights.market_ | 字符串 | 总是 | 最新价格乘以流通股数,单位为 currency 的整数单位。 |
weights.market_ | 日期时间 | 总是 | market_ 所用价格的有效时间。 |
weights.total_ | 字符串 | 总是 | 记录中最新的总债务,单位为 currency 的整数单位;不含租赁。 |
weights.total_ | 日期 | 总是 | total_ 对应的资产负债表日期。 |
wacc | 字符串 | 可选 | 加权平均资本成本,以百分比表示(4.25 表示 4.25%)。没有债务的公司等于 cost_。存在债务但税率未知时省略。 |
warnings | 对象数组 | 总是 | 使用这些数字之前需要核对的事项。没有时为空。 |
warnings[].code | 字符串 | 总是 | 稳定的机器可读代码。 |
warnings[].message | 字符串 | 总是 | 用通俗语言说明其含义。 |
methodology_ | 字符串 | 总是 | 每个数值是如何算出的。 |
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。计 1 次调用。
MCP:工具 equities, action valuation_。
参数
| 参数 | 位置 | 必填 | 类型 | 含义 |
|---|---|---|---|---|
id | 路径参数 | 是 | 字符串 | 标的 id:交易所的四位字母代码、冒号和股票代码,例如 XNAS:MSFT 或 XNYS:BRK.B。当单独的美股代码(如 MSFT)只对应一个美国标的时也可使用,返回结果带有规范 id。股份类别用点号表示(BRK.B),也接受 BRK-B。 |
响应字段
| 字段 | 类型 | 传入 | 含义 |
|---|---|---|---|
id | 字符串 | 总是 | 规范的标的 id。 |
currency | 字符串 | 总是 | 所有价格和市值的币种。 |
company_ | 字符串 | 总是 | 该标的在我们财报库中匹配到的公司。 |
start | 日期 | 可选 | 不返回:所有账户都能获取完整历史。 |
points | 对象数组 | 总是 | 公司每个财期期末一个数据点,按时间从早到晚排列。每个数据点由该财期披露的数据和当日价格算出,而不是当时已知的数据:后来的重述也会体现在内。没有价格或没有任何数值的财期没有数据点。 |
points[].date | 日期 | 总是 | 公司的一个财期期末(季末或年末):该数据点中的所有数值都以这一天为准。 |
points[].price | 字符串 | 可选 | price_ 当日的收盘价,单位为 currency,仅按拆股调整(从不按分红调整),因此与当前股本口径一致。当前无法读取该期间的价格时,它和下面所有数值都会省略,请稍后重试。 |
points[].price_ | 日期 | 可选 | 价格所取自的、date 当日或之前的最近一个交易日(最多提前 7 天)。 |
points[].market_ | 字符串 | 可选 | price 乘以最接近 date 的股本数(在其前 130 天到后 45 天之间统计),按当前股本口径,单位为 currency 的整数单位。没有这样的股本数、有多个股份类别但各自没有股本数,以及存托凭证或外国申报公司时省略。 |
points[].pe_ | 字符串 | 可选 | price 除以截至 date 的四个季度稀释后 EPS,保留 2 位小数。EPS 为负数或小于 0.01、披露币种不是 currency、没有截至 date 的四个季度(或全年)记录,以及存托凭证时省略。 |
points[].ps_ | 字符串 | 可选 | market_ 除以截至 date 的四个季度营收,保留 2 位小数。market_ 省略时它也省略;营收没有记录、不大于 0 或币种不是 currency 时同样省略。 |
points[].pb_ | 字符串 | 可选 | market_ 除以 date 当日资产负债表的总权益,保留 2 位小数。market_ 省略时它也省略;权益没有记录、不大于 0 或币种不是 currency 时同样省略。 |
points[].dividend_ | 字符串 | 可选 | 截至 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"
}
]
}错误
错误使用通用的 problem 结构,并带有 request_。查看 API 错误码与额度 了解该结构和额度相关的响应头。失败的请求不计费。
| 代码 | 状态 | 含义 |
|---|---|---|
invalid_ | 400 | 参数缺失、未知、重复或超出范围。 |
invalid_ | 400 | id 或交易对的写法不符合此 API 的要求。 |
too_ | 400 | 批量请求包含的 id 超过 50 个。 |
invalid_ | 400 | interval 不是 1d 或 1m,或该品种不支持。 |
range_ | 400 | 时间窗口超过该路由允许的长度。 |
not_ | 404 | 没有这个标的、基金或交易对。 |
not_ | 404 | 尚未涵盖该市场、国家或公司。 |
invalid_ | 400 | 该游标不是本请求返回的,或来自另一个请求。 |
cursor_ | 409 | 游标对应的价格已变化。请不带游标重新开始。 |
insufficient_ | 402 | 您的额度余额低于该请求的费用。 |
upstream_ | 503 | 目前无法获取价格。在批量请求中会列在 errors 中。请稍后重试。 |
area_ | 503 | 该区域目前无法响应。 |
erp_ | 400 | 请发送 erp,即你的股权风险溢价(百分比)。 |
insufficient_ | 422 | 该股票与其基准共有的收益率不足时间窗口的 80%。 |
risk_ | 422 | 该国家没有收益率曲线。请发送 risk_free。 |
not_ | 422 | WACC 对银行或保险公司没有意义。 |
currency_ | 422 | 基准或财报与价格的币种不同。 |
inputs_ | 422 | 某个输入无法正确计算。详情中指明了它。 |
此页面对你有帮助吗?