# Mempool API: Get Bitcoin address > Returns a Bitcoin address's confirmed and pending balances, lifetime received and sent totals, and up to 50 recent transactions. USD balance uses the latest reported Bitcoin price. Unofficial. Not affiliated with or endorsed by Mempool. - Page: https://fous.com/methods/mempool.space/get-bitcoin-address - Method: `mempool.space/get_bitcoin_address`, version 1 - Website: mempool.space - Returns: address, confirmed and unconfirmed balances (BTC, confirmed USD), total received and sent, transaction count, recent transactions - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `address` | string | yes | `"3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy"` | Bitcoin address starting with 1, 3 or bc1, for example 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa. | | `max_transactions` | integer | no | `50` | Maximum recent transactions to return, for example 10. Defaults to 10; maximum 50. Default 10. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "address": "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy", "max_transactions": 50 } ``` Its output: ```json { "address": "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy", "total_sent_btc": 46.09383956, "transaction_count": 753, "total_received_btc": 46.09383956, "recent_transactions": [ { "link": "https://mempool.space/tx/5037cda8ea28ca7e740ec84f735496671439f9428666f3f74339837c69188353", "fee_btc": 0.0000039, "confirmed": "yes", "date_time": "2026-10-22T07:57:28+00:00", "block_height": 972586, "net_change_btc": -0.000006, "transaction_id": "5037cda8ea28ca7e740ec84f735496671439f9428666f3f74339837c69188353" }, { "link": "https://mempool.space/tx/157cd0b26b304abbc4e5990c65e0179b4803018870f6db2998f5b14ac115adef", "fee_btc": 0.00000308, "confirmed": "yes", "date_time": "2026-10-22T07:57:28+00:00", "block_height": 972586, "net_change_btc": 0.000006, "transaction_id": "157cd0b26b304abbc4e5990c65e0179b4803018870f6db2998f5b14ac115adef" }, { "link": "https://mempool.space/tx/0a0a5eca381bdd02a4b8abe0bba91c3a33e20cb9d5aa03a61646cc62601074db", "fee_btc": 0.00005208, "confirmed": "yes", "date_time": "2026-10-06T23:50:15+00:00", "block_height": 970254, "net_change_btc": -0.00005555, "transaction_id": "0a0a5eca381bdd02a4b8abe0bba91c3a33e20cb9d5aa03a61646cc62601074db" } ], "confirmed_balance_btc": 0, "confirmed_balance_usd": 0, "unconfirmed_balance_btc": 0 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"mempool.space/get_bitcoin_address","input":{"address":"3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy","max_transactions":50}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - How much bitcoin is sitting in the address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh, both confirmed and pending, and what is that worth in USD right now? - Show me the last 25 transactions for the Bitcoin address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa, plus how much it has received and sent in total. - On mempool.space, check the balance and transaction count for address 3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy, including unconfirmed amounts. - Pull up the lifetime totals received and sent, and the 40 most recent transactions, for bc1q9h4l2n7dsk3xwz8e0pqmr6ytf5a2v0cjs4ndde. - What's the current confirmed and unconfirmed balance in BTC and USD for 1BoatSLRHtKNngkdXEeobR76b53LETtpyT, and how many transactions has it made? ## Input schema ```json { "type": "object", "required": [ "address" ], "properties": { "address": { "type": "string", "description": "Bitcoin address starting with 1, 3 or bc1, for example 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa." }, "max_transactions": { "type": "integer", "default": 10, "maximum": 50, "minimum": 1, "description": "Maximum recent transactions to return, for example 10. Defaults to 10; maximum 50." } } } ``` ## Output schema ```json { "type": "object", "required": [ "address", "confirmed_balance_btc", "confirmed_balance_usd", "unconfirmed_balance_btc", "total_received_btc", "total_sent_btc", "transaction_count", "recent_transactions" ], "properties": { "address": { "type": "string" }, "total_sent_btc": { "type": "number" }, "transaction_count": { "type": "integer" }, "total_received_btc": { "type": "number" }, "recent_transactions": { "type": "array", "items": { "type": "object", "required": [ "date_time", "net_change_btc", "fee_btc", "confirmed", "link", "transaction_id", "block_height" ], "properties": { "link": { "type": "string", "description": "Transaction page on mempool.space." }, "fee_btc": { "type": "number", "description": "Whole transaction network fee in BTC, not necessarily paid by this address." }, "confirmed": { "enum": [ "yes", "no" ], "type": "string", "description": "Whether this transaction is confirmed." }, "date_time": { "type": [ "string", "null" ], "format": "date-time", "description": "Confirmation date and time in UTC, or null when unconfirmed." }, "block_height": { "type": [ "integer", "null" ], "description": "Block height, or null when unconfirmed." }, "net_change_btc": { "type": "number", "description": "Change in this address's balance in BTC, negative for a net send." }, "transaction_id": { "type": "string", "description": "Transaction ID." } } } }, "confirmed_balance_btc": { "type": "number" }, "confirmed_balance_usd": { "type": "number" }, "unconfirmed_balance_btc": { "type": "number" } } } ``` ## See more - [Mempool API: Get Bitcoin fees](https://fous.com/methods/mempool.space/get-bitcoin-fees.md): Gets current Bitcoin fee-rate recommendations, the estimated USD cost of a 140-vbyte transaction at each rate, and the Bitcoin price in USD. Confirmation times are estimates, not guarantees. - [Etherscan API: Get Ethereum wallet](https://fous.com/methods/etherscan.io/get-wallet.md): Looks up an Ethereum wallet on Etherscan by address or ENS name: its ETH balance and USD value, the largest displayed ERC-20 holdings, and the newest confirmed transactions. Pending transactions are excluded; unpriced holdings have no USD value. - [Binance API: Get coin price](https://fous.com/methods/binance.com/get-coin-price.md): Gets a Binance spot pair's latest price and rolling 24-hour trading statistics from a coin name or symbol. Only currently trading pairs are available. - [OpenStreetMap API: Get coordinates for an address](https://fous.com/methods/openstreetmap.org/get-coordinates.md): Finds map coordinates and address details for an address or place on OpenStreetMap, optionally restricted to a country. - [FEMA API: Get flood zone for an address](https://fous.com/methods/fema.gov/get-flood-zone.md): Finds the FEMA flood zone, risk designation, base flood elevation, flood map panel and community for a US street address, using Census address coordinates and FEMA's National Flood Hazard Layer. - [CoinMarketCap API: Get coin price](https://fous.com/methods/coinmarketcap.com/get-coin-price.md): Gets a cryptocurrency's price, changes, supply, market cap, volume and all-time high in a chosen currency. If a name or symbol is shared, returns the coin with the largest market cap. - [Walk Score API: Get Walk Score](https://fous.com/methods/walkscore.com/get-walk-score.md): Gets the Walk, Transit and Bike Scores and neighborhood details for a street address. Unpublished scores are null; unresolved or mismatched addresses are not found. - [U.S. Census Bureau API: Get address details](https://fous.com/methods/census.gov/get-address-details.md): Matches a US street address and returns its city or place, county, state, ZIP code, census tract, congressional and state legislative districts, coordinates and FIPS codes. Districts follow the Census Geocoder's current geography vintage and may differ from sitting representation. - [All Mempool methods](https://fous.com/methods/mempool.space.md)