Get address/account details.

GET

https://maticbook.nownodes.io/api/v2/address/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: improved unconfirmed balance reporting - unconfirmedBalance and unconfirmedTxs are serialized; optional protocols=erc4626 enrichment parameter for EVM chains; REST traffic is rate limited per client. Documented as it exists in 0.6.0.

Returns balances and transactions of an address. Transactions are sorted by block height with newest blocks first. Response size is controlled by the details parameter.

At details=basic, mempool transactions are not aggregated: unconfirmedBalance, unconfirmedSending, and unconfirmedReceiving are omitted, and unconfirmedTxs reports the raw mempool index size for the address.

Load estimate: Variable; basic is low, token/tokenBalances and txids/txslight are medium, and txs can be high as it grows with pageSize, transactions, token rows, filters, and protocol enrichment.

Parameters

addressstringrequiredpath

Chain address.

pageinteger>= 1query

1-based page index. Values outside safe bounds are sanitized to the closest possible page.

pageSizeinteger[1, 1000]query

Number of history items per page. The default and maximum for REST account endpoints is 1000.

frominteger>= 0query

First block height included in account transaction filtering.

tointeger>= 0query

Last block height included in account transaction filtering.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much account data is returned. basic returns balances and counts only. tokens adds known token rows. tokenBalances returns token rows with balances. txids adds paged transaction ids. txslight adds limited transaction details from the index. txs adds full transaction details.

filterstring | integerquery

Filter account history by input/output side, or by numeric token/internal filter id.

contractstringquery

Contract address used to filter token data.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated. Currently supported value: erc4626. Unknown values are rejected.

secondarystringquery

Secondary currency code used to populate fiat values.

Response

200OK

HTTP 200 Polygon Blockbook response for getAddress.

400Bad Request

Domain or validation error. JSON body {"error": "..."}.

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes.

500Internal Server Error

Internal Server Error. JSON body {"error":"Internal server error"}.

Get address/account details.

curl -X GET 'https://maticbook.nownodes.io/api/v2/address/{address}'

const response = await fetch('https://maticbook.nownodes.io/api/v2/address/{address}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://maticbook.nownodes.io/api/v2/address/{address}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://maticbook.nownodes.io/api/v2/address/{address}')
data = response.json()

const response = await fetch('https://maticbook.nownodes.io/api/v2/address/{address}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://maticbook.nownodes.io/api/v2/address/{address}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://maticbook.nownodes.io/api/v2/address/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://maticbook.nownodes.io/api/v2/address/{address}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://maticbook.nownodes.io/api/v2/address/{address}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "address": "0x2df3951b2037bA620C20Ed0B73CCF45Ea473e83B",
  "balance": "21004631949601199",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 5,
  "nonTokenTxs": 3,
  "nonce": "1",
  "tokens": [
    {
      "type": "ERC20",
      "standard": "ERC20",
      "name": "Tether USD",
      "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "transfers": 3,
      "symbol": "USDT",
      "decimals": 6,
      "balance": "4913000000",
      "baseValue": 3.104622978658881,
      "secondaryValue": 4914.214559070491
    }
  ],
  "secondaryValue": 33.247601671503574,
  "tokensBaseValue": 3.104622978658881,
  "tokensSecondaryValue": 4914.214559070491,
  "totalBaseValue": 3.125627610608482,
  "totalSecondaryValue": 4947.462160741995
}

{
  "error": "Address not found"
}

{
  "error": "Address not found"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}