# Bitcoin Address Balance & Transaction History

**Use case:** 

Balance, total received and sent, transaction count, UTXO count and the 25 latest transactions of a Bitcoin address, including unconfirmed ones. Example: the genesis block address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa. For accountants, treasuries and analysts checking public addresses. Paste your own addresses, or set sinceDate to see only new activity.

## Input

```json
{
  "mode": "address",
  "network": "mainnet",
  "addresses": [
    "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
  ],
  "txLimit": 25,
  "includeMempoolTxs": true,
  "includeUtxos": false,
  "txids": [],
  "includeRbf": true,
  "blocks": [],
  "blocksLimit": 15,
  "includeBlockTxids": false,
  "blockTxidsLimit": 25,
  "projectedBlocks": 3,
  "recentTxLimit": 10,
  "includeReplacements": false,
  "interval": "1w",
  "poolsLimit": 20,
  "lightningRanking": "capacity",
  "lightningLimit": 20,
  "lightningQueries": [],
  "currency": "USD",
  "dates": [],
  "fields": [],
  "requestDelayMs": 100
}
```

## Output

```json
{
  "address": {
    "label": "Address",
    "format": "string"
  },
  "found": {
    "label": "Found",
    "format": "boolean"
  },
  "addressType": {
    "label": "Address type",
    "format": "string"
  },
  "balanceBtc": {
    "label": "Balance (BTC)",
    "format": "number"
  },
  "unconfirmedBalanceBtc": {
    "label": "Unconfirmed balance (BTC)",
    "format": "number"
  },
  "receivedBtc": {
    "label": "Received (BTC)",
    "format": "number"
  },
  "spentBtc": {
    "label": "Spent (BTC)",
    "format": "number"
  },
  "txCount": {
    "label": "Transactions",
    "format": "number"
  },
  "utxoCount": {
    "label": "UTXOs",
    "format": "number"
  },
  "lastTxAt": {
    "label": "Last transaction",
    "format": "string"
  },
  "windowReceivedBtc": {
    "label": "Received in window (BTC)",
    "format": "number"
  },
  "windowSentBtc": {
    "label": "Sent in window (BTC)",
    "format": "number"
  },
  "windowTxCount": {
    "label": "Transactions in window",
    "format": "number"
  },
  "windowComplete": {
    "label": "Window complete",
    "format": "boolean"
  },
  "sourceUrl": {
    "label": "Explorer link",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Bitcoin Scraper — Fees, Mempool, Blocks, Address Balance](https://apify.com/yadroo/bitcoin-mempool.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/yadroo/bitcoin-mempool.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/yadroo/bitcoin-mempool.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).