24h成交量—未平倉—24h爆倉$1.36B24h多空比—BTC市佔—ETH市佔—
App
語言 ▾
NT$ TWD ▾
/api/explorer/address/:addr
GET故障

比特幣地址摘要

比特幣地址摘要（餘額、交易筆數）

GET/api/explorer/address/:addr
部分覆蓋. 上游鏈上資料來源目前無法從我們的伺服器連上，因此此端點回傳 503。它仍保留在清單中，以免整合在無預警的情況下中斷；狀態頁面上的探測會顯示它何時恢復。
故障. 最近一次探測失敗（HTTP 503）

請求

查詢參數

名稱型別必填預設值可用值說明
addr pathstring必填——Bitcoin 地址；格式錯誤時回傳 400。 範例: 34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo

標示為「path」的參數屬於 URL 的一部分。

請求範例

curl -s "https://www.coinboss.com/api/explorer/address/34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo"

回應欄位

欄位表由真實回應產生，因此列出的正是端點實際回傳的內容。路徑中的 a[] 代表陣列元素，{*} 代表以動態名稱（例如幣種或交易所）為鍵的物件。

欄位型別單位說明
successboolean—請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。
cachedboolean—回應來自快取時為 `true`。
dataobject—回應主體資料。
data.addressstring—鏈上地址。
data.balance_satnumbersat已確認餘額 = 已接收 − 已花費。
data.funded_satnumbersat已確認交易中接收的總金額。
data.spent_satnumbersat已確認交易中花費的總金額。
data.tx_countnumbercount已確認的交易筆數。
data.chain_statsobject—此地址已確認交易的總計。
data.chain_stats.funded_txo_countnumbercount已接收的輸出數量。
data.chain_stats.funded_txo_sumnumbersat已接收的總金額。
data.chain_stats.spent_txo_countnumbercount已花費的輸出數量。
data.chain_stats.spent_txo_sumnumbersat已花費的總金額。
data.chain_stats.tx_countnumbercount交易筆數。
data.mempool_statsobject—此地址未確認（mempool）交易的總計。
data.mempool_stats.funded_txo_countnumbercount已接收的輸出數量。
data.mempool_stats.funded_txo_sumnumbersat已接收的總金額。
data.mempool_stats.spent_txo_countnumbercount已花費的輸出數量。
data.mempool_stats.spent_txo_sumnumbersat已花費的總金額。
data.mempool_stats.tx_countnumbercount交易筆數。

產生於 2026-11-11 23:01 UTC，依據 1 筆真實回應。

回應範例

/api/explorer/address/34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo · 真實回應，擷取於 2026-11-13 02:29:08 UTC。

  • {
    • "success": true,
    • "cached": false,
    • "data": {
      • "address": "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo",
      • "balance_sat": 24859759296803,
      • "funded_sat": 119037530223411,
      • "spent_sat": 94177770926608,
      • "tx_count": 5598,
      • "chain_stats": { … 5 },
      • "mempool_stats": { … 5 }
      }
    }

詳細資訊

身分驗證
無。公開端點。
速率限制
每個 IP 每分鐘 1200 次請求
伺服器快取
60s
邊緣微快取
10s
更新頻率
即時（記憶體快取 180 s）
時間視窗
最新快照
資料來源
即時的比特幣鏈上資料，於請求時代理自公開的 Esplora 相容區塊瀏覽器 API。
交易所覆蓋範圍
僅限比特幣主網。
單位
satoshis (balance, funded, spent); transaction count
計算方法
balance = funded outputs - spent outputs (confirmed chain stats).
時間戳記
Unix epoch 毫秒（UTC），除非欄位說明另有註明
回應格式
json
穩定性
穩定版

即時狀態

故障檢查於 2026-11-13 03:29:06 UTCHTTP 5031 ms未檢查結構描述

最近一次探測失敗（HTTP 503）

近 30 天可用率

132 次檢查中有 41.67% 通過

錯誤

所有端點的失敗回應都採用同一種結構。完整清單請見錯誤頁面。 錯誤與速率限制 →

錯誤碼HTTP意義處理方式
INVALID_PARAM400缺少必填參數，或某個值不被接受。已知時，`param` 會指出是哪個參數。請勿原樣重試；請修正請求。
UNAUTHORIZED401已送出 `CB-API-KEY` 標頭，但金鑰未知或已撤銷。公開資料不需要金鑰——請移除該標頭或改用有效的金鑰。請勿原樣重試。
FORBIDDEN403此路由不屬於公開 API（內部或僅限帳戶使用）。請勿重試。
NOT_FOUND404未知的路由，或所請求的幣種／交易所／基金不存在。請勿重試；請對照目錄檢查路徑與識別碼。
RATE_LIMITED429請求數超過每分鐘上限。`Retry-After` 會指出需等待的秒數。等待 `Retry-After` 指定的時間後，再以退避策略重試。
INTERNAL500非預期的伺服器錯誤。訊息刻意保持籠統；回報時請附上 `request_id`。幾秒後重試一次；若問題持續，請附上請求 ID 回報。
UPSTREAM_FAILED503此端點背後的資料來源未及時回應。不會以過期或替代的數字代替回傳。以退避策略重試；並查看狀態頁面。
UNAVAILABLE501 / 503資料集暫時尚未就緒（快取預熱中），或此端點目前尚無合法的公開來源。稍後重試；目錄會標示出設計上即無法使用的端點。
REQUEST_FAILED200部分舊版端點會以 HTTP 200 回應但帶有 `success: false`。請務必檢查 `success`，而不只是 HTTP 狀態碼。視訊息而定；請當作失敗的請求處理。

試用

GET/api/explorer/address/:addr故障
參數

string — Bitcoin address; 400 on bad format.

請求 URLhttps://www.coinboss.com/api/explorer/address/34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo
選擇一個端點並按下「送出請求」。回應內容、標頭與耗時會顯示在這裡。