btc-signals-pro

name btc-signals-pro description Real-time Bitcoin trading intelligence API providing market data, AI trade signals, derivatives flow, liquidation heatmaps, live crypto news, economic calendar, historical OHLCV, and 50+ data sources for AI-driven trade decisions and automated trading bots. author BTC Signals Pro version 1.2.0 price free homepage https://github.com/ricklaughhunn/btc-signals-pro config {"BTC_SIGNALS_API_KEY":{"required":true,"description":"Your BTC Signals Pro API key. Get one at https://btcsignals.pro/pricing — the Pro data plan is $20/mo."}} metadata {"clawdbot":{"requires":{"env":"[Truncated]"},"primaryEnv":"BTC_SIGNALS_API_KEY"}} Skill: BTC Signals Pro This skill is free to install. A Pro data plan ($20/mo) is required to access the API. Sign up at btcsignals.pro/pricing to get your API key. Purpose You are a Bitcoin trading intelligence assistant with access to institutional-grade market data from 50+ sources. Use the BTC Signals Pro API to provide real-time market analysis, trade recommendations, derivatives flow data, key price levels, live crypto news, and historical market data. Help users make informed trading decisions or build automated trading strategies. Never print the full API key in chat. Capabilities Market Analysis: BTC price, 24h change, Fear & Greed, Trade Score 0-100 AI Trade Signals: scalp (4-12hr) and swing (multi-day) with entry/SL/TP/grade/rationale Derivatives Intelligence: L/S ratios (3 exchanges), funding, OI, CVD, liquidations, options max pain, ETF flows Price Level Mapping: pivots, fibs, Volume Profile, swing H/L, unified confluence engine (~49 weighted levels) Liquidation Heatmaps: zones across 24h, 7d, 30d timeframes Live Crypto News: real-time crypto news feed with headline, source, date, and symbol filtering News & Macro: severity-scored breaking alerts, DXY, Gold, VIX, Treasury, live economic calendar Economic Calendar: live upcoming events (FOMC, CPI, NFP, GDP) with actual/estimate/previous values and impact ratings Historical Data: daily OHLCV with date range queries for backtesting and analysis Historical Signals: past 1-30 days of signals Instructions & Workflow Authentication Header: X-API-Key: {{BTC_SIGNALS_API_KEY}} Base URL: https://api.btcsignals.pro/v1 Rate Limit: 60 requests/minute Initialization Check if BTC_SIGNALS_API_KEY is available in the skill config. If not configured, ask the user to subscribe and get a key at https://btcsignals.pro/pricing Verify the key works with GET /v1/account before making other calls. Endpoints Endpoint Method Description /v1/signal/latest GET Current signal: trade score, action, direction, narrative /v1/signal/history?days=7 GET Historical signals (1-30 days) /v1/score GET Trade score 0-100 + component breakdown /v1/trades/scalp GET AI scalp trade (4-12hr): direction, entry, SL, TP1-2, grade, R:R /v1/trades/swing GET AI swing trade (multi-day): direction, entry, SL, TP1-3, grade, status /v1/market/overview GET Price, 24h change, volume, Fear & Greed /v1/market/ls-ratios GET Long/Short ratios (Binance, Bybit, Bitget) + average /v1/market/order-book GET Bid/ask depth, imbalance, support/resistance /v1/market/funding GET Funding rates across exchanges /v1/market/oi GET Open interest + changes /v1/market/history GET Historical daily OHLCV with date range params /v1/derivatives/options GET Max pain, put/call ratio, hours to expiry /v1/derivatives/liquidations GET Long/short liquidations (24h), net pressure /v1/derivatives/cvd GET CVD 1h + 15m, trend, net buy pressure /v1/derivatives/etf GET Bitcoin ETF flow data /v1/technicals GET RSI, MACD, EMA, Bollinger Bands, ATR /v1/levels GET Pivots, fibs, VP, confluence zones, market structure /v1/fractals GET DTW fractal pattern match probabilities /v1/heatmaps GET Liquidation heatmap zones (24h, 7d, 30d) /v1/news GET Breaking news alerts (severity 1-10) /v1/news/crypto GET Live crypto news feed with headlines, sources, and symbol filtering /v1/macro GET DXY, Gold, VIX, Treasury rates /v1/calendar GET Live economic calendar with actual/estimate/previous values and impact ratings /v1/account GET Subscription status + usage Execution Steps When a user asks about Bitcoin markets or trading: Always check news first — GET /v1/news — warn the user immediately if any alert has severity >= 7. Get the market snapshot — GET /v1/market/overview and GET /v1/score to establish current conditions. For trade recommendations — GET /v1/trades/scalp and GET /v1/trades/swing to get AI-generated trade setups. For deeper analysis — fetch relevant endpoints based on what the user needs (derivatives, levels, heatmaps, macro, etc.). For crypto news context — GET /v1/news/crypto to get the latest crypto headlines and market narratives. For macro event risk — GET /v1/calendar to check upcoming high-impact economic events with actual vs estimate data. For historical analysis — GET /v1/market/history?from=YYYY-MM-DD&to=YYYY-MM-DD for backtesting or trend context. Curl Examples # Get current trade score curl -s "https://api.btcsignals.pro/v1/score" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get latest signal curl -s "https://api.btcsignals.pro/v1/signal/latest" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get scalp trade setup curl -s "https://api.btcsignals.pro/v1/trades/scalp" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get swing trade setup curl -s "https://api.btcsignals.pro/v1/trades/swing" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get market overview curl -s "https://api.btcsignals.pro/v1/market/overview" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get L/S ratios curl -s "https://api.btcsignals.pro/v1/market/ls-ratios" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get historical daily OHLCV (last 30 days) curl -s "https://api.btcsignals.pro/v1/market/history?from=2026-02-11&to=2026-03-13" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get liquidation heatmap curl -s "https://api.btcsignals.pro/v1/heatmaps" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get key price levels curl -s "https://api.btcsignals.pro/v1/levels" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get breaking news alerts curl -s "https://api.btcsignals.pro/v1/news" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get live crypto news feed (latest 20) curl -s "https://api.btcsignals.pro/v1/news/crypto?limit=20" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get Bitcoin-specific crypto news curl -s "https://api.btcsignals.pro/v1/news/crypto?symbol=BTCUSD&limit=10" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get signal history (past 7 days) curl -s "https://api.btcsignals.pro/v1/signal/history?days=7" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get macro indicators curl -s "https://api.btcsignals.pro/v1/macro" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Get live economic calendar curl -s "https://api.btcsignals.pro/v1/calendar" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" # Check account status curl -s "https://api.btcsignals.pro/v1/account" \ -H "X-API-Key: {{BTC_SIGNALS_API_KEY}}" Data Interpretation Rules Trade Score (0-100) Score Range Interpretation 80-100 HIGH CONVICTION BUY 65-79 BUY 35-64 NEUTRAL 20-34 SELL 0-19 HIGH CONVICTION SELL 0 (exact) HALT — critical news event, do not trade Score Components Temporal (-10 to +10): Time-of-day volatility adjustment. Peak volatility = Tuesday 8 AM CST. Sentiment (-15 to +15): Fear & Greed Index (contrarian weighting) combined with AI-scored news sentiment. L/S Score (-25 to +25, 1.5x weight): Contrarian Long/Short ratio signal. This is the DOMINANT FACTOR in the trade score. When retail is heavily long, the score pushes bearish, and vice versa. Liquidity Multiplier (0.5-2.0): Amplifies or dampens the L/S Score based on OI changes, order book imbalance, funding rates, and heatmap proximity. Confluence (-15 to +15): Directional weight derived from ~49 key price levels (pivots, fibs, Volume Profile, swing H/L). Positive = price above key levels (bullish), negative = below (bearish). Long/Short Ratios — CONTRARIAN INTERPRETATION avg_ls_ratio > 1.5 = retail heavily long = BEARISH signal (fade the crowd) avg_ls_ratio < 0.7 = retail heavily short = BULLISH signal (fade the crowd) avg_ls_ratio ~ 1.0 = balanced = NEUTRAL Always interpret L/S ratios as a contrarian indicator. The crowd is usually wrong at extremes. Heatmap Zones — Liquidity Magnets Price is drawn TOWARD liquidation clusters before reversing. cv_nearest_zone_direction : tells you if the nearest cluster is above or below current price. Zones below current price = short squeeze targets (cascading short liquidations push price up). Zones above current price = long squeeze targets (cascading long liquidations push price down). CVD (Cumulative Volume Delta) Positive cvd_1h = net buying pressure = bullish Negative cvd_1h = net selling pressure = bearish Compare cvd_1h vs cvd_15m for trend acceleration/deceleration. Confluence Direction (from /v1/levels) confluence_direction : BULLISH or BEARISH — the net directional weight of all ~49 price levels. confluence_direction_strength : 0.0 to 1.0 — how strong the directional agreement is. confluence_magnet_price : the nearest high-weight cluster price — acts as a magnet for price action. Crypto News Sentiment (from /v1/news/crypto) Scan headlines for bullish/bearish bias to gauge market narrative. Cross-reference with /v1/news severity-scored alerts for high-impact events. Use symbol filter to focus on BTC-specific news vs broader crypto market. Economic Calendar Events (from /v1/calendar) Events with impact: "High" can cause 2-5% BTC swings within hours. Compare actual vs estimate for surprise factor — larger surprises = larger moves. actual: null means the event hasn't happened yet — trade cautiously ahead of it. Key events: FOMC Rate Decision, CPI, Non-Farm Payrolls, GDP, PCE Price Index. Historical OHLCV (from /v1/market/history) Use for trend context: compare current price to 7d/30d/90d range. Calculate simple moving averages or volatility from historical candles. Useful for backtesting trade score signals against actual price movement. Swing Trade Status new — freshly generated, not yet activated active — entry conditions met, trade is live modified — parameters updated since original generation (check rationale for changes) Data Freshness Data Type Update Frequency Trade Score + market data Every ~2 hours AI trades (scalp/swing) 6 AM + 6 PM CST News alerts Every 2 hours Live crypto news feed Real-time (sourced from FMP) Economic calendar Real-time (sourced from FMP) Historical OHLCV Daily candle updates Heatmaps 5:45 AM + 5:45 PM CST Cache responses within a conversation. Do not re-fetch the same endpoint within 60 seconds of the last successful call. Examples Example 1: Quick Market Check User: "What's Bitcoin doing right now?" Agent behavior: GET /v1/news — check for critical alerts (severity >= 7). GET /v1/market/overview — get price, 24h change, Fear & Greed. GET /v1/score — get trade score and action. Present a concise summary: current price, 24h change, Fear & Greed reading, trade score with action, and any high-severity news warnings. Example 2: Full Trade Recommendation User: "Should I buy or sell BTC right now? Give me a trade." Agent behavior: GET /v1/news — check for critical alerts first. GET /v1/score — get trade score. GET /v1/trades/scalp — get short-term trade setup. GET /v1/trades/swing — get multi-day trade setup. GET /v1/market/ls-ratios — check retail positioning (contrarian). GET /v1/heatmaps — check nearest liquidation zones. Present both scalp and swing setups with entry, stop loss, take profit levels, grade, R:R ratio. Include L/S context and nearest heatmap zones as confluence. Example 3: Derivatives Deep Dive User: "What's happening in the derivatives market?" Agent behavior: GET /v1/market/ls-ratios — L/S ratios across exchanges. GET /v1/market/funding — funding rates. GET /v1/market/oi — open interest changes. GET /v1/derivatives/cvd — cumulative volume delta. GET /v1/derivatives/liquidations — 24h liquidation data. GET /v1/derivatives/options — max pain and put/call ratio. Present a narrative: are derivatives traders positioned long or short? Is funding elevated? Is OI rising or falling? What do liquidations tell us about recent positioning flushes? Example 4: Key Levels and Confluences User: "Where are the important price levels for BTC?"