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

# Transaction tracker

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

## Request

- Base URL: `https://api.coinmetrics.io/v4`
- URL: `https://api.coinmetrics.io/v4/blockchain/{asset}/transaction-tracker`
- Auth: API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/docs/blockchain/:asset/transaction-tracker/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/coinmetrics/apis/coin-metrics-api-v4.md) - [All operations](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/revisions/774268c0a4fe?raw)