Documentation

Bitcoin trading intelligence that connects to your AI agent through OpenClaw. Just ask questions in plain English.

Overview

BTC Signals Pro is a Bitcoin trading intelligence service that gives your AI agent access to institutional-grade market data. A multi-step pipeline runs every hour, collecting 200+ data points from 44+ sources. An AI engine generates trade recommendations when significant price movement is detected.

You interact with it through natural language — ask your AI agent a question, and the OpenClaw skill automatically queries the right data, interprets it, and gives you an actionable answer.

Setup

Get up and running in under 2 minutes:

Your First Prompt

Try asking your AI agent: “What is Bitcoin doing right now?”

Behind the scenes, the skill automatically executes a multi-step workflow:

You get a complete market picture in seconds — price, trend, sentiment, trade score, and any breaking news — without touching a single API endpoint.

Prompt Library

Here are 24 ready-to-use prompts organized by category. Copy any of them and send to your AI agent — the skill handles the rest.

The Power Prompt

This is the most comprehensive single prompt you can give your AI agent. It triggers a full multi-endpoint analysis and produces a complete trade recommendation with exit strategy:

This prompt will cause the agent to query market history, price levels, L/S ratios, heatmaps, trade setups, and news to build a complete trade picture.

Bot Integration Patterns

For users who want their AI agent to act autonomously, these pre-built trading patterns define specific decision-making logic:

Pattern 1: Score-Based Entry

Poll the trade score every 2 hours. Enter LONG when score ≥ 65, SHORT when score ≤ 34, HALT (close all) when score = 0. Use the AI scalp setup for exact Entry/SL/TP levels.

Pattern 2: Contrarian L/S Extreme

Fade retail positioning. If the average L/S ratio > 1.8, open a short. If < 0.55, open a long. Confirm with CVD direction. Target the nearest heatmap liquidation zone for Take Profit.

Pattern 3: News-Aware Trading

Always check news before entry. Severity ≥ 8: no new trades, tighten stops. Severity ≥ 9: close all positions. FOMC/CPI/NFP within 4 hours: reduce size 50%. Within 1 hour: close all.

Pattern 4: Multi-Factor Confirmation

Score 5 factors as +1/0/-1: trade score, L/S ratio, heatmap direction, confluence direction, CVD. Sum ≥ +3: enter LONG. Sum ≤ -3: enter SHORT. Between -2 and +2: no trade.

Pattern 5: Swing Trade Management

Fetch the swing setup at 6 AM and 6 PM CST. If status = “new”: place limit order with 3-tier TP (33%/33%/34%). If “active”: monitor score every 2 hours, tighten to breakeven if score flips. If “modified”: update levels per new parameters.

Email Reports

Get a comprehensive HTML trade report delivered straight to your inbox. The report includes the current trade score, AI scalp and swing setups with exact levels, technical analysis, derivatives data, and the AI market narrative.

Using OpenClaw (Easiest)

Just ask your AI agent:

Using curl (Developers)

Send a report to any email address with a single API call:

Response:

Preview the Report (No Email)

To view the report HTML without sending an email:

What’s in the Report

Multi-Token Coverage

BTC Signals Pro is built Bitcoin-first — the entire 16-step pipeline, trade score, confluence engine, and AI recommendations are optimized for BTC. However, the underlying data infrastructure supports additional tokens through specific endpoints.

Crypto News by Symbol

The /v1/news/crypto endpoint accepts a symbol parameter to filter cryptocurrency news by any supported token:

Returns recent crypto news filtered by symbol. Supports BTC, ETH, SOL, XRP, DOGE, ADA, AVAX, LINK, DOT, and any other symbol tracked by the upstream news feed.

Example: Fetch Ethereum News

Example: Fetch Solana News

OpenClaw Prompt Examples

Supported Symbols

Omit the symbol parameter to get all crypto news regardless of token.

Expansion Roadmap

The following capabilities exist in the underlying data infrastructure and are planned for future API exposure:

Token Metrics Guide

A complete guide to every metric the API tracks. Each section explains what the metric is, how the API exposes it, and how traders use it in practice.

