回補完整歷史
分頁讀取全部歷史，儲存到檔案，中斷後可繼續。
閱讀指南 →所有 API
加密貨幣 API 即時與歷史交易對價格
透過 REST 或 MCP 取得加密貨幣交易對的價格和價格歷史，使用同一個帳戶餘額，每個請求都帶 Bearer 金鑰。價格為最多 8 位有效數字的十進位字串。
首次請求
取得最新價格
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 秒至少成交一次時列入，低於每 2 分鐘一次時移除。
完整參考文件 →
GET單一加密貨幣交易對的最新價格/v1/crypto/{pair}/price
交易對的最新綜合價格，附 24 小時漲跌幅（未知時省略）。
參數
pair必填加密貨幣交易對：幣種、連字號與計價幣別，例如 BTC-USD 或 ETH-EUR。大小寫皆可；接受以斜線取代連字號。回應會附上標準交易對。
回應欄位
pair字串傳回的標準交易對，包含幣種與計價貨幣。
base字串所要求加密貨幣交易對中幣種的代號。
quote字串回應中所有價格使用的計價貨幣。
price字串最新價格，為十進位字串，最多 8 位有效數字。
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 個。每個交易對的規則與單一價格路由相同。每個回傳價格的交易對計為一次呼叫。
回應欄位
prices物件陣列每個已解析的交易對各有一筆價格，依交易對排序。
errors物件陣列未回傳價格的交易對。不收費。
完整參考文件 →
GET單一加密貨幣交易對的價格 K 線/v1/crypto/{pair}/bars
每日（1d，一個 UTC 日，於 UTC 00:00 收盤）或一分鐘（1m）K 線，由舊到新排列。
參數
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選填第一根 K 線。1d：日期（YYYY-MM-DD），含該日；省略則表示最早的一根 K 線。1m：UTC 時間（YYYY-MM-DDTHH:MM:SSZ，或僅填日期，視為 UTC 00:00），含該時間；省略則表示 end 的前一天。
end選填最後一根 K 線。1d：日期，含該日；省略則表示最近一個已收盤的日子。1m：UTC 時間，不含該時間；省略則表示現在，或 start 之後五天。1m 的 start 與 end 之間最多 5 天（400 range_too_large）。
cursor選填上一頁的 next_cursor，其他參數須相同。
回應欄位
pair字串標準交易對。
start字串不會回傳：start 不會被移動。
end字串不會回傳：日 K 線不會被截斷。
bars物件陣列每頁最多 5,000 根 K 線。
next_cursor字串傳回此值即可讀取下一頁。最後一頁為 null。
完整參考文件 →
使用情境
相關 API
常見問題
可以取得哪些交易對？
約 40 個交易對以 USD、EUR 與 GBP 計價。請使用 BTC-USD 或 ETH-EUR；id 大小寫皆可，也可用斜線，回應會傳回標準交易對。
價格是即時的還是延遲的？
股票、ETF 和加密貨幣價格對所有帳戶都是即時的，加密貨幣的回傳結果包含 24 小時漲跌。
加密貨幣價格有多新？
加密貨幣全天候交易，沒有交易時段。價格超過 5 分鐘或更新失敗時視為過期；價格與 K 線都沒有成交量欄位。
費用是多少？
呼叫費用為每 1,000 次 $2，從預付額度扣款。每個帳戶在前 12 個月內，每月都有 $10 的免費額度，且可商業使用。
該 API 涵蓋什麼？
交易對列表對所有帳戶開放，包含 Narwhal 提供價格的交易對。交易對至少每 30 秒成交一次時會被列入，低於每 2 分鐘一次時會被移除。日線和 1 分鐘線涵蓋全部歷史。批次價格呼叫最多接受 50 個 id。
每日加密貨幣 K 線如何運作？
每根日線涵蓋一個 UTC 日，在 00:00 UTC 出現。當天尚未完成的日線不會顯示。
可以請求多久的加密貨幣價格歷史資料？
所有帳戶都可取得日線和 1 分鐘線的完整歷史。若更早的資料不存在，start 會回傳提供的第一個日期。
24 小時漲跌幅代表什麼？
change_24h 是價格減去 24 小時前的價格，由 24 小時漲跌幅計算得出。百分比欄位中的 1.5 表示 1.5%。漲跌未知時，兩個漲跌欄位都會省略。
交易對 id 與批次呼叫如何運作？
交易對 id 以連字號連接幣種與計價貨幣，例如 BTC-USD。大小寫皆可，也接受斜線。批次呼叫最多接受 50 個 id，每個回傳價格的 id 計為一次呼叫。
從免費金鑰開始
12 個月內每月贈送 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。