v11

latestOpenAPI 3.1.0AGPL-3.0-onlyraw.githubusercontent.com2026-08-01307390.9 KB

Accounts

Get address/account details.

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.

get/api/v2/address/{address}

Path parameters

addressstring required

Chain address.

Query parameters

pageinteger

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

pageSizeinteger

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

frominteger

First block height included in account transaction filtering.

tointeger

Last block height included in account transaction filtering.

details'basic' | 'tokens' | 'tokenBalances' | 'txids' | 'txslight' | 'txs'

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.

'inputs' | 'outputs'

OR

integer

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

contractstring

Contract address used to filter token data.

protocolsstring[]

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

[
  "erc4626"
]

secondarystring

Example:usd

Secondary currency code used to populate fiat values.

confirmedNonceboolean

If true, additionally return the confirmed nonce for Ethereum-like addresses (the confirmedNonce response field). This triggers an extra eth_getTransactionCount("latest") backend call, so it is off by default.

Response

Address/account details.

pageinteger

totalPagesinteger

itemsOnPageinteger

addressstring required

balancestring

Integer amount in the lowest chain denomination, encoded as a string.

totalReceivedstring

Integer amount in the lowest chain denomination, encoded as a string.

totalSentstring

Integer amount in the lowest chain denomination, encoded as a string.

unconfirmedBalancestring

Integer amount in the lowest chain denomination, encoded as a string.

unconfirmedTxsinteger required

unconfirmedSendingstring

Integer amount in the lowest chain denomination, encoded as a string.

unconfirmedReceivingstring

Integer amount in the lowest chain denomination, encoded as a string.

txsinteger required

addrTxCountinteger

nonTokenTxsinteger

internalTxsinteger

txidsstring[]

noncestring

confirmedNoncestring

usedTokensinteger

secondaryValuenumber

tokensBaseValuenumber

tokensSecondaryValuenumber

totalBaseValuenumber

totalSecondaryValuenumber

addressAliasesAddressAliases

Example response

{
  "balance": "100000000",
  "totalReceived": "100000000",
  "totalSent": "100000000",
  "unconfirmedBalance": "100000000",
  "unconfirmedSending": "100000000",
  "unconfirmedReceiving": "100000000",
  "transactions": [
    {
      "vin": [
        {
          "value": "100000000"
        }
      ],
      "vout": [
        {
          "value": "100000000"
        }
      ],
      "value": "100000000",
      "valueIn": "100000000",
      "fees": "100000000",
      "tokenTransfers": [
        {
          "value": "100000000",
          "multiTokenValues": [
            {
              "id": "100000000",
              "value": "100000000"
            }
          ]
        }
      ],
      "ethereumSpecific": {
        "gasPrice": "100000000",
        "effectiveGasPrice": "100000000",
        "maxPriorityFeePerGas": "100000000",
        "maxFeePerGas": "100000000",
        "baseFeePerGas": "100000000",
        "l1GasPrice": "100000000",
        "internalTransfers": [
          {
            "value": "100000000"
          }
        ]
      }
    }
  ],
  "tokens": [
    {
      "balance": "100000000",
      "ids": [
        "100000000"
      ],
      "multiTokenValues": [
        {
          "id": "100000000",
          "value": "100000000"
        }
      ],
      "totalReceived": "100000000",
      "totalSent": "100000000"
    }
  ],
  "contractInfo": {
    "protocols": {
      "erc4626": {
        "totalAssets": "100000000",
        "convertToAssets1Share": "100000000",
        "convertToShares1Asset": "100000000",
        "previewDeposit1Asset": "100000000",
        "previewRedeem1Share": "100000000"
      }
    }
  },
  "erc20Contract": {
    "protocols": {
      "erc4626": {
        "totalAssets": "100000000",
        "convertToAssets1Share": "100000000",
        "convertToShares1Asset": "100000000",
        "previewDeposit1Asset": "100000000",
        "previewRedeem1Share": "100000000"
      }
    }
  },
  "stakingPools": [
    {
      "pendingBalance": "100000000",
      "pendingDepositedBalance": "100000000",
      "depositedBalance": "100000000",
      "withdrawTotalAmount": "100000000",
      "claimableAmount": "100000000",
      "restakedReward": "100000000",
      "autocompoundBalance": "100000000"
    }
  ]
}