Cumulative Volume Delta (CVD)

CVD tracks the net difference between buy-initiated and sell-initiated volume over time. Rising CVD means buyers are more aggressive (market orders hitting the ask); falling CVD means sellers dominate (market orders hitting the bid). Unlike regular volume, CVD reveals who is driving the market.

Trading Context

Rising CVD during a pullback suggests dip-buying strength — buyers are stepping in despite the price drop. Falling CVD during a rally warns of distribution — price is rising but on sell pressure. The most powerful signal is divergence: price making new highs while CVD makes lower highs is a classic reversal warning.

Liquidations

Liquidations occur when leveraged positions are force-closed because the trader's margin is insufficient to cover losses. Large liquidation cascades create sharp, violent price moves as exchanges dump positions into the order book. Tracking liquidation imbalances reveals which side of the market is being punished.

Trading Context

Heavy long liquidations during a dump indicate capitulation — overleveraged longs are being flushed out, which often marks a local bottom. Extreme short liquidations during a pump indicate a short squeeze. The net imbalance shows which side is getting hurt more, and large liquidation events often precede trend reversals as the weak hands are cleared.

Funding Rate

The funding rate is a periodic payment between long and short perpetual futures traders, designed to keep perpetual contract prices anchored to spot. Positive funding means longs pay shorts (the crowd is bullish). Negative funding means shorts pay longs (the crowd is bearish). It resets every 8 hours on most exchanges.

Funding rate data is embedded in the technical_summary field alongside other technical indicators.

Trading Context

Extreme positive funding (>0.05%) means longs are paying a premium to stay open — the market is overleveraged long and ripe for a correction (contrarian bearish). Extreme negative funding means shorts are paying, suggesting overleveraged shorts (contrarian bullish). Near-zero funding is neutral and indicates balanced positioning.

Open Interest (OI)

Open interest is the total number of outstanding derivative contracts that have not been settled. Unlike volume (which counts contracts traded), OI measures how many contracts are currently open. Rising OI means new money is entering; falling OI means positions are being closed.

Open interest data is embedded in the technical_summary field from the technicals endpoint.

Trading Context

Rising OI + rising price = strong trend (new longs opening, confidence in the move). Rising OI + falling price = strong downtrend (new shorts opening). Falling OI + rising price = short squeeze (shorts closing, not new buying — the rally may lack conviction). Falling OI + falling price = long capitulation (longs giving up).

Max Pain (Options)

Max pain is the price at which the maximum number of options contracts (puts and calls combined) expire worthless, causing the least payout from options writers. Because options writers (typically institutions) have an incentive to move price toward max pain before expiry, it acts as a "price magnet."

Trading Context

Price tends to gravitate toward max pain in the 48–72 hours before expiry. If current price is significantly above max pain, expect downward pressure as expiry approaches. If significantly below, expect upward pull. The effect is strongest with large open interest and weakens after expiry passes. Use max pain as a target zone, not a precise level.

Long/Short Ratios

Long/Short ratios show the proportion of retail traders holding long vs. short positions on futures exchanges. This is a contrarian indicator — when the retail crowd piles heavily to one side, the market tends to move against them. BTC Signals Pro collects ratios from three major exchanges for a comprehensive view.

Trading Context

Average L/S > 1.8 = retail is heavily long — contrarian SHORT signal. Average L/S < 0.55 = retail is heavily short — contrarian LONG signal. This metric carries 1.5x weight in the Trade Score because of its strong historical reliability. When all three exchanges agree on direction, the signal is even more significant.

Fear & Greed Index

The Fear & Greed Index measures overall crypto market sentiment on a 0–100 scale. It considers volatility, market momentum, social media activity, dominance ratios, and trends to produce a single sentiment reading.

Trading Context

Extreme Fear (0–25) historically marks buying opportunities — when everyone is afraid, assets are often undervalued. Extreme Greed (75–100) historically marks distribution zones — when everyone is euphoric, smart money is selling. Use it as confirmation alongside other signals, not as a sole entry trigger.

Order Book Depth

