| get_bitcoin_network_overview | Use this for general Bitcoin blockchain questions about current state, health, or status.
Provides comprehensive network overview across five key areas:
**Network Statistics:**
- Current market price in USD
- Network hashrate in TH/s (total mining power)
- Current mining difficulty
- Next difficulty adjustment block height
**Block Metrics:**
- Blocks mined in the last 24 hours
- Total blocks in the blockchain
- Average time between blocks (target: 10 minutes)
- Average block size in bytes
**Transaction Activity:**
- Total transactions in the last 24 hours
- Estimated BTC sent in 24h
- Estimated transaction volume in USD
**Mining Economics:**
- BTC mined in the last 24 hours (new supply)
- Total transaction fees collected in 24h (in BTC)
- Total miner revenue in BTC and USD
**Supply Information:**
- Total BTC in circulation
|
| get_bitcoin_network_recommended_fees | Use this to get current recommended Bitcoin transaction fees for different confirmation speed priorities.
Returns fee recommendations in string format with four priority levels:
- **Fastest** (~10 minutes): Highest fee for next block inclusion
- **Half-hour** (~30 minutes): Medium-high fee for confirmation within 30 min
- **Standard** (~60 minutes): Medium fee for confirmation within 1 hour
- **Economy**: Lowest fee for non-urgent transactions
Each recommendation includes:
- Fee rate in sat/vB (satoshis per virtual byte)
- Estimated confirmation time
- Approximate total cost in BTC for a typical transaction
Fees are dynamic and change based on current network congestion and mempool size.
Use cases: When you need to know how much to pay for a Bitcoin transaction, to optimize transaction costs vs. speed, or to check if the network is congested.
|
| get_bitcoin_network_health | Use this to get a simplified health assessment of the Bitcoin network with a single score and status label.
Returns a concise health summary in string format:
- Network status label (e.g., "Healthy", "Degraded", "Critical")
- Numerical health score out of 100 (0-100 scale)
The health score is a composite metric that considers factors like block production consistency, hashrate stability and transactions volume.
|
| get_bitcoin_transaction_infos | Use this to get comprehensive information about a specific Bitcoin transaction using its transaction ID (txid).
Returns detailed metrics in string format across four categories:
**Transaction Status:**
- Current status (Confirmed/Unconfirmed with visual indicator)
- Transaction date and time
**Economics & Flow:**
- Total amount transferred in BTC
- Transaction fees paid in BTC
- Fee rate in sat/vB (satoshis per virtual byte)
**Technical Structure:**
- Transaction size in bytes
- Number of inputs (sources of funds)
- Number of outputs (destinations)
**Block Information (if confirmed):**
- Block height where transaction was included
- Block hash containing the transaction
The txid is a unique 64-character hexadecimal identifier for each Bitcoin transaction.
Use cases: When you need to verify a payment, check transaction status, analyze fees paid, or investigate transaction details.
|
| get_transaction_input_output | Use this to get detailed input and output breakdown of a Bitcoin transaction, including all addresses and amounts involved.
Returns comprehensive flow analysis in string format across four sections:
**Accounting Summary:**
- Total incoming volume (sum of all inputs) in BTC
- Total outgoing volume (sum of all outputs) in BTC
- Network fees paid (difference between inputs and outputs) in BTC
**Detailed UTXO Flow:**
- List of all incoming movements (inputs) with:
- Source address
- Amount in BTC
- Previous transaction reference (prev_out)
- List of all outgoing movements (outputs) with:
- Destination address
- Amount in BTC
- Output index
**Participant Registry:**
- Complete list of sender addresses (count included)
- Complete list of recipient addresses (count included)
This provides full transparency into the transaction's inputs (where funds came from) and outputs (where funds went), essential for tracking fund flow and identifying all parties involved.
Use cases: When you need to trace Bitcoin flow, identify sender/recipient addresses, analyze UTXO structure, or investigate complex multi-party transactions.
|
| get_transactions_of_address | Use this to get the complete transaction history of a Bitcoin address.
Returns a chronological list of all transactions in string format, with each transaction showing:
- Transaction ID (txid) - unique identifier for the transaction
- Transaction date and time
- Amount sent in satoshis
This provides the full transaction history for an address, allowing you to see all incoming and outgoing payments over time. Each transaction can be further investigated using `get_bitcoin_transaction_infos` or `get_transaction_input_output` with the returned txid.
Accepts any Bitcoin address format (Legacy, SegWit, Bech32).
Use cases: When you need to audit an address's activity, track payment history, verify specific transactions, or investigate suspicious activity.
|
| get_info_about_address | Use this to get comprehensive information about a Bitcoin address including balance, transaction activity, and spending patterns.
Returns detailed metrics in string format:
- Current confirmed and unconfirmed balance (in BTC and satoshis)
- Address category and status
- Total transaction count (confirmed + mempool)
- Received outputs count and total amount
- Spent outputs count and total amount
Accepts any Bitcoin address format (Legacy, SegWit, Bech32).
Use cases: When you need a complete snapshot of an address's financial activity and current state.
|
| get_address_overview | Use this to get a simplified overview of a Bitcoin address focusing on balance and cumulative transaction totals.
Returns detailed metrics in string format:
- Current balance (in BTC)
- Total amount ever received (in BTC)
- Total amount ever sent (in BTC)
- Total number of transactions
Accepted Bitcoin address format : base58 or hash160.
Use cases: When you need a quick financial summary without granular details.
|
| get_bitcoin_price_usd | Use this to get Bitcoin's current USD price and essential market indicators.
Returns key metrics in string format:
- Current Bitcoin price in USD
- Estimated price 24 hours ago
- 24-hour price change percentage
- Total market capitalization in USD
- 24-hour trading volume in USD
- Volume-to-Cap ratio (liquidity indicator)
- Circulating supply (number of tokens)
Use cases: When you need a quick Bitcoin price check with essential market context.
|
| get_bitcoin_market_data | Use this to get a comprehensive technical and financial report on Bitcoin with extensive historical data and market analysis.
Returns an extensive report in string format including:
**Core Metrics:**
- Current price (USD) and market cap rank
- Total market capitalization
- Genesis date (blockchain creation date)
**Tokenomics & Supply:**
- Total supply and max supply
- Fully Diluted Valuation (FDV)
- Hashing algorithm and block time
**24-Hour Volatility:**
- Highest and lowest prices in last 24h
- Volatility percentage and price gap
**Historical Performance:**
- All-Time High (ATH) price, date, and percentage drop from ATH
- All-Time Low (ATL) price, date, and percentage rise from ATL
**Multi-Timeframe Price Analysis:**
- Price changes over 1 hour, 24 hours, 7 days, 30 days, 60 days, and 1 year
- Previous prices for each timeframe for trend comparison
**Additional Information:**
- GitHub repository link
- Whitepaper link
- Detailed project description
Use cases: When you need in-depth Bitcoin market analysis, historical performance tracking, or comprehensive investment research data. For quick price checks, use `get_bitcoin_price_usd`.
|
| get_cryptomarket_overview | Use this to get a comprehensive overview of the global cryptocurrency market conditions and metrics.
Returns detailed metrics in string format:
- Total number of active cryptocurrencies
- Total number of trading markets
- Overall market cap percentage change
- ICO status breakdown (upcoming, ongoing, ended)
- Total market capitalization (formatted by currency)
- Total trading volume (formatted by currency)
- Top 5 cryptocurrencies by market dominance percentage
Use cases: When you need a broad view of the entire crypto ecosystem health, to understand market trends, or to see which cryptocurrencies dominate the market.
|
| get_bitcoin_market_sentiment | Use this to get a comprehensive sentiment analysis of the Bitcoin market based on community voting and the Fear & Greed Index.
Returns detailed psychological metrics in string format:
**Community Sentiment (CoinGecko):**
- Overall market trend label (bullish/bearish/neutral)
- Percentage of optimistic votes (thumbs up)
- Percentage of pessimistic votes (thumbs down)
**Fear & Greed Index History (7 days):**
- Daily Fear & Greed Index values from Alternative.me
- Historical trend showing market emotion evolution over the past week
- Index ranges from 0 (Extreme Fear) to 100 (Extreme Greed)
Use cases: When you need to gauge overall market sentiment, understand investor psychology, or determine if the market is in fear or greed mode.
|
| get_trending_coins | Use this to get the top 15 trending cryptocurrencies sorted by the most popular user searches on CoinGecko.
Returns detailed metrics in string format for each of the 15 trending coins:
- Coin name and symbol
- Trending rank (1-15 based on search popularity)
- Current price in USD (up to 8 decimal places for precision)
- Price 24 hours ago with percentage change
- Market capitalization in USD
- Market cap rank (global ranking by market size)
- Total 24-hour trading volume in USD
- Brief project description
Use cases: When you need to discover what cryptocurrencies are currently attracting the most attention, identify emerging trends, or find coins gaining popularity.
|
| get_trending_categories | Use this to get the top 6 trending cryptocurrency categories sorted by the most popular user searches on CoinGecko.
Returns detailed metrics in string format for each of the 6 trending categories:
- Category name and trending rank (1-6)
- Number of coins in the category
- Total market capitalization in USD for the entire category
- Market cap 24 hours ago with percentage change
- Total 24-hour trading volume in USD across all coins in the category
Categories represent thematic groups of cryptocurrencies (e.g., "DeFi", "Layer 1", "Meme Coins", "NFT", "GameFi", etc.).
Use cases: When you need to identify which cryptocurrency sectors are gaining attention, understand macro trends in the crypto ecosystem, or find emerging narratives. This is based on real user search behavior for category pages.
|
| get_trending_nfts | Use this to get the top 7 trending NFT collections sorted by the most popular user searches on CoinGecko.
Returns detailed metrics in string format for each of the 7 trending NFT collections:
- NFT collection name and symbol
- Trending rank (1-7 based on search popularity)
- Native currency used for trading (e.g., ETH, SOL, MATIC)
- Current floor price (lowest price to buy one NFT from the collection)
- Floor price percentage change in the last 24 hours
- Total trading volume in the last 24 hours
- Average sale price in the last 24 hours
Use cases: When you need to discover which NFT collections are currently attracting the most attention, identify trending digital art or collectibles, or monitor NFT market activity. This is based on real user search behavior.
|
| get_mining_pools_hashrates_3month | Use this to get the top 10 Bitcoin mining pools ranked by their average hashrate over the last 3 months.
Returns detailed metrics in string format for each of the 10 leading mining pools:
- Pool rank position (1-10)
- Pool name
- Average hashrate in EH/s (Exahashes per second) over the 3-month period
- Network share percentage (portion of total Bitcoin network hashrate)
This data shows the historical performance and consistency of mining pools over a 3-month timeframe, providing a more stable view than current block count alone.
Use cases: When you need to analyze mining pool trends over time, understand hashrate distribution patterns, or identify consistently dominant pools.
|
| get_top_10_mining_pools_rank | Use this to get the ranking of the top 10 Bitcoin mining pools based on the number of blocks mined.
Returns detailed metrics in string format for each of the 10 leading mining pools:
- Pool name and rank position (1-10)
- Total number of blocks mined by the pool
- Percentage of total blocks mined (pool's share of network hashrate)
- Grand total of blocks across all pools
This ranking represents the current distribution of Bitcoin mining power and shows which pools control the most hashrate.
Use cases: When you need to understand mining centralization, identify the dominant mining pools, or analyze the distribution of network hashrate.
|
| get_bitcoin_network_mining_pools_statistics | Use this to get aggregate statistics and analysis of the Bitcoin mining pool ecosystem.
Returns comprehensive metrics in string format about the entire mining landscape:
**Global Statistics:**
- Total number of active mining pools tracked
- Total blocks mined across all pools
- Average blocks mined per pool
**Network Dominance Analysis:**
- Name of the current leading pool
- Number of blocks mined by the leader
- Leader's dominance percentage (share of total network)
**Power Distribution Insights:**
- Smallest pool's block count (weakest actor)
- Ratio of leader's performance compared to average (centralization indicator)
This tool provides a macro view of mining centralization and competition in the Bitcoin network.
Use cases: When you need to understand the overall mining landscape, assess centralization risk, or compare the gap between dominant and small pools.
|
| get_top1_mining_pool | Use this to get information about the current #1 ranked Bitcoin mining pool based on blocks mined over the last 3 months.
Returns detailed metrics in string format for the leading mining pool only:
- Pool name
- Pool slug identifier (used for searching specific pool details)
- Total number of blocks mined in the last 3 months
- Dominance percentage (share of all blocks mined in the 3-month period)
- Link to pool information page
This provides quick access to the most dominant mining pool without needing to retrieve data for all top pools.
Use cases: When you only need to know who currently dominates Bitcoin mining, to check if mining centralization is concerning, or to quickly identify the market leader.
|
| get_mining_pool_by_slug | Use this to get comprehensive information about a specific Bitcoin mining pool using its unique slug identifier.
Returns detailed metrics in string format for the requested mining pool:
- Pool name
- Official website link
- Current hashrate (mining power)
- Number of blocks found/mined
- Network share percentage (portion of total Bitcoin blocks)
- Pool's Bitcoin addresses used for receiving block rewards
The slug is a unique identifier for each mining pool (e.g., "foundry-usa", "antpool", "f2pool"). You can obtain slugs from `get_top1_mining_pool` or `get_top_10_mining_pools_rank`.
Use cases: When you need detailed information about a specific mining pool that you already know by name or slug, to investigate a pool's addresses, or to verify a pool's technical specifications.
|
| get_10_latest_blocks_informations | Use this to get detailed information and statistics about the 10 most recently mined Bitcoin blocks.
Returns comprehensive metrics in string format for each of the last 10 blocks:
- Block height and unique identifier (hash)
- Mining timestamp
- Transaction count
- Block size (in MB) and weight
- Total fees collected and average fee rate (sat/vB)
- Block reward (in satoshis)
- Mining pool that found the block
- Nonce value
Also includes aggregate statistics across all 10 blocks:
- Total number of transactions
- Average transactions per block
- Average block size
- Average time between blocks (in minutes)
Use cases: When you need to analyze recent blockchain activity trends, compare mining pool performance, or monitor network congestion.
|
| get_block_hash_with_height | Use this to retrieve the unique hash identifier of a Bitcoin block by specifying its height (position in the blockchain).
Returns the block hash in string format for the given height.
Block height represents the block's position in the blockchain (e.g., height 0 is the Genesis block, height 875000 is the 875,000th block).
Use cases: When you need to identify a specific block by its position, to verify block integrity, or to look up historical blocks.
|
| get_summary_of_latest_block | Use this to get a summary of the most recently mined block on the Bitcoin blockchain.
Returns detailed metrics in string format:
- Block height (current blockchain tip)
- Block hash
- Timestamp of when the block was mined
- Block Index
Use cases: When you need current blockchain state information, to verify the latest block, or to check recent mining activity.
|
