Get address

Returns balances and transactions of an address. The returned transactions are sorted by block height, newest blocks first.

This method will use 10 Compute Units.

Reference: Here

GET /api/v2/address/<address>[?page=<page>&pageSize=<size>&from=<block height>&to=<block height>&details=<basic|tokens|tokenBalances|txids|txs>&contract=<contract address>&secondary=usd]


Required parameters

address- string, required.

Example: bc1q262qeyyhdakrje5qaux8m2a3r4z8sw8vu5mysh

Optional parameters

  • page: specifies page of returned transactions, starting from 1. If out of range, Blockbook returns the closest possible page.

  • pageSize: number of transactions returned by call (default and maximum 1000)

  • from, to: filter of the returned transactions from block height to block height (default no filter)

  • details: specifies level of details returned by request (default txids)

    • basic: return only address balances, without any transactions

    • tokens: basic + tokens belonging to the address (applicable only to some coins)

    • tokenBalances: basic + tokens with balances + belonging to the address (applicable only to some coins)

    • txids: tokenBalances + list of txids, subject to from, to filter and paging

    • txslight: tokenBalances + list of transaction with limited details (only data from index), subject to from, to filter and paging

    • txs: tokenBalances + list of transaction with details, subject to from, to filter and paging

  • contract: return only transactions which affect specified contract (applicable only to coins which support contracts)

  • secondary: specifies secondary (fiat) currency in which the token and total balances are returned in addition to crypto values


Example response for a Bitcoin address, details set to txids:

Note:balance,totalReceived,totalSent,unconfirmedBalance are all denominated in satoshis.

	"page": 1,
	"totalPages": 6,
	"itemsOnPage": 1000,
	"address": "bc1q262qeyyhdakrje5qaux8m2a3r4z8sw8vu5mysh",
	"balance": "10834893",
	"totalReceived": "798821786",
	"totalSent": "787986893",
	"unconfirmedBalance": "0",
	"unconfirmedTxs": 0,
	"txs": 5375,
	"txids": [

curl<YOUR_API_KEY_HERE>/api/v2/address/bc1q262qeyyhdakrje5qaux8m2a3r4z8sw8vu5mysh \
 -X GET \
 -H "Content-Type: application/json"

Last updated