全履歴をバックフィルする
履歴をすべてページ単位で取得してファイルに保存し、途中で止まっても再開します。
ガイドを読む →すべてのAPI
上場株式向けの株価API
上場株式の価格と企業イベントを取得できます。時価総額とバリュエーション指標も含まれます。リクエストごとにBearerキーを使います。RESTとMCPは1つのアカウント残高を共有します。
最初のリクエスト
最新の価格を取得する
curl --request GET \
--url "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/price" \
--header "Authorization: Bearer $NARWHAL_API_KEY"レスポンスの例
{
"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
}エンドポイント
GETティッカーまたは名称で株式を検索/v1/equities/search
ティッカーまたは名称が q で始まる銘柄(大文字小文字は区別しません)。完全一致のティッカー、その他のティッカー、名称の順です。
パラメータ
q必須ティッカーまたは会社名の先頭部分(大文字小文字は区別せず、2文字以上。例: ms、micro)。順序は、完全一致のティッカー、その他のティッカー、名称の先頭、名称の後ろの単語の先頭の順で、それぞれの中では米国の主要上場銘柄が先に来ます。
country任意この国の銘柄のみ。3文字で指定します(USA、KOR)。
type任意この種類の銘柄のみ。
cursor任意前のページの next_cursor。その他のパラメーターは同じものを指定します。
レスポンスフィールド
resultsオブジェクトの配列1ページ最大50件。
next_cursor文字列次のページを読むには、この値を渡します。最後のページでは null です。
リファレンス全文 →
GET1銘柄のプロファイル/v1/equities/{id}
銘柄(シンボル、名称、種別、取引所、国、通貨)、会社のセクター、業種、ウェブサイト、および銘柄が当社の提出書類にある会社と一致する場合は company_id。
パラメータ
id必須銘柄 ID。取引所の4文字コード、コロン、ティッカーの順です(例: XNAS:MSFT、XNYS:BRK.B)。MSFT のような米国ティッカー単体でも、米国の銘柄が1つに決まる場合は使え、応答には正規の ID が含まれます。株式クラスにはドットを使います(BRK.B)。BRK-B も受け付けます。
レスポンスフィールド
id文字列正規の銘柄 ID。
symbol文字列その取引所でのティッカー。
mic文字列取引所の4文字コード。
country文字列銘柄の国。3文字。
sector文字列セクター。プロファイルの文章を持たない日本の銘柄では省略されます。
industry文字列業種。日本の銘柄では省略されます。
website文字列企業のウェブサイト。日本の銘柄では省略されます。
logo_url文字列自社で保管している企業ロゴのコピー。ない場合は省略されます。
company_id文字列銘柄が企業と明確に一致する場合の、その企業の開示書類 ID。
リファレンス全文 →
GET1銘柄の最新価格/v1/equities/{id}/price
1つの銘柄の最新価格。
パラメータ
id必須銘柄 ID。取引所の4文字コード、コロン、ティッカーの順です(例: XNAS:MSFT、XNYS:BRK.B)。MSFT のような米国ティッカー単体でも、米国の銘柄が1つに決まる場合は使え、応答には正規の ID が含まれます。株式クラスにはドットを使います(BRK.B)。BRK-B も受け付けます。
主なレスポンスフィールド
id文字列リクエストした銘柄について返される正規の上場id。
symbol文字列取引所でこの銘柄に使われるティッカー。
currency文字列すべての価格フィールドの通貨。ペンスはポンドに換算されます。
price文字列株式の最終価格。currency 建ての10進数の文字列で返されます。
previous_close文字列前回セッションの終値。その値が不明な場合は省略されます。
change文字列price から previous_close を引いた値。previous_close が省略される場合は、常に省略されます。
change_percent文字列previous_close からの変化率(パーセント)。1.5 は 1.5% を意味します。
volume文字列当日の売買株数。不明な場合は省略されます。
market_session次のいずれか: pre, open, post, closedtimestamp 時点の取引所の状態:pre、open、post、closed。preとpostがあるのは米国の取引所のみです。
timestamp日時価格が有効だった時刻。UTCで、秒単位です。
リファレンス全文 →
GET最大50銘柄の最新価格/v1/equities/prices
指定した各IDの最新価格。
パラメータ
ids必須カンマ区切りの銘柄 ID。重複を除いて最大50件です。各 ID は単一価格ルートと同じ規則に従います。価格を返した ID ごとに1回分を数えます。
レスポンスフィールド
pricesオブジェクトの配列解決できた ID ごとに1つの価格を、ID をキーにして返します。
errorsオブジェクトの配列価格を返さなかった ID。課金されません。
リファレンス全文 →
GET米国株の値動き上位銘柄/v1/equities/movers
方向別の米国株式およびETFの上位25銘柄: gainers、losers、active(その日の上昇・下落上位の中で売買代金が最大のもの。市場全体ではありません)。
パラメータ
market任意ランキング対象の市場。現時点では us のみで、それ以外の市場は 404 not_covered になります。
direction任意gainers(上昇率上位)、losers(下落率上位)、active(その日の上昇・下落上位の中で売買代金が最大のもの。市場全体ではありません)。それ以外は 400 invalid_query になります。
レスポンスフィールド
market常に "us"ランキングした市場。
direction次のいずれか: gainers, losers, activeリクエストされたランキング。
moversオブジェクトの配列最大25件、上位から順に並びます。対象は、価格が $1 以上で、本日の売買が10万株以上かつ $100万以上の普通株と ETF のみです。
timestamp日時一覧の中で最も新しい価格が有効だった時刻(UTC)。
リファレンス全文 →
GET1銘柄の価格バー/v1/equities/{id}/bars
日足(1d)または1分足(1m)のバーを、古い順に、株式分割と配当で調整して返します。
パラメータ
id必須銘柄 ID。取引所の4文字コード、コロン、ティッカーの順です(例: XNAS:MSFT、XNYS:BRK.B)。MSFT のような米国ティッカー単体でも、米国の銘柄が1つに決まる場合は使え、応答には正規の ID が含まれます。株式クラスにはドットを使います(BRK.B)。BRK-B も受け付けます。
interval任意session) or 1m (one-minute bars).当たり1d (one bar Anything else is 400 invalid_interval.
start任意最初のバー。1d: 日付(YYYY-MM-DD)、その日を含みます。省略すると最も古いバーになります。1m: UTC時刻(YYYY-MM-DDTHH:MM:SSZ、または 00:00 UTC とみなす日付)、その時刻を含みます。省略すると end の1日前になります。
end任意最後のバー。1d: 日付、その日を含みます。省略するとバーが公開済みの直近のセッションになります。1m: UTC時刻、その時刻を含みません。省略すると現在時刻、または start の5日後になります。1m では start と end の間隔は最大5日です(400 range_too_large)。
cursor任意前のページの next_cursor。その他のパラメーターは同じものを指定します。カーソルは、その背後の価格が変わる(分割や配当)と使えなくなります: 409 cursor_expired。
レスポンスフィールド
id文字列正規の銘柄 ID。
currency文字列すべての価格の通貨。ペンスはポンドになります。
adjustedブール値常に true です。価格は株式分割と配当で調整されます。あるページと次のページは必ず整合します。2つのページの間に分割や配当で履歴が変わった場合は、両者を混ぜずにカーソルが使えなくなります(409 cursor_expired)。
start文字列送られることはありません。start は移動されません。
end文字列送信されません。日足は切り詰められません。
barsオブジェクトの配列1ページ最大5,000本。
next_cursor文字列次のページを読むには、この値を渡します。最後のページでは null です。
リファレンス全文 →
GET1銘柄の配当/v1/equities/{id}/dividends
1つの銘柄の現金配当を、権利落ち日の新しい順にページ分割して返します。
パラメータ
id必須銘柄 ID。取引所の4文字コード、コロン、ティッカーの順です(例: XNAS:MSFT、XNYS:BRK.B)。MSFT のような米国ティッカー単体でも、米国の銘柄が1つに決まる場合は使え、応答には正規の ID が含まれます。株式クラスにはドットを使います(BRK.B)。BRK-B も受け付けます。
cursor任意
レスポンスフィールド
id文字列正規の銘柄 ID。
start日付送信されません。すべてのアカウントで全履歴を利用できます。
dividendsオブジェクトの配列権利落ち日が新しい順。発表済みの将来の行が含まれることがあります。
next_cursor文字列次のページを取得するには cursor として渡します。最後のページでは null です。
リファレンス全文 →
GET1銘柄の株式分割/v1/equities/{id}/splits
1つの銘柄の株式分割を、新しい順に返します。
パラメータ
id必須銘柄 ID。取引所の4文字コード、コロン、ティッカーの順です(例: XNAS:MSFT、XNYS:BRK.B)。MSFT のような米国ティッカー単体でも、米国の銘柄が1つに決まる場合は使え、応答には正規の ID が含まれます。株式クラスにはドットを使います(BRK.B)。BRK-B も受け付けます。
レスポンスフィールド
id文字列正規の銘柄 ID。
start日付送信されません。すべてのアカウントで全履歴を利用できます。
splitsオブジェクトの配列新しい順。
リファレンス全文 →
GET1銘柄の決算/v1/equities/{id}/earnings
1つの銘柄の過去の決算発表(取引所で本日以前の日付のもの)を、予想、実績、サプライズとともに、新しい順にページ分割して返します。
パラメータ
id必須銘柄 ID。取引所の4文字コード、コロン、ティッカーの順です(例: XNAS:MSFT、XNYS:BRK.B)。MSFT のような米国ティッカー単体でも、米国の銘柄が1つに決まる場合は使え、応答には正規の ID が含まれます。株式クラスにはドットを使います(BRK.B)。BRK-B も受け付けます。
cursor任意
レスポンスフィールド
id文字列正規の銘柄 ID。
start日付送信されません。すべてのアカウントで全履歴を利用できます。
earningsオブジェクトの配列過去の決算のみで、新しい順です。今後の発表日はまだ含まれません。
next_cursor文字列次のページを取得するには cursor として渡します。最後のページでは null です。
リファレンス全文 →
GET1銘柄の時価総額、P/E、P/S、P/B、配当利回り/v1/equities/{id}/valuation
米国または韓国の1銘柄について、時価総額(最新価格に発行済株式数を掛けたもの)、PER(最新価格を、企業の提出書類にある直近12か月の希薄化後EPS(報告ベースのGAAPまたはIFRS)で割ったもの)、PSR(時価総額を直近12か月の売上高で割ったもの)、PBR(時価総額を最新の貸借対照表の自己資本合計で割ったもの)、配当利回り(直近12か月の1株あたり配当を価格で割ったもの、パーセント)を、算出に使った入力値とその基準日とともに返します。
パラメータ
id必須銘柄 ID。取引所の4文字コード、コロン、ティッカーの順です(例: XNAS:MSFT、XNYS:BRK.B)。MSFT のような米国ティッカー単体でも、米国の銘柄が1つに決まる場合は使え、応答には正規の ID が含まれます。株式クラスにはドットを使います(BRK.B)。BRK-B も受け付けます。
主なレスポンスフィールド
id文字列正規の銘柄 ID。
currency文字列market_cap と、pe_ratio の基になる価格の通貨。
market_cap文字列最新価格に shares_outstanding を掛けたもの。currency 建てで、単位は整数です。shares_as_of より後に株式分割があった場合、会社に複数の株式クラスがありクラスごとの株数がない場合、預託証券または外国提出者の場合は省略されます。韓国にはまだ時価総額がなく、現時点では上場銘柄のPERのみ表示されます。
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か月の1株あたり配当を最新価格で割ったもの。パーセント表示(0.71 は 0.71% を意味します)で、小数第2位までです。その12か月分の配当が記録されていない場合(配当を出さない会社を含む)、dividends_period_end より後に株式分割があった場合、配当が currency と異なる通貨の場合、預託証券の場合は省略されます。
shares_outstanding文字列企業の主要な普通株クラスの発行済株式数。優先株の行のような別クラスの銘柄では、ここに株式数がないため省略されます。
shares_as_of日付shares_outstanding を数えた基準日。株数が表示されるときは常に表示されます。
eps_ttm文字列企業の提出書類にある直近12か月の希薄化後EPS(報告ベースのGAAPまたはIFRS)。第4四半期は年間の数値から第1四半期から第3四半期までを引いたものです。算出できる場合は常に表示され、同じ会社の別のクラスの銘柄では省略されます。市場データ基準である株式決算の eps_actual とは異なる場合があります。
リファレンス全文 →
GET1銘柄のベータ、株主資本コスト、負債コスト、WACC/v1/equities/{id}/cost-of-capital
米国または韓国の1銘柄について、ベンチマークETFに対するベータ(調整済み株式分割・配当後の価格による、デフォルトは2年間の週次リターン)、無リスク金利(その国の国債イールドカーブの10年の点、またはユーザー指定の値)、株主資本コスト(無リスク金利にベータと株式リスクプレミアムの積を加えたもの。リスクプレミアムは erp で指定した値、またはデフォルトでは銘柄の国について当社が公表する総プレミアム)、負債コスト(企業の提出書類にある支払利息を平均総負債で割ったもの。これが使えない場合は、無リスク金利に、インタレスト・カバレッジ・レシオに応じた公開表のデフォルトスプレッドを加えたもの。税引前と税引後の両方を返し、税引後には tax_rate を送らない限り公開表にある国の法人税率を使います)、およびWACC(時価総額と総負債で加重)を返します。
パラメータ
id必須銘柄 ID。取引所の4文字コード、コロン、ティッカーの順です(例: XNAS:MSFT、XNYS:BRK.B)。MSFT のような米国ティッカー単体でも、米国の銘柄が1つに決まる場合は使え、応答には正規の ID が含まれます。株式クラスにはドットを使います(BRK.B)。BRK-B も受け付けます。
erp任意自分の株式リスクプレミアム(パーセント単位。5 は 5% を表します)。省略すると、当社が公表している、その株式の国の総合株式リスクプレミアムが使われます(応答に日付と基準が示されます)。当社が公表していない国では、指定しないと 400 erp_required になります。0 より大きく 25 以下です。
benchmark任意ベータの測定対象となる市場代理の銘柄 ID。その株式と同じ通貨で値付けされた ETF、ファンド、または株式です。省略すると、米国株では ARCX:SPY、韓国株では XKRX:069500、日本株では XTKS:1306 になります。ほかの市場では指定が必要です。
window任意リターンをさかのぼる期間: 2y(デフォルト)または 5y。
frequency任意リターンの間隔: weekly(デフォルト。各ISO週の最後の共通取引日)または monthly。
beta任意株主資本コストに使うベータ: raw(デフォルト)または adjusted(raw の 0.67 に 0.33 を加えたもの)。どちらも常に応答に含まれます。
risk_free任意自分のリスクフリーレート(パーセント単位)。省略すると、その国の国債利回り曲線の10年の点になります。利回り曲線がない国(韓国)では必須で、指定しないと 422 risk_free_unavailable になります。
tax_rate任意負債の節税効果に使う自分の税率(パーセント単位)。省略すると、Damodaran の公開表(PwC の税率)にある、その株式の国の法人税率になります。0 から 60 の間です。
period任意支払利息の期間: 直近12か月(ttm、デフォルト)または直近の通期会計年度(annual)。韓国と日本は通期の数値のみのため、annual が使われます。
レスポンスフィールド
id文字列正規の銘柄 ID。
currency文字列金額項目の通貨。
company_id文字列銘柄が一致する、開示書類内の企業。
cost_of_equity文字列リスクフリーレートにベータと株式リスクプレミアムの積を足した値(パーセント単位。4.25 は 4.25% を表します)。
cost_of_debtオブジェクト負債の記録がない企業では省略されます。
tax_rateオブジェクトその国が表に税率を持たない場合は省略されます。設定するには tax_rate を送ってください。
wacc文字列加重平均資本コスト。パーセント表示(4.25 は 4.25% を意味します)。負債のない会社では cost_of_equity と等しくなります。負債があり税率が不明な場合は省略されます。
warningsオブジェクトの配列数値を使う前に確認すべき事項。ない場合は空です。
methodology_url文字列各数値の算出方法。
リファレンス全文 →
GET1銘柄のバリュエーション履歴/v1/equities/{id}/valuation/history
米国または韓国の1銘柄について、各会計期間末(四半期末または年度末)の時価総額、PER、PSR、PBR、配当利回りを、古い順に返します。
パラメータ
id必須銘柄 ID。取引所の4文字コード、コロン、ティッカーの順です(例: XNAS:MSFT、XNYS:BRK.B)。MSFT のような米国ティッカー単体でも、米国の銘柄が1つに決まる場合は使え、応答には正規の ID が含まれます。株式クラスにはドットを使います(BRK.B)。BRK-B も受け付けます。
レスポンスフィールド
id文字列正規の銘柄 ID。
currency文字列すべての価格と時価総額の通貨。
company_id文字列銘柄が一致する、開示書類内の企業。
start日付送信されません。すべてのアカウントで全履歴を利用できます。
pointsオブジェクトの配列企業の会計期間の末日ごとに1点で、古い順です。各点は、その期間に提出された数値とその日の価格から算出され、当時知られていた内容からではないため、後の訂正も反映されます。価格がない期間や、数値が1つもない期間には点がありません。
リファレンス全文 →
ユースケース
関連 API
よくある質問
株式IDはどう書きますか。
上場idは、4文字の取引所コードとティッカーを組み合わせたもので、MicrosoftならXNAS:MSFTです。一意に決まる米国のティッカー単体でも使え、レスポンスには正規のidが返されます。
料金はいくらですか?
1,000回あたり$2で、プリペイドのクレジットから差し引かれます。すべてのアカウントに、最初の12か月間、毎月$10分の無料クレジットが付与され、商用利用も可能です。
価格はライブですか、それとも遅延ですか。
株式、ETF、暗号資産の価格は、すべてのアカウントでリアルタイムです。バッチ呼び出しは最大50件のIDを受け付け、返された価格ごとに1回と数えます。
どのバリュエーションデータが含まれますか?
米国限定の値動き上位銘柄、バリュエーション履歴、ベータ付きの資本コストは、すべてのアカウントで利用できます。バリュエーションは米国・韓国の上場銘柄を開示資料と照合しており、韓国はP/Eのみです。
APIは何をカバーしますか?
検索とプロフィールはすべてのアカウントで利用できます。日足と過去の決算は全期間を対象とし、配当と株式分割も同じ範囲です。1分足も含まれます。当日出来高は不明な場合は省略されます。時価総額とP/E、P/S、P/B、配当利回りも含まれます。価格と金額は10進数の文字列です。
Stocks APIには、今後の決算や日本の価格は含まれますか?
決算ルートが返すのは過去の結果のみで、今後の決算日は利用できません。日本の価格は利用できず、プロファイルには name、exchange、country、currency、company_id のみが含まれます。決算の eps_actual は市場データを基準とし、pe_ratio の元になるEPSは企業の開示書類に基づきます。両者は異なる場合があるため、直接比較しないでください。
バリュエーション履歴はどのように機能しますか?
バリュエーション履歴は、四半期または年次の会計期間末ごとに1点です。各点はその日またはその直前の終値を使い、株式分割のみ調整し、数値は当該期間の開示どおりです。すべてのアカウントで全履歴を取得できます。古い行がない場合は、startが最初に返した日付を示します。
資本コストには何が必要ですか?
資本コストは、当社の開示書類にある企業と対応付けられた米国と韓国の上場銘柄を対象とし、すべてのレスポンスに資本コストの方法論へのリンクが付きます。株式リスクプレミアムは erp で渡してください。銀行と保険会社では、利息が営業費用であるため、422 not_applicable が返されます。算出できない入力は、推定されずに 422 inputs_unavailable で名前が示されます。
価格は企業の開示書類とどのようにつながりますか?
上場銘柄には company_id が付くことがあり、Filings APIの企業と結び付けられます。このidを使って、価格やバリュエーションを財務諸表とつなげられます。正しく算出できない比率は、0 を返さずに省略されます。
無料キーで始めましょう
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。