---
title: "Get transactions for an address"
method: GET
path: "/v1/cryptos/{cryptoCode}/addresses/{address}/transactions"
tags: ["Addresses", "Transactions"]
---

# Get transactions for an address

`GET /v1/cryptos/{cryptoCode}/addresses/{address}/transactions`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/cryptos/{cryptoCode}/addresses/{address}/transactions`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/btcpayserver/apis/nbxplorer-api/docs/v1/cryptos/:cryptoCode/addresses/:address/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves transactions associated with the specified address.

## Path parameters

- `cryptoCode` string, required
- `address` string, required

## Query parameters

- `includeTransaction` boolean
- `from` integer
- `to` integer

## Response `200`

Transactions retrieved successfully.

- GetTransactionsResponse
  - `height` integer, required
  - `confirmedTransactions` TransactionInformationSet, required
    - `transactions` TransactionResponse[], required
      - `blockHash` string, nullable: The hash of the block containing this transaction. Will be `null` if the transaction is unconfirmed.
      - `confirmations` integer: Number of confirmations the transaction has.
      - `height` integer, nullable: The block height. Will be `null` if the transaction is unconfirmed.
      - `transactionId` string: The transaction ID.
      - `transaction` string: Raw transaction in hex format. Included only if `includeTransaction` is `true`.
      - `metadata` TransactionMetadata, nullable: Additional metadata related to the transaction. This may be null if the transaction had been indexed when it wasn't in the mempool anymore.'
        - `vsize` integer, nullable: Virtual size of the transaction. Only available if the transaction has been indexed when it was in the mempool.
        - `fees` integer, nullable: Total fee of this transaction in satoshi. Only available if the transaction has been indexed when it was in the mempool.
        - `feeRate` number, nullable: The estimated fee rate in satoshis per vByte. Only available if the transaction has been indexed when it was in the mempool.
        - `chunk` object, nullable: Fee metadata for the transaction chunk, as reported by Bitcoin Core mempool entry data.
          - `fees` integer, nullable: Total fee of this chunk in satoshi.
          - `weight` integer, nullable: Total chunk weight in weight units.
          - `feeRate` number, nullable: Chunk fee rate in satoshis per vByte.
      - `outputs` TransactionOutput[]: List of outputs related to the tracked source.
        - `address` string: The address of the output.
        - `scriptPubKey` string: The scriptPubKey of the output in hexadecimal format.
        - `index` integer: The position of the referenced output in the previous transaction's output list'.
        - `feature` string, nullable: Specifies the type of address generated. Possible values are: - `Deposit`: A deposit address from the external chain (`0/x`). - `Change`: A change address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
        - `value` integer: The amount of the output in satoshis.
        - `keyPath` string: The derivation path if the output is associated with the wallet. (Only for standard derivation schemes)
        - `keyIndex` integer: The index of the key in the descriptor (For example, if the keyPath is 0/123, then it is 123)
      - `inputs` TransactionInput[]: List of inputs related to the tracked source.
        - `inputIndex` integer: The position of this input in the transaction's input list.
        - `transactionId` string: The transaction ID (hash) of the previous transaction whose output is being spent.
        - `index` integer: The position of the referenced output in the previous transaction's output list'.
        - `feature` string, nullable: Specifies the type of address generated. Possible values are: - `Deposit`: A deposit address from the external chain (`0/x`). - `Change`: A change address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
        - `address` string: The address of the output.
        - `scriptPubKey` string: The scriptPubKey of the output being spent, in hexadecimal format.
        - `keyPath` string: The derivation path if the output is associated with the wallet. (Only for standard derivation schemes)
        - `keyIndex` integer: The index of the key in the descriptor (For example, if the keyPath is 1/2, then it is 2)
        - `value` integer: The amount of the output being spent, in satoshis.
      - `timestamp` integer: The UNIX timestamp indicating when the transaction was first seen by NBXplorer.
      - `balanceChange` integer: Net balance change for the wallet due to this transaction.
      - `replaceable` boolean: `true` if the transaction can be replaced (the transaction has RBF activated, is unconfirmed, and is not an intermediate transaction in a chain of unconfirmed transactions).
      - `replacing` string, nullable: If present, indicates the transaction ID that this transaction is replacing via RBF.
      - `replacedBy` string, nullable: If present, indicates the transaction ID that replaced this transaction via RBF.
  - `unconfirmedTransactions` TransactionInformationSet, required
    - `transactions` TransactionResponse[], required
      - `blockHash` string, nullable: The hash of the block containing this transaction. Will be `null` if the transaction is unconfirmed.
      - `confirmations` integer: Number of confirmations the transaction has.
      - `height` integer, nullable: The block height. Will be `null` if the transaction is unconfirmed.
      - `transactionId` string: The transaction ID.
      - `transaction` string: Raw transaction in hex format. Included only if `includeTransaction` is `true`.
      - `metadata` TransactionMetadata, nullable: Additional metadata related to the transaction. This may be null if the transaction had been indexed when it wasn't in the mempool anymore.'
        - `vsize` integer, nullable: Virtual size of the transaction. Only available if the transaction has been indexed when it was in the mempool.
        - `fees` integer, nullable: Total fee of this transaction in satoshi. Only available if the transaction has been indexed when it was in the mempool.
        - `feeRate` number, nullable: The estimated fee rate in satoshis per vByte. Only available if the transaction has been indexed when it was in the mempool.
        - `chunk` object, nullable: Fee metadata for the transaction chunk, as reported by Bitcoin Core mempool entry data.
          - `fees` integer, nullable: Total fee of this chunk in satoshi.
          - `weight` integer, nullable: Total chunk weight in weight units.
          - `feeRate` number, nullable: Chunk fee rate in satoshis per vByte.
      - `outputs` TransactionOutput[]: List of outputs related to the tracked source.
        - `address` string: The address of the output.
        - `scriptPubKey` string: The scriptPubKey of the output in hexadecimal format.
        - `index` integer: The position of the referenced output in the previous transaction's output list'.
        - `feature` string, nullable: Specifies the type of address generated. Possible values are: - `Deposit`: A deposit address from the external chain (`0/x`). - `Change`: A change address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
        - `value` integer: The amount of the output in satoshis.
        - `keyPath` string: The derivation path if the output is associated with the wallet. (Only for standard derivation schemes)
        - `keyIndex` integer: The index of the key in the descriptor (For example, if the keyPath is 0/123, then it is 123)
      - `inputs` TransactionInput[]: List of inputs related to the tracked source.
        - `inputIndex` integer: The position of this input in the transaction's input list.
        - `transactionId` string: The transaction ID (hash) of the previous transaction whose output is being spent.
        - `index` integer: The position of the referenced output in the previous transaction's output list'.
        - `feature` string, nullable: Specifies the type of address generated. Possible values are: - `Deposit`: A deposit address from the external chain (`0/x`). - `Change`: A change address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
        - `address` string: The address of the output.
        - `scriptPubKey` string: The scriptPubKey of the output being spent, in hexadecimal format.
        - `keyPath` string: The derivation path if the output is associated with the wallet. (Only for standard derivation schemes)
        - `keyIndex` integer: The index of the key in the descriptor (For example, if the keyPath is 1/2, then it is 2)
        - `value` integer: The amount of the output being spent, in satoshis.
      - `timestamp` integer: The UNIX timestamp indicating when the transaction was first seen by NBXplorer.
      - `balanceChange` integer: Net balance change for the wallet due to this transaction.
      - `replaceable` boolean: `true` if the transaction can be replaced (the transaction has RBF activated, is unconfirmed, and is not an intermediate transaction in a chain of unconfirmed transactions).
      - `replacing` string, nullable: If present, indicates the transaction ID that this transaction is replacing via RBF.
      - `replacedBy` string, nullable: If present, indicates the transaction ID that replaced this transaction via RBF.
  - `immatureTransactions` TransactionInformationSet, required
    - `transactions` TransactionResponse[], required
      - `blockHash` string, nullable: The hash of the block containing this transaction. Will be `null` if the transaction is unconfirmed.
      - `confirmations` integer: Number of confirmations the transaction has.
      - `height` integer, nullable: The block height. Will be `null` if the transaction is unconfirmed.
      - `transactionId` string: The transaction ID.
      - `transaction` string: Raw transaction in hex format. Included only if `includeTransaction` is `true`.
      - `metadata` TransactionMetadata, nullable: Additional metadata related to the transaction. This may be null if the transaction had been indexed when it wasn't in the mempool anymore.'
        - `vsize` integer, nullable: Virtual size of the transaction. Only available if the transaction has been indexed when it was in the mempool.
        - `fees` integer, nullable: Total fee of this transaction in satoshi. Only available if the transaction has been indexed when it was in the mempool.
        - `feeRate` number, nullable: The estimated fee rate in satoshis per vByte. Only available if the transaction has been indexed when it was in the mempool.
        - `chunk` object, nullable: Fee metadata for the transaction chunk, as reported by Bitcoin Core mempool entry data.
          - `fees` integer, nullable: Total fee of this chunk in satoshi.
          - `weight` integer, nullable: Total chunk weight in weight units.
          - `feeRate` number, nullable: Chunk fee rate in satoshis per vByte.
      - `outputs` TransactionOutput[]: List of outputs related to the tracked source.
        - `address` string: The address of the output.
        - `scriptPubKey` string: The scriptPubKey of the output in hexadecimal format.
        - `index` integer: The position of the referenced output in the previous transaction's output list'.
        - `feature` string, nullable: Specifies the type of address generated. Possible values are: - `Deposit`: A deposit address from the external chain (`0/x`). - `Change`: A change address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
        - `value` integer: The amount of the output in satoshis.
        - `keyPath` string: The derivation path if the output is associated with the wallet. (Only for standard derivation schemes)
        - `keyIndex` integer: The index of the key in the descriptor (For example, if the keyPath is 0/123, then it is 123)
      - `inputs` TransactionInput[]: List of inputs related to the tracked source.
        - `inputIndex` integer: The position of this input in the transaction's input list.
        - `transactionId` string: The transaction ID (hash) of the previous transaction whose output is being spent.
        - `index` integer: The position of the referenced output in the previous transaction's output list'.
        - `feature` string, nullable: Specifies the type of address generated. Possible values are: - `Deposit`: A deposit address from the external chain (`0/x`). - `Change`: A change address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
        - `address` string: The address of the output.
        - `scriptPubKey` string: The scriptPubKey of the output being spent, in hexadecimal format.
        - `keyPath` string: The derivation path if the output is associated with the wallet. (Only for standard derivation schemes)
        - `keyIndex` integer: The index of the key in the descriptor (For example, if the keyPath is 1/2, then it is 2)
        - `value` integer: The amount of the output being spent, in satoshis.
      - `timestamp` integer: The UNIX timestamp indicating when the transaction was first seen by NBXplorer.
      - `balanceChange` integer: Net balance change for the wallet due to this transaction.
      - `replaceable` boolean: `true` if the transaction can be replaced (the transaction has RBF activated, is unconfirmed, and is not an intermediate transaction in a chain of unconfirmed transactions).
      - `replacing` string, nullable: If present, indicates the transaction ID that this transaction is replacing via RBF.
      - `replacedBy` string, nullable: If present, indicates the transaction ID that replaced this transaction via RBF.
  - `replacedTransactions` TransactionInformationSet, required
    - `transactions` TransactionResponse[], required
      - `blockHash` string, nullable: The hash of the block containing this transaction. Will be `null` if the transaction is unconfirmed.
      - `confirmations` integer: Number of confirmations the transaction has.
      - `height` integer, nullable: The block height. Will be `null` if the transaction is unconfirmed.
      - `transactionId` string: The transaction ID.
      - `transaction` string: Raw transaction in hex format. Included only if `includeTransaction` is `true`.
      - `metadata` TransactionMetadata, nullable: Additional metadata related to the transaction. This may be null if the transaction had been indexed when it wasn't in the mempool anymore.'
        - `vsize` integer, nullable: Virtual size of the transaction. Only available if the transaction has been indexed when it was in the mempool.
        - `fees` integer, nullable: Total fee of this transaction in satoshi. Only available if the transaction has been indexed when it was in the mempool.
        - `feeRate` number, nullable: The estimated fee rate in satoshis per vByte. Only available if the transaction has been indexed when it was in the mempool.
        - `chunk` object, nullable: Fee metadata for the transaction chunk, as reported by Bitcoin Core mempool entry data.
          - `fees` integer, nullable: Total fee of this chunk in satoshi.
          - `weight` integer, nullable: Total chunk weight in weight units.
          - `feeRate` number, nullable: Chunk fee rate in satoshis per vByte.
      - `outputs` TransactionOutput[]: List of outputs related to the tracked source.
        - `address` string: The address of the output.
        - `scriptPubKey` string: The scriptPubKey of the output in hexadecimal format.
        - `index` integer: The position of the referenced output in the previous transaction's output list'.
        - `feature` string, nullable: Specifies the type of address generated. Possible values are: - `Deposit`: A deposit address from the external chain (`0/x`). - `Change`: A change address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
        - `value` integer: The amount of the output in satoshis.
        - `keyPath` string: The derivation path if the output is associated with the wallet. (Only for standard derivation schemes)
        - `keyIndex` integer: The index of the key in the descriptor (For example, if the keyPath is 0/123, then it is 123)
      - `inputs` TransactionInput[]: List of inputs related to the tracked source.
        - `inputIndex` integer: The position of this input in the transaction's input list.
        - `transactionId` string: The transaction ID (hash) of the previous transaction whose output is being spent.
        - `index` integer: The position of the referenced output in the previous transaction's output list'.
        - `feature` string, nullable: Specifies the type of address generated. Possible values are: - `Deposit`: A deposit address from the external chain (`0/x`). - `Change`: A change address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
        - `address` string: The address of the output.
        - `scriptPubKey` string: The scriptPubKey of the output being spent, in hexadecimal format.
        - `keyPath` string: The derivation path if the output is associated with the wallet. (Only for standard derivation schemes)
        - `keyIndex` integer: The index of the key in the descriptor (For example, if the keyPath is 1/2, then it is 2)
        - `value` integer: The amount of the output being spent, in satoshis.
      - `timestamp` integer: The UNIX timestamp indicating when the transaction was first seen by NBXplorer.
      - `balanceChange` integer: Net balance change for the wallet due to this transaction.
      - `replaceable` boolean: `true` if the transaction can be replaced (the transaction has RBF activated, is unconfirmed, and is not an intermediate transaction in a chain of unconfirmed transactions).
      - `replacing` string, nullable: If present, indicates the transaction ID that this transaction is replacing via RBF.
      - `replacedBy` string, nullable: If present, indicates the transaction ID that replaced this transaction via RBF.

## Other responses

- `404`: Address not found.

## Changes

- **2026-09-29** `52231f42c765`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/changes/v1/cryptos/:cryptoCode/addresses/:address/transactions/get.md)

---

[API](https://skmtc.dev/btcpayserver/apis/nbxplorer-api.md) - [All operations](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/revisions/52231f42c765?raw)