全履歴をバックフィルする
履歴をすべてページ単位で取得してファイルに保存し、途中で止まっても再開します。
ガイドを読む →すべてのAPI
暗号資産APIでライブ価格と履歴を取得
RESTまたはMCPで暗号資産ペアの価格と価格履歴を取得できます。アカウント残高は1つで、すべてのリクエストにBearerキーを使います。価格は有効数字8桁までの10進数の文字列です。
最初のリクエスト
最新の価格を取得する
curl --request GET \
--url "https://api.narwhalapi.com/v1/crypto/BTC-USD/price" \
--header "Authorization: Bearer $NARWHAL_API_KEY"レスポンスの例
{
"pair": "BTC-USD",
"base": "BTC",
"quote": "USD",
"price": "68250.5",
"change_24h": "812.4",
"change_24h_percent": "1.2",
"timestamp": "2026-10-26T15:42:00Z",
"stale": false
}エンドポイント
GET価格を提供している暗号資産ペア/v1/crypto/pairs
価格を提供しているすべての通貨ペアを、ペアごとに表示します(BTC-USD 形式)。
パラメータ
quote任意この通貨建てのペアのみ(USD、EUR、GBP)。
レスポンスフィールド
pairsオブジェクトの配列価格を提供しているすべてのペアを、ペア順に返します。ペアは30秒に1回以上取引されている間は載り、2分に1回を下回ると外れます。
リファレンス全文 →
GET暗号資産ペア1件の最新価格/v1/crypto/{pair}/price
通貨ペアの最新の合成価格と24時間の変化(不明な場合は省略)。
パラメータ
pair必須暗号資産ペア。コイン、ハイフン、建値通貨の順で、たとえば BTC-USD や ETH-EUR です。大文字小文字は問わず、ハイフンの代わりにスラッシュも使えます。レスポンスには正規のペアが入ります。
レスポンスフィールド
pair文字列コインと決済通貨とともに返される正規のペア。
base文字列リクエストした暗号資産ペアのコインのティッカー。
quote文字列レスポンスのすべての価格に使われる決済通貨。
price文字列最終価格。有効桁数が最大8桁の10進数の文字列です。
change_24h文字列24時間の価格変化。変化率から算出され、不明な場合は省略されます。
change_24h_percent文字列24時間での変化率(パーセント)。1.5 は 1.5% を意味します。change_24h と同様に、省略されることがあります。
timestamp日時価格が有効だった時刻。UTCで、秒単位です。
staleブール値価格が5分より古い場合、または更新できなかった場合に true。
delayed常に true返されません。価格はすべてのアカウントでリアルタイムだからです。
リファレンス全文 →
GET最大50の暗号資産ペアの最新価格/v1/crypto/prices
掲載している各ペアの最新価格。
パラメータ
pairs必須カンマ区切りのペア。重複を除いて最大50件です。各ペアは単一価格ルートと同じ規則に従います。価格を返したペアごとに1回の呼び出しとして数えます。
レスポンスフィールド
pricesオブジェクトの配列解決できたペアごとに1つの価格を、ペア順に返します。
errorsオブジェクトの配列価格を返さなかったペア。課金されません。
リファレンス全文 →
GET暗号資産ペア1件の価格バー/v1/crypto/{pair}/bars
日足(1d、UTCの1日、00:00 UTCに終値)または1分足(1m)のバーを、古い順に返します。
パラメータ
pair必須暗号資産ペア。コイン、ハイフン、建値通貨の順で、たとえば BTC-USD や ETH-EUR です。大文字小文字は問わず、ハイフンの代わりにスラッシュも使えます。レスポンスには正規のペアが入ります。
interval任意UTC day, closing at 00:00 UTC) 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。パラメーターは同じものを指定します。
レスポンスフィールド
pair文字列正規のペア。
start文字列送られることはありません。start は移動されません。
end文字列送信されません。日足は切り詰められません。
barsオブジェクトの配列1ページ最大5,000本。
next_cursor文字列次のページを読むには、この値を渡します。最後のページでは null です。
リファレンス全文 →
ユースケース
関連 API
よくある質問
どのペアを取得できますか。
約40のペアが、USD、EUR、GBP建てで価格提供されています。BTC-USD や ETH-EUR を使います。idは大文字小文字を問わず、スラッシュも使え、レスポンスには正規のペアが返されます。
価格はライブですか、それとも遅延ですか。
株式、ETF、暗号資産の価格はすべてのアカウントでリアルタイムで、暗号資産の応答には24時間の変化率が含まれます。
暗号資産の価格はどのくらい新しいですか。
暗号資産は終日取引され、市場のセッションがありません。価格は5分より古い場合、または更新に失敗した場合に stale になります。価格とバーに出来高のフィールドはありません。
料金はいくらですか?
1,000回あたり$2で、プリペイドのクレジットから差し引かれます。すべてのアカウントに、最初の12か月間、毎月$10分の無料クレジットが付与され、商用利用も可能です。
APIは何をカバーしますか?
ペア一覧はすべてのアカウントで利用でき、Narwhalが価格を提供するペアを含みます。ペアは少なくとも30秒に1回取引されている間は掲載され、2分に1回を下回ると外されます。日足と1分足は全履歴を対象とします。バッチの価格呼び出しは最大50件のIDを受け付けます。
暗号資産の日足バーはどのように機能しますか?
日足は1つのUTC日を対象とし、00:00 UTCに表示されます。当日の途中の足は表示されません。
暗号資産の価格履歴はどのくらいリクエストできますか?
すべてのアカウントで、日足と1分足の全履歴を取得できます。古い行がない場合、startは最初に返した日付を示します。
24時間の変化は何を表しますか?
change_24hは価格から24時間前の価格を引いた値で、24時間の変化率から計算されます。変化率フィールドの1.5は1.5%を意味します。変化が不明な場合は、2つの変化フィールドとも省略されます。
ペアidとバッチ呼び出しはどのように機能しますか?
ペアidは、コインと決済通貨をハイフンでつないだもので、BTC-USDのように指定します。大文字小文字は問わず、スラッシュも使えます。バッチ呼び出しは最大50件のidを受け付け、価格が返ったidごとに1回分として数えます。
無料キーで始めましょう
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。