BTbtcpayserver
Addresses
Transactions

Get a transaction for an address

Changed on

Retrieves a transaction associated with the specified address.

get/v1/cryptos/{cryptoCode}/addresses/{address}/transactions/{txId}

Request

Path parameters

cryptoCodestring required

The cryptocurrency code to track (e.g., 'BTC' for Bitcoin, 'LTC' for Litecoin).

addressstring required

The address to track or query.

txIdstring required

The transaction ID to retrieve.

Query parameters

includeTransactionboolean

Optional. If set to true, each transaction in the response will include the raw transaction data in hexadecimal format (transaction field). Default is true.

frominteger

Indicates the earliest date from which transactions should be retrieved, (default: null, unix time)

tointeger

Indicates the latest date up to which transactions should be retrieved, (default: null, unix time

Response

Transaction details retrieved successfully.

blockHashstring nullable

The hash of the block containing this transaction. Will be null if the transaction is unconfirmed.

confirmationsinteger

Number of confirmations the transaction has.

heightinteger nullable

The block height. Will be null if the transaction is unconfirmed.

transactionIdstring

The transaction ID.

transactionstring

Raw transaction in hex format. Included only if includeTransaction is true.

timestampinteger

The UNIX timestamp indicating when the transaction was first seen by NBXplorer.

balanceChangeinteger

Net balance change for the wallet due to this transaction.

replaceableboolean

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).

replacingstring nullable

If present, indicates the transaction ID that this transaction is replacing via RBF.

replacedBystring nullable

If present, indicates the transaction ID that replaced this transaction via RBF.

Example response

{
  "blockHash": "3cdb91b426822f15ad3ca223654db914dc487fa73393532b089689b8e38efbf3",
  "height": 876593,
  "transactionId": "14a679cd743f3d2aa51b998747c58dfa9b31c8c669006fc6c6efe4b4f5f76e5b",
  "transaction": "02000000000101b596e23a22ea753251a5da4b7d415604dc05ab7c45ff675e077ed60a0d0a8d277401000000fdffffff0126010000000000001600140e48fd70dbb5af35119bfe7d626944c48c98ed9d0340e6c77a58ede14930d83002f05b8a13320a4140ab40a45b7f677f05c7653479d62b3d121823503563096156429b8fe5d818381812b4854ed3f59ec999b6fca8a94420afd36e561af10735e88f95d9655e5b3f7bc79de0a4781ef99d1e030c0c567422ac0063036f7264510a746578742f706c61696e000d3837363537382e6269746d61706821c0afd36e561af10735e88f95d9655e5b3f7bc79de0a4781ef99d1e030c0c56742200000000",
  "metadata": {
    "vsize": 141,
    "fees": 2820,
    "feeRate": 20,
    "chunk": {
      "fees": 2820,
      "weight": 564,
      "feeRate": 20
    }
  },
  "outputs": [
    {
      "address": "bc1qpey06uxmkkhn2yvmle7ky62ycjxf3mvaa0xf4j",
      "scriptPubKey": "00140e48fd70dbb5af35119bfe7d626944c48c98ed9d",
      "feature": "Deposit",
      "value": 294,
      "keyPath": "0/123",
      "keyIndex": 123
    }
  ],
  "inputs": [
    {
      "transactionId": "e3c0c6c0e0a0f8e0d0e0b0a0c0b0a0d0e0f0c0b0a0e0d0c0b0a0d0e0f0c0b0a0",
      "index": 1,
      "feature": "Deposit",
      "scriptPubKey": "76a91489abcdefabbaabbaabbaabbaabbaabbaabbaabba88ac",
      "keyPath": "1/2",
      "keyIndex": 2,
      "value": 100000000
    }
  ],
  "timestamp": 1540376171,
  "replacedBy": "8fdac258458f9216b035b30a62ca0400697d76a83f50cd7dc18eb8352e936cf2"
}

Changes