# Bitcoin Network Health Dashboard (`gochujang/bitcoin-network-health`) Actor Real-time Bitcoin network metrics: hash rate, difficulty, mempool size, transaction count, mining revenue, block times, and fee rates. Fetches from blockchain.info and mempool.space. Perfect for miners, investors, and developers tracking BTC network activity. - **URL**: https://apify.com/gochujang/bitcoin-network-health.md - **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community) - **Categories:** Developer tools, Automation, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Bitcoin Network Health Dashboard > Real-time Bitcoin network metrics in one run: **hash rate, difficulty, halving countdown, mempool fees, miner revenue, NVT ratio, MVRV ratio, and BTC price**. No API key required. Flat $0.005/run. ### ⚡ Run in 30 seconds Click **Start** with default settings — returns the full Bitcoin network health snapshot: current hash rate, days to next halving, recommended transaction fees, miner revenue, NVT ratio, MVRV ratio, and BTC price. All in one call, no API key required. --- ### What It Does A complete Bitcoin health snapshot combining on-chain data, mining metrics, mempool conditions, and market valuation signals. Designed for traders, analysts, and dashboards that need the full picture in a single run. ### Metrics Included | Category | Metrics | |----------|---------| | **Network** | Hash rate (TH/s), difficulty (T), avg block time, total blocks, days to halving, BTC supply remaining | | **Mining** | Miner revenue 24h (USD), fees collected (BTC), BTC mined 24h, transaction count | | **Fees** | sat/vB for fastest / half-hour / 1-hour / economy / minimum | | **Mempool** | Unconfirmed tx count, mempool size (MB), total fees pending | | **Market** | BTC/USD price, 24h change %, market cap, 24h volume | | **On-chain** | NVT ratio + signal (overbought/fair/oversold), MVRV ratio + signal | ### On-chain Valuation Signals | Metric | Formula | Overbought | Oversold | |--------|---------|-----------|---------| | **NVT Ratio** | Market Cap / Transaction Volume | > 150 | < 45 | | **MVRV Ratio** | Market Cap / Realized Cap | > 2.0 | < 1.0 | - **NVT < 45** = Network undervalued relative to usage → accumulation signal - **MVRV > 3.0** = Extreme overvalued (historically precedes major corrections) - **MVRV < 1.0** = Extreme undervalued (historically strong buy zone) ### Example Output ```json [ {"metric": "hash_rate_th_s", "value": 891730672, "unit": "TH/s", "category": "network"}, {"metric": "difficulty", "value": 123.4, "unit": "T", "category": "network"}, {"metric": "days_to_halving", "value": 1089.5, "unit": "days", "category": "network"}, {"metric": "fee_fastest_sat_vb", "value": 12, "unit": "sat/vB","category": "fees"}, {"metric": "mempool_tx_count", "value": 54821, "unit": "txs", "category": "mempool"}, {"metric": "btc_price_usd", "value": 62112, "unit": "USD", "category": "market"}, {"metric": "nvt_ratio", "value": 38.5, "unit": "", "category": "onchain"}, {"metric": "nvt_signal", "value": "oversold","unit": "", "category": "onchain"}, {"metric": "mvrv_ratio", "value": 1.17, "unit": "", "category": "onchain"}, {"metric": "mvrv_signal", "value": "fair_value","unit": "", "category": "onchain"} ] ```` ### Input Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `metrics` | string\[] | `[]` (all) | Filter categories: `network`, `mining`, `fees`, `mempool`, `market`, `onchain` | | `includeHistorical` | boolean | `false` | Include 7-day trend data | ### Pricing - **$0.005 per run** (flat rate, all metrics included) - Ideal for hourly or daily scheduling ### Data Sources - [blockchain.info API](https://api.blockchain.info/stats) — stats, hash rate, difficulty, NVT, MVRV - [mempool.space API](https://mempool.space/api) — fees, mempool data - [CoinGecko](https://api.coingecko.com) — BTC price and market data # Actor input Schema ## `includeHistorical` (type: `boolean`): Fetch 7-day trend data for key metrics (hash rate, tx count). Adds ~3s to run time. ## `metrics` (type: `array`): Which metric categories to include. Empty = all. ## Actor input object example ```json { "includeHistorical": false, "metrics": [] } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("gochujang/bitcoin-network-health").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("gochujang/bitcoin-network-health").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call gochujang/bitcoin-network-health --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=gochujang/bitcoin-network-health", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bitcoin Network Health Dashboard", "description": "Real-time Bitcoin network metrics: hash rate, difficulty, mempool size, transaction count, mining revenue, block times, and fee rates. Fetches from blockchain.info and mempool.space. Perfect for miners, investors, and developers tracking BTC network activity.", "version": "0.1", "x-build-id": "lr8TzEdmB1qrNAJWo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gochujang~bitcoin-network-health/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gochujang-bitcoin-network-health", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/gochujang~bitcoin-network-health/runs": { "post": { "operationId": "runs-sync-gochujang-bitcoin-network-health", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/gochujang~bitcoin-network-health/run-sync": { "post": { "operationId": "run-sync-gochujang-bitcoin-network-health", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "includeHistorical": { "title": "Include Historical Trends", "type": "boolean", "description": "Fetch 7-day trend data for key metrics (hash rate, tx count). Adds ~3s to run time.", "default": false }, "metrics": { "title": "Metrics to Fetch", "type": "array", "description": "Which metric categories to include. Empty = all.", "default": [], "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```