---
title: "Transaction tracker"
method: GET
path: "/blockchain/{asset}/transaction-tracker"
tags: ["Chain Monitor tools"]
---

# Transaction tracker

`GET /blockchain/{asset}/transaction-tracker`

Returns status updates for the specified or all transactions.<br/> This endpoint can be helpful to track transaction settlement.<br/> The transaction tracker keeps the history of the transaction updates for one month since the last update.

## Path parameters

- `asset` string, required

## Query parameters

- `txids` string[]
- `replacements_for_txids` string[]
- `replacements_only` boolean
- `addresses` string[]
- `unconfirmed_only` boolean
- `start_time` string
- `end_time` string
- `start_inclusive` boolean
- `end_inclusive` boolean
- `timezone` string
- `page_size` integer
- `paging_from` 'start' | 'end', PagingFrom
- `pretty` boolean
- `format` 'json' | 'csv'
- `next_page_token` string

## Response `200`

Current status and its updates for the requested transactions.

- TxTrackerResponse — Transaction tracker response.
  - `data` TxTrackerTransaction[], required
    - `txid` string, required — Identifier (txid) of the transaction.
    - `time` string, required — The time in ISO 8601 date-time format. Always with nanoseconds precision.
    - `first_seen_time` string, required — The time in ISO 8601 date-time format. Always with nanoseconds precision.
    - `status` string, required — Transaction status. Can have the following values: `UNCONFIRMED`, `CONFIRMED`, `REMOVED` (BTC asset only).
    - `status_update_time` string, required — The time in ISO 8601 date-time format. Always with nanoseconds precision.
    - `mempool_approx_queue_position` string — <b>BTC asset only.</b><br/> Approximate position of the transaction in the mempool.<br/> Miners choose mempool transactions to be included in the next block by scanning mempool and sort pending transactions by feerate in descending order.<br/> The value starts with 0. A lower number means higher feerate.
    - `next_block_approx_settlement_probability_pct` string — <b>BTC asset only.</b><br/> Approximate probability of including the mempool transaction to the next mined block.<br/> Miners choose mempool transactions to be included in the next block by scanning mempool and sort pending transactions by feerate in descending order.<br/> The value starts is a percentage between 0 and 100. A higher number means a higher probability.
    - `block_hash` string — Hash of the block.
    - `height` string — Height of the block.
    - `n_confirmations` string — The number of blocks between the transaction's block and the latest block in the blockchain plus one.<br/> If the transaction is included in the last block, the value is 1.
    - `status_updates` TxTrackerTxStatusUpdate[], required — A list of status updates for the transaction.
      - `time` string, required — The time in ISO 8601 date-time format. Always with nanoseconds precision.
      - `status` string, required — Transaction status. Can have the following values: `UNCONFIRMED`, `CONFIRMED`, `REMOVED` (BTC asset only).
      - `block_hash` string — Hash of the block.
      - `height` string — Height of the block.
      - `removal_reason` string — <b>BTC asset only.</b><br/> Why the transaction has been removed. This field is only present for `REMOVED` status. The possible values are: `EXPIRY`, `SIZE_LIMIT`, `REORG`, `CONFLICT`, `REPLACED`.
      - `replacement_txid` string — <b>BTC asset only.</b><br/> Identifier (txid) of the transaction.
    - `details` TxTrackerTxDetails, required — Static information about the transaction.
      - `version` string — Version of the transaction.
      - `amount` string, required — The total amount of the transaction.
      - `replace_by_fee_supported` boolean — This field is set to true only if the transaction supports the replace-by-fee (RBF) feature.
      - `fee` string — Fee of the transaction.
      - `feerate` string — Feerate of the transaction.
      - `mempool_feerate_mean_at_first_seen_time` string — Aggregate function result over the feerate values of all the mempool transactions.
      - `mempool_feerate_min_at_first_seen_time` string — Aggregate function result over the feerate values of all the mempool transactions.
      - `consensus_size` string — Consensus size of the transaction.
      - `physical_size` string — Physical size of the transaction, bytes.
    - `geo` BlockchainNodeLocationSeenTime[] — <b>BTC asset only.</b>
      - `location` string, required — A physical location of the blockchain node that have captured the transaction entering the mempool.
      - `seen_time` string, required — The time in ISO 8601 date-time format. Always with nanoseconds precision.
    - `replacement_for_txid` string — <b>BTC asset only.</b><br/> Identifier (txid) of the transaction.
    - `inputs` TxTrackerTxOutput[] — <b>BTC asset only.</b><br/> A list of tx outputs associated with the transaction.
      - `address` string, required — Identifier of the address associated with the transaction.
    - `outputs` TxTrackerTxOutput[] — <b>BTC asset only.</b><br/> A list of tx outputs associated with the transaction.
      - `address` string, required — Identifier of the address associated with the transaction.
  - `next_page_token` string — Token of the next page results for a given request.
  - `next_page_url` string — URL of the next page results for a given request.

## Other responses

- `401` — Requested resource requires authorization.
- `403` — Requested resource is not available with supplied credentials.

---

[API](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4.md) · [All operations](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coinmetrics/coin-metrics-api-v4/revisions/774268c0a4fe/schema)