---
title: "Get address/account details."
method: GET
path: "/api/v2/address/{address}"
tags: ["Accounts"]
---

# Get address/account details.

`GET /api/v2/address/{address}`

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.

## Path parameters

- `address` string, required

## Query parameters

- `page` integer
- `pageSize` integer
- `from` integer
- `to` integer
- `details` 'basic' | 'tokens' | 'tokenBalances' | 'txids' | 'txslight' | 'txs'
- `filter` union
  - 'inputs' | 'outputs'
  - integer
- `contract` string
- `protocols` string[]
- `secondary` string
- `confirmedNonce` boolean

## Response `200`

Address/account details.

- Address
  - `page` integer
  - `totalPages` integer
  - `itemsOnPage` integer
  - `address` string, required
  - `balance` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `totalReceived` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `totalSent` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `unconfirmedBalance` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `unconfirmedTxs` integer, required
  - `unconfirmedSending` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `unconfirmedReceiving` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `txs` integer, required
  - `addrTxCount` integer
  - `nonTokenTxs` integer
  - `internalTxs` integer
  - `transactions` Tx[]
    - `txid` string, required
    - `version` integer
    - `lockTime` integer
    - `vin` Vin[], required
      - `txid` string
      - `vout` integer
      - `sequence` integer
      - `n` integer, required
      - `addresses` string[]
      - `isAddress` boolean, required
      - `isOwn` boolean
      - `value` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `hex` string
      - `asm` string
      - `coinbase` string
    - `vout` Vout[], required
      - `value` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `n` integer, required
      - `spent` boolean
      - `spentTxId` string
      - `spentIndex` integer
      - `spentHeight` integer
      - `hex` string
      - `asm` string
      - `addresses` string[], nullable, required
      - `isAddress` boolean, required
      - `isOwn` boolean
      - `type` string
    - `blockHash` string
    - `blockHeight` integer, required — -1 for unconfirmed transactions.
    - `confirmations` integer, required
    - `confirmationETABlocks` integer
    - `confirmationETASeconds` integer
    - `blockTime` integer, required
    - `size` integer
    - `vsize` integer
    - `value` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `valueIn` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `fees` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `hex` string
    - `rbf` boolean
    - `coinSpecificData` unknown
    - `chainExtraData` TxChainExtraData
      - `payloadType` string, required — Discriminator for normalized chain-specific payloads, for example tron.
      - `payload` unknown
    - `tokenTransfers` TokenTransfer[]
      - `type` '' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155', required — Token standard name. Empty string means no token standard is known.
      - `standard` '' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155', required — Token standard name. Empty string means no token standard is known.
      - `from` string, required
      - `to` string, required
      - `contract` string, required
      - `name` string
      - `symbol` string
      - `decimals` integer, required
      - `value` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `multiTokenValues` MultiTokenValue[]
        - `id` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `value` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `ethereumSpecific` EthereumSpecific
      - `type` integer
      - `createdContract` string
      - `status` integer, required — 1 success, 0 failed, -1 pending.
      - `error` string
      - `nonce` integer, required
      - `gasLimit` integer
      - `gasUsed` integer
      - `gasPrice` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `effectiveGasPrice` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `maxPriorityFeePerGas` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `maxFeePerGas` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `baseFeePerGas` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `l1Fee` integer
      - `l1FeeScalar` string
      - `l1GasPrice` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `l1GasUsed` integer
      - `data` string
      - `parsedData` EthereumParsedInputData
        - `methodId` string, required — First 4 bytes of the input data.
        - `name` string, required — Parsed function name when recognized.
        - `function` string — Full function signature when recognized.
        - `params` EthereumParsedInputParam[]
          - `type` string, required
          - `values` string[]
      - `internalTransfers` EthereumInternalTransfer[]
        - `type` integer, required
        - `from` string, required
        - `to` string, required
        - `value` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `addressAliases` AddressAliases
  - `txids` string[]
  - `nonce` string
  - `confirmedNonce` string
  - `usedTokens` integer
  - `tokens` Token[]
    - `type` '' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155', required — Token standard name. Empty string means no token standard is known.
    - `standard` '' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155', required — Token standard name. Empty string means no token standard is known.
    - `name` string, required
    - `path` string
    - `contract` string
    - `transfers` integer, required
    - `symbol` string
    - `decimals` integer, required
    - `balance` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `baseValue` number
    - `secondaryValue` number
    - `ids` AmountString[]
    - `multiTokenValues` MultiTokenValue[]
      - `id` string — Integer amount in the lowest chain denomination, encoded as a string.
      - `value` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `totalReceived` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `totalSent` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `protocols` string[] — Indexed protocol identifiers such as erc4626.
  - `secondaryValue` number
  - `tokensBaseValue` number
  - `tokensSecondaryValue` number
  - `totalBaseValue` number
  - `totalSecondaryValue` number
  - `contractInfo` ContractInfoResult
    - `type` '' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155', required — Token standard name. Empty string means no token standard is known.
    - `standard` '' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155', required — Token standard name. Empty string means no token standard is known.
    - `contract` string, required
    - `name` string, required
    - `symbol` string, required
    - `decimals` integer, required
    - `createdInBlock` integer
    - `destructedInBlock` integer
    - `rates` ContractInfoRates
      - `baseRate` number
      - `currency` string
      - `secondaryRate` number
    - `protocols` ContractInfoProtocols
      - `erc4626` Erc4626Token
        - `asset` Erc4626TokenMetadata
          - `contract` string, required
          - `name` string
          - `symbol` string
          - `decimals` integer, required
        - `share` Erc4626TokenMetadata
          - `contract` string, required
          - `name` string
          - `symbol` string
          - `decimals` integer, required
        - `totalAssets` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `convertToAssets1Share` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `convertToShares1Asset` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `previewDeposit1Asset` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `previewRedeem1Share` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `error` string
    - `blockHeight` integer, required
  - `erc20Contract` ContractInfoResult
    - `type` '' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155', required — Token standard name. Empty string means no token standard is known.
    - `standard` '' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155', required — Token standard name. Empty string means no token standard is known.
    - `contract` string, required
    - `name` string, required
    - `symbol` string, required
    - `decimals` integer, required
    - `createdInBlock` integer
    - `destructedInBlock` integer
    - `rates` ContractInfoRates
      - `baseRate` number
      - `currency` string
      - `secondaryRate` number
    - `protocols` ContractInfoProtocols
      - `erc4626` Erc4626Token
        - `asset` Erc4626TokenMetadata
          - `contract` string, required
          - `name` string
          - `symbol` string
          - `decimals` integer, required
        - `share` Erc4626TokenMetadata
          - `contract` string, required
          - `name` string
          - `symbol` string
          - `decimals` integer, required
        - `totalAssets` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `convertToAssets1Share` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `convertToShares1Asset` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `previewDeposit1Asset` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `previewRedeem1Share` string — Integer amount in the lowest chain denomination, encoded as a string.
        - `error` string
    - `blockHeight` integer, required
  - `addressAliases` AddressAliases
  - `stakingPools` StakingPool[]
    - `contract` string, required
    - `name` string, required
    - `pendingBalance` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `pendingDepositedBalance` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `depositedBalance` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `withdrawTotalAmount` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `claimableAmount` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `restakedReward` string — Integer amount in the lowest chain denomination, encoded as a string.
    - `autocompoundBalance` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `chainExtraData` AccountChainExtraData
    - `payloadType` string, required
    - `payload` unknown

## Other responses

- `default` — Public API error. Public validation errors are HTTP 400; internal errors are HTTP 500.

## Changes

- **2026-07-22** `aef157c19369` — 1 info
  - added the optional property `transactions/items/ethereumSpecific/effectiveGasPrice` to the response with the `200` status
- **2026-06-21** `b72e9a46af25` — 2 info
  - the response property `tokens/items/decimals` became required for the status `200`
  - the response property `transactions/items/tokenTransfers/items/decimals` became required for the status `200`
- **2026-06-16** `bd5f715430a5` — 1 info
  - added the new optional `query` request parameter `confirmedNonce`
- **2026-06-15** `a62ee268399c` — 1 info
  - added the optional property `confirmedNonce` to the response with the `200` status
- **2026-05-26** `0ff90309c70d` — 1 breaking
  - response property `transactions/items/vout/items/addresses` list-of-types was widened by adding types `null` to media type `application/json` of response `200`

[Full history](https://skmtc.dev/trezor/apis/blockbook-api/changes/api/v2/address/:address/get.md)

---

[API](https://skmtc.dev/trezor/apis/blockbook-api.md) · [All operations](https://skmtc.dev/trezor/apis/blockbook-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trezor/blockbook-api/revisions/01c375da86bc/schema)