Order book analysis compares the total bid (buy) volume against ask (sell) volume near the current price. A heavy bid-side imbalance suggests strong demand (buyers stacking orders); heavy asks suggest supply pressure (sellers defending a level).

Trading Context

Imbalance > 1.5 suggests buyers are stacking orders — bullish support is building. Imbalance < 0.67 suggests sellers are dominant with overhead supply. Sudden shifts in the book (large orders appearing or disappearing) can front-run price moves. The strongest support and resistance levels act as short-term magnets and bounce zones.

Confluence Engine

The Confluence Engine calculates approximately 49 weighted price levels from multiple independent technical methods: pivot points, Fibonacci retracements, Volume Profile (POC, VAH, VAL), period opens (daily, weekly, monthly), swing highs/lows, and market structure levels. When multiple independent methods agree on the same price zone, it creates a "confluence zone" with higher significance than any single level.

Trading Context

The magnet price represents the strongest price attractor — price tends to gravitate toward it. If the magnet is above current price with BULLISH direction, expect upside pull. A high nearby levels count means the current price is sitting on significant support/resistance (expect a reaction). Confluence zones are ideal areas to place entries, stop losses, and take-profit targets because they represent prices where multiple independent analyses agree.

Trade Score (0–100)

The Trade Score is a composite number synthesizing multiple components into a single 0–100 reading. It combines temporal bias (macro event proximity), sentiment (Fear & Greed + L/S weighting), liquidity analysis (order book depth + CVD), a liquidity multiplier (0.5x–2.0x for confluence zones), and confluence scoring (~49 weighted levels).

Trading Context

Score 65+ = GO (high-probability setup, enter with confidence). Score 35–64 = WAIT or CAUTION (conditions are mixed, avoid new positions or reduce size). Score below 35 = AVOID (conditions favor the opposite direction or are too uncertain). Score of 0 = HALT (extreme news severity or imminent economic event — close all positions). The liquidity component is dominant (±25 points) because L/S positioning has the strongest predictive value.

Fractal Analysis (DTW)

Fractal analysis uses Dynamic Time Warping (DTW) to compare the current price pattern against 3 years of historical BTC data (27,000+ candles). When the current pattern closely matches a historical pattern, the system predicts what happened next based on the historical outcome. DTW is superior to simple correlation because it accounts for patterns that are similar but occur at different speeds.

Trading Context

Match probability above 72% is considered significant (DTW distance threshold 0.72). The system reports the expected direction and magnitude based on what followed the historical match. Use fractal analysis as confirmation alongside the Trade Score — when both agree on direction, conviction increases substantially. Below 72% match quality, the signal is informational but not actionable.

Market Structure

Market structure identifies the prevailing directional bias from recent price action: BULLISH (higher highs and higher lows), BEARISH (lower highs and lower lows), or RANGING (consolidation with no clear trend). It is determined from swing point analysis and Break of Structure (BOS) / Change of Character (CHoCH) events.

Trading Context

Always trade in the direction of structure. BULLISH structure = favor longs, look for dip entries near support. BEARISH structure = favor shorts, sell rallies into resistance. RANGING = reduce position size and play the range boundaries (buy support, sell resistance). A Change of Character (CHoCH) from bullish to bearish structure is one of the earliest reversal signals.

Liquidation Heatmaps

Liquidation heatmaps visualize where leveraged positions are clustered across price levels. They are captured at 24h, 7d, and 30d timeframes using computer vision analysis (OpenCV + Tesseract OCR) of CoinGlass heatmap screenshots. Dense zones represent prices where cascading liquidations are most likely to trigger.

7-day and 30-day heatmaps use the same fields with _7d and _30d suffixes respectively.

Trading Context

Price is attracted to liquidation clusters because market makers hunt these zones for liquidity. If the nearest zone is above current price, expect upside pull as the market seeks to trigger those liquidations. If below, expect downside pull. Use the nearest zone as a take-profit target for scalp trades. Dense 7d and 30d zones are stronger magnets than 24h zones. When price reaches a zone, expect a sharp reaction (reversal or acceleration) as cascading liquidations fire.

API Reference