btc-signals-pro

What this skill does

# 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](https://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

1. Check if `BTC_SIGNALS_API_KEY` is available in the skill config.
2. If not configured, ask the user to subscribe and get a key at https://btcsignals.pro/pricing
3. 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:

1. **Always check news first** — `GET /v1/news` — warn the user immediately if any alert has severity >= 7.
2. **Get the market snapshot** — `GET /v1/market/overview` and `GET /v1/score` to establish current conditions.
3. **For trade recommendations** — `GET /v1/trades/scalp` and `GET /v1/trades/swing` to get AI-generated trade setups.
4. **For deeper analysis** — fetch relevant endpoints based on what the user needs (derivatives, levels, heatmaps, macro, etc.).
5. **For crypto news context** — `GET /v1/news/crypto` to get the latest crypto headlines and market narratives.
6. **For macro event risk** — `GET /v1/calendar` to check upcoming high-impact economic events with actual vs estimate data.
7. **For historical analysis** — `GET /v1/market/history?from=YYYY-MM-DD&to=YYYY-MM-DD` for backtesting or trend context.

#### Curl Examples

```bash
# 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