--- name: btcnode.uk description: btcnode.uk provides Bitcoin network data and utility endpoints, including node status, mempool fee estimates, fee forecasting, and whale transaction detection. It also exposes a general-purpose URL scraper and a Reddit trending feed endpoint. All skills are single-shot, stateless API calls with no streaming or historical data. host: btcnode.uk --- # btcnode.uk btcnode.uk is a small-footprint API host primarily serving Bitcoin on-chain and mempool intelligence: node health, fee estimation, fee forecasting, and large-transaction detection. Two unrelated utilities — a URL scraper and a Reddit trending feed — are also available on the same host. It targets agents that need lightweight, no-auth Bitcoin network snapshots without running their own node infrastructure. ## When to use this host Use btcnode.uk when an agent needs lightweight, stateless Bitcoin network snapshots: node status, current fee tiers, short-term fee forecasting, or mempool whale detection. It is not suitable for historical block or transaction data (use a full block explorer API such as Blockstream or Mempool.space instead), confirmed transaction lookups, non-Bitcoin chains, or streaming/real-time fee monitoring. The URL scraper is a single-URL, single-shot tool — do not use it for JavaScript-rendered SPAs or bulk crawling. The Reddit skill is limited strictly to r/popular and cannot target specific subreddits, user profiles, or comment threads; use the Reddit API directly for those needs. ## Capabilities ### Bitcoin Node Health Provides a real-time snapshot of a Bitcoin node's operational state, including block height, mining difficulty, peer count, and chain confirmation. - **`fetch-btc-node-info`** — Returns a Bitcoin node status snapshot including chain name, current block height, mining difficulty, and active peer connection count. ### Bitcoin Fee Estimation Returns current sat/vB fee estimates for high, medium, and low priority transactions, enabling agents to select an appropriate fee tier before constructing a transaction. - **`fetch-btc-fee-estimates`** — Returns current Bitcoin network fee estimates in sat/vB for high, medium, and low priority transactions. ### Bitcoin Fee Forecasting Extends basic fee estimation with next-3-block predictions, mempool congestion stats, and a trend forecast with confidence signals, supporting decisions about whether to transact now or wait. - **`fetch-btc-fee-forecast`** — Returns current Bitcoin network fee estimates, next-3-block fee predictions, mempool stats, and a trend forecast in sat/vB. ### Mempool Whale Detection Filters the current Bitcoin mempool for large unconfirmed transactions above a configurable BTC threshold, returning txid, value, fee, and addresses for on-chain analytics or trading signals. - **`fetch-bitcoin-whale-transactions`** — Returns large Bitcoin mempool transactions above a configurable BTC threshold, including txid, value, fee, timestamp, and involved addresses. ### Web & Social Content Retrieval Fetches and cleans text from a single web URL or retrieves the current top-25 trending posts from Reddit r/popular, supporting content analysis and social trend discovery. - **`scrape-url-to-text`** — Fetches a URL and returns its cleaned text content, title, word count, character count, and truncation status as structured JSON. - **`fetch-reddit-trending-posts`** — Fetches the top 25 trending posts from r/popular on Reddit, including titles, authors, scores, comment counts, URLs, and thumbnails. ## Workflows ### Bitcoin Transaction Readiness Check *Use when an agent needs to decide whether to broadcast a Bitcoin transaction now or defer, based on both node health and current fee conditions.* 1. **`fetch-btc-node-info`** — Confirm the node is on mainnet, synced to a recent block height, and has active peer connections before proceeding. 2. **`fetch-btc-fee-forecast`** — Retrieve the fee trend forecast and next-3-block predictions to determine whether current fees are rising, falling, or stable, and select an optimal fee rate. ### Mempool Congestion and Whale Alert *Use when an agent needs to assess whether unusual large-transaction activity is contributing to mempool congestion and elevated fees.* 1. **`fetch-btc-fee-estimates`** — Capture the current baseline fee estimates to establish whether fees are elevated. 2. **`fetch-bitcoin-whale-transactions`** — Query the mempool for large transactions above a chosen BTC threshold to determine whether whale activity is a likely driver of congestion. ## Skill reference ### `fetch-btc-fee-forecast` **BTC Fee Predictor** — Returns current Bitcoin network fee estimates, next-3-block fee predictions, mempool stats, and a trend forecast in sat/vB. *Use when:* Use when an agent needs to determine optimal Bitcoin transaction fee rates, assess mempool congestion, or decide whether to delay a transaction based on fee trend and confidence. *Not for:* Do not use for real-time streaming fee updates; this is a single-shot snapshot. Not suitable for non-Bitcoin networks or altcoin fee estimation. **Returns:** Returns current high/medium/low fee rates, per-block predictions for the next 3 blocks, mempool pending tx count and congestion level, and a trend forecast with confidence percentage, all in sat/vB. **Example:** `GET https://btcnode.uk/api/fees/predict` --- ### `fetch-reddit-trending-posts` **Reddit Trend Pulse** — Fetches the top 25 trending posts from r/popular on Reddit, including titles, authors, scores, comment counts, URLs, and thumbnails. *Use when:* Use when an agent needs a snapshot of currently trending Reddit content across popular subreddits, such as for social trend analysis, content discovery, or surfacing viral posts. *Not for:* Do not use for subreddit-specific feeds, user profile lookups, comment threads, or historical Reddit data; this endpoint returns only the current r/popular trending feed. **Returns:** Returns a JSON object with count=25, subreddit='popular', and a posts array of 25 trending Reddit posts each containing id, title, author, subreddit, score, upvote_ratio, num_comments, created_utc, url, permalink, thumbnail, domain, and over_18. **Example:** `GET https://btcnode.uk/api/reddit/trending` --- ### `scrape-url-to-text` **BTC Node URL Scraper** — Fetches a URL and returns its cleaned text content, title, word count, character count, and truncation status as structured JSON. *Use when:* Use when an agent needs to extract readable text from a web page URL, such as for summarization, content analysis, or data extraction from a specific webpage. *Not for:* Do not use for scraping JavaScript-heavy single-page applications that require browser rendering; results may be incomplete. Not suitable for bulk crawling or sitemap traversal — this is a single-URL, single-shot scrape. **Inputs:** - `url` (string, required) — The fully-qualified URL of the page to scrape. - `forceFresh` (boolean) — If true, bypasses any cached result and fetches a fresh copy of the page. - `maxChars` (integer) — Maximum number of characters to return in the text field. If the content exceeds this limit, the response will have truncated=true. **Returns:** Returns a JSON object with the scraped page URL, title, cleaned text, word_count, char_count, truncated flag, timestamp, and success=true. **Example:** `{"url": "https://example.com", "forceFresh": false, "maxChars": 1000}` --- ### `fetch-bitcoin-whale-transactions` **Whale Watch API** — Returns large Bitcoin mempool transactions above a configurable BTC threshold, including txid, value, fee, timestamp, and involved addresses. *Use when:* Use when an agent needs to detect or monitor large Bitcoin transactions (whale activity) currently in the mempool, filtered by a minimum BTC value, to inform trading signals, risk alerts, or on-chain analytics. *Not for:* Do not use for historical Bitcoin transaction lookups or confirmed block data; this endpoint reflects mempool (unconfirmed) transactions only. Not suitable for non-Bitcoin chains. **Inputs:** - `min_btc` (number) — Minimum transaction value in BTC to include in results. Defaults to 100, minimum allowed is 10. - `limit` (integer) — Maximum number of transactions to return. Defaults to 50, maximum is 100. **Returns:** Returns success=true, a count of matching transactions, the applied min_btc floor, and an array of transactions each with txid, value_btc, fee_sats, ISO 8601 time, involved addresses, and vsize. **Example:** `GET https://btcnode.uk/api/whales?min_btc=100&limit=50` --- ### `fetch-btc-node-info` **BTC Node Info** — Returns a Bitcoin node status snapshot including chain name, current block height, mining difficulty, and active peer connection count. *Use when:* Use when an agent needs to check the current state of a Bitcoin node, such as verifying block height, confirming the node is on mainnet, checking peer connectivity, or monitoring mining difficulty. *Not for:* Do not use for historical block data, transaction lookups, or mempool queries; use a Bitcoin block explorer or full node RPC API instead. **Returns:** Returns a JSON object with chain='main', current block height (e.g. 951350), mining difficulty (e.g. 136607070854775.1), peer connection count (e.g. 10), and success=true. **Example:** `GET https://btcnode.uk/api/info` --- ### `fetch-btc-fee-estimates` **BTC Fee Radar** — Returns current Bitcoin network fee estimates in sat/vB for high, medium, and low priority transactions. *Use when:* Use when an agent needs current Bitcoin mempool fee estimates to recommend or calculate transaction fees before constructing or broadcasting a Bitcoin transaction. *Not for:* Do not use for historical fee data or fee forecasting over time; this is a single-shot current estimate only. **Returns:** Returns high, medium, and low fee estimates in sat/vB as integers, the unit string, an ISO 8601 updated_at timestamp, and success=true. **Example:** `GET https://btcnode.uk/api/fees` ---