API Documentation

Integrate real-time Bitcoin signals, market data, and trade recommendations into your own tools.

RESTful JSON API Key Auth Tier-Gated Access

Quick Start

1

Get your API key

Subscribe to a Pro or Elite plan, then find your API key in the Dashboard.

2

Authenticate your requests

Include your API key in the X-API-Key header of every request.

# Example request
curl https://api.btcsignals.pro/v1/signal/latest \
-H "X-API-Key: your_api_key_here"
3

Parse the JSON response

All endpoints return a consistent JSON envelope:

{
"success": true,
"data": { ... }
}

Access by Tier

Feature Free Pro Elite
API Endpoints 5 20 31 (all)
Rate Limit 10/hr 3,600/hr 7,200/hr
Real-time Signals
AI Trade Recommendations Entries Full + Reasoning
Bot Trade Log Summary Full History + Equity
Telegram Alerts
Email Reports

Authentication

All API requests require an API key passed via the X-API-Key HTTP header.

GET /v1/signal/latest HTTP/1.1
Host: api.btcsignals.pro
X-API-Key: bsp_your_64_char_hex_key_here
Accept: application/json

Missing or invalid keys return 401 Unauthorized. Exceeding your rate limit returns 429 Too Many Requests with a resets_at timestamp.

Endpoints

Signals

GET /v1/signal/latest Pro+

Latest signal with direction, confidence, trade score, narrative, and recommendation.

{ "direction": "bullish", "confidence": 78, "trade_score": 7.2, ... }
GET /v1/signal/history?days=7 Pro+

Historical signals for the past N days (max 30). Returns up to 2 signals per day.

Param: days (int, default 7, max 30)

Market Data

GET /v1/market/overview Free+

Price, 24h change, fear/greed index, L/S ratios, order book imbalance, bid/ask depth, CVD, and liquidations.

GET /v1/market/ls-ratios Free+

Long/short ratio data across exchanges.

GET /v1/macro Free+

Macro indicators: DXY, Gold, VIX.

Technical Analysis

GET /v1/score Pro+

Full trade score breakdown: action, temporal, sentiment, liquidity, and confluence sub-scores.

GET /v1/levels Pro+

Price levels: opens, pivots, Fibonacci, volume profile (POC/VAH/VAL), confluence zones, and max pain.

GET /v1/heatmaps Pro+

Liquidity heatmap zones across 24h, 7d, and 30d timeframes with nearest zone direction and distance.

AI Trade Recommendations

GET /v1/trades/scalp Pro+

Current scalp trade setup: direction, grade, entry, stop-loss, targets, risk-reward ratio, and rationale.

GET /v1/trades/swing Pro+

Current swing trade setup: direction, grade, entry, SL, up to 3 take-profit targets, RR, timeframe, and status.

News & Events

GET /v1/news Free+

Active news alerts with severity, headline, summary, source, and expiration. Up to 20 items.

Derivatives

GET /v1/derivatives/funding Pro+

Funding rate data from major exchanges.

Bot Trade Data (Web Session Auth)

These endpoints use session authentication (logged-in user) rather than API keys. Available via the dashboard.

GET /api/bot-trades.php?action=summary Pro+

Aggregate bot performance: total trades, wins, win rate, total PnL.

GET /api/bot-trades.php?action=history&limit=50 Elite

Individual closed trade records with entry/exit prices, PnL, and strategy.

GET /api/bot-trades.php?action=equity Elite

90-day equity curve snapshots with balance and unrealized PnL.

HTTP Status Codes

200 Success — data returned in response
400 Bad request — missing or invalid parameters
401 Unauthorized — missing or invalid API key
403 Forbidden — insufficient tier for this endpoint
429 Rate limited — includes resets_at timestamp
500 Server error — try again later

Code Examples

cURL

# Get latest signal
curl -s \
-H "X-API-Key: $BSP_KEY" \
https://api.btcsignals.pro/v1/signal/latest

Python

import requests
 
resp = requests.get(
"https://api.btcsignals.pro/v1/signal/latest",
headers={"X-API-Key": BSP_KEY}
)
data = resp.json()["data"]

JavaScript

const resp = await fetch(
"https://api.btcsignals.pro/v1/score",
{ headers: { "X-API-Key": BSP_KEY } }
);
const { data } = await resp.json();

Ready to integrate?

Get your API key with a Pro or Elite subscription.

View Plans →