Home/Docs

Documentation

v1.0

Documentation

CryptoSignal Pro user documentation: getting started, scanner, signals, API reference, backtesting, webhooks, and FAQ.

▶Quick Start ⟨⟩API Reference ⇡Webhooks ⚡Auto-Trade Bot

Quick Start

Free

1
Create a Free Account
Sign up at /register — email or Google/GitHub OAuth. No credit card required.
2
Open the Scanner
Go to /scanner, enter any ticker (BTC/USDT, ETH/USDT, etc.), select a timeframe, and run analysis.
3
Read the Signal
The result shows grade, entry zone, TP1/TP2/TP3, stop loss, net R:R, and per-layer score breakdown.
4
Set Up Alerts
Alerts → New Alert. Choose grade filter, asset, and direction. Email delivery is free; webhook requires Pro.
5
Enable Auto-Trade (Optional)
Settings → Exchanges → connect an API key. Configure a bot with grade filter and position size. Requires Elite.

Key Concepts

Free

Confluence Score: A 0-100 number representing how strongly five independent models agree on a setup.
Signal Grade: Letter grade A+ through D based on confluence score, net R:R, and gate results.
Net R:R: Risk-reward after deducting taker fees (0.04%), slippage (0.03%), and funding per side.
OB / FVG: Order Block and Fair Value Gap — SMC-based entry zone structures used to define the entry range.
Market Regime: 6 detected states (strong trend, weak trend, range, high volatility, crash, recovery) that shift layer weights.
Source Health: Live/stale/unavailable status for each data feed. Stale feeds reduce their layer weight automatically.
Divergence Veto: Fires when the technical and derivatives layer scores diverge by more than 40 points — suppresses the signal.
Walk-Forward: Backtest method that splits data into in-sample and out-of-sample windows to prevent overfitting.

Reading a Signal

Free

Every signal card contains the following fields:

Symbol / DirectionThe asset pair and trade direction. LONG = buy, SHORT = sell.

GradeA+ through D. Only A+, A, B grades are shown as actionable by default. C/D are informational.

ScoreThe raw 0-100 confluence number before gating. Shown next to the grade.

Entry ZoneLow-high price range derived from the detected Order Block and/or Fair Value Gap.

TP1 / TP2Take-profit targets. TP1 is a partial-close level; TP2 is the full target. TP3 is shown on high-confidence setups.

SLStop-loss level. Set below (LONG) or above (SHORT) the order block that defines the setup.

Net R:RRisk-reward after all fees and slippage. The gross R:R is never used as the headline number.

Score BreakdownPer-layer bars showing Technical, On-Chain, Sentiment, Macro, and Derivatives scores independently.

Source HealthLive/stale dot per data feed. Amber = stale (>15 min), grey = unavailable.

Scanner

Free

The scanner analyzes any supported asset on demand.

Supported markets

Any CCXT-compatible spot or perpetual pair. Enter as BASE/QUOTE (e.g. BTC/USDT, SOL/USDT).

Timeframes

15m, 1H, 4H, 1D, 1W. Higher timeframes produce fewer but higher-quality signals.

Result latency

Typical analysis completes in < 3 seconds. First run on a cold pair may take up to 8 seconds.

Rate limits

Free: 20 scans/day. Pro: 200/day. Elite: unlimited.

Open Scanner

Go to /scanner to start analyzing markets.

Scoring Methodology

Read the full methodology

Signal Feed

Free

The Signal Feed displays all system-generated signals.

Grade filterFilter to A+, A, B, C. Default is A+ and A only.

Direction filterLONG only, SHORT only, or both.

Status filterActive (entry zone not triggered), triggered (entry hit), closed.

Timeframe filterShow only signals from selected timeframes.

Pair filterPin specific assets (e.g. BTC/USDT, ETH/USDT) to the top.

Alerts

Pro

Create alerts to get notified when signals matching your criteria fire.

DeliveryEmail (Free). Webhook HTTP POST (Pro+). Discord bot (Pro+).

Grade filterTrigger only on A+, A+/A, or all grades.

DirectionLONG, SHORT, or both.

Asset filterAll markets or a specific watchlist.

TimeframeTrigger on any timeframe or a specific one (e.g. 4H only).

CooldownMinimum minutes between two alerts for the same asset. Prevents spam on choppy setups.

Webhook alerts require Pro plan. Discord delivery requires a bot connection in Settings.

Backtesting

Pro

Test your signal configuration against historical data.

Historical data

Up to 4 years on major pairs. 6 supported exchanges.

Walk-forward

Configurable train/test split. Out-of-sample results only shown.

Fee inclusion

All backtest P&L includes taker fee, slippage, and funding.

Grade breakdown

Separate win rate and R:R reported per grade (A+, A, B).

Export

Download full results as CSV (Elite only).

Min sample size

A minimum of 30 signals is required to display backtest results.

REST API

Elite

Authenticate using your API key from Authorization Settings → API. Pass the key as a Bearer token.

Authentication

HTTP

GET /api/v1/signals
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Key Endpoints

GET

/api/v1/signals

List recent signals

POST

/api/v1/analyze

Run analysis on a symbol

GET

/api/v1/signals/:id

List your alerts

GET

/api/v1/health

Create a new alert

GET

/api/v1/webhooks

List your bots

POST

/api/v1/webhooks

Create a new bot

DELETE

/api/v1/webhooks/:id

Delete a bot

Rate Limits

GET /signals120 req / min

POST /analyze10 req / min

All others: 60 req/min60 req / min

Webhooks

Pro

Webhook payloads are sent as POST requests with JSON body.

Example Payload

JSON

{
  "signal":    "BTC/USDT",
  "direction": "LONG",
  "grade":     "A+",
  "score":     87,
  "entryLow":  95200,
  "entryHigh": 96400,
  "tp1":       98500,
  "tp2":       102000,
  "sl":        92800,
  "netRR":     2.9,
  "timeframe": "4H",
  "timestamp": "2025-06-12T14:23:00Z"
}

Security & Reliability

SignatureEach payload is signed with HMAC-SHA256. Verify the X-CSP-Signature header.

Retries3 automatic retries on 4xx/5xx response. Exponential backoff: 10s, 60s, 300s.

TimeoutYour endpoint must respond within 5 seconds or the request is considered failed.

HTTPS onlyHTTP endpoints are rejected. Only HTTPS URLs are accepted.

Auto-Trade Bot

Elite

The auto-trade bot routes grade-filtered signals to your exchange account.

Supported exchanges

Binance, Bybit, OKX, KuCoin, MEXC, Gate.io

Key storage

AES-256 encryption. Read + trade only — withdrawal scope never requested.

Grade filter

Execute on A+ only, A+/A, or all actionable grades.

Position limit

Maximum % of account balance per trade (e.g. 1%, 2%).

Kill switch

Stop all active bots and cancel pending orders in < 2 seconds.

Max simultaneous

Pro: 3 active bots. Elite: unlimited bots across all exchanges.

Paper mode

Full simulation — no real capital. Available on all plans.

TP/SL execution

TP1, TP2, and SL orders are placed simultaneously with entry.

Risk Notice Signal analysis is not financial advice. All trading involves risk of loss.

FAQ

Is there a free plan?+

Yes. The free plan includes 20 scanner analyses per day, access to the signal feed, and email alerts. No credit card required.

Which exchanges are supported for auto-trading?+

Binance, Bybit, OKX, KuCoin, MEXC, and Gate.io. Spot and perpetual futures markets on all.

Can I cancel my plan at any time?+

Yes. Cancel anytime from Settings → Billing. Your access continues until the end of the billing period.

Does the bot require me to be online?+

No. The bot runs server-side. You do not need to keep a browser open. The kill switch is available in your dashboard or via API.

How is my API key secured?+

Exchange API keys are encrypted at rest with AES-256. We request read + trade only — withdrawal permissions are never required.

Quick Start

Create a Free Account

Open the Scanner

Read the Signal

Set Up Alerts

Enable Auto-Trade (Optional)

Key Concepts

Reading a Signal

Scanner

Open Scanner

Scoring Methodology

Signal Feed

Alerts

Backtesting

REST API

Authentication

Key Endpoints

Rate Limits

Webhooks

Example Payload

Security & Reliability

Auto-Trade Bot

FAQ

Support & Contact

Browse Q&A →

Contact Support →

Changelog →

Quick Start

Create a Free Account

Open the Scanner

Read the Signal

Set Up Alerts

Enable Auto-Trade (Optional)

Key Concepts

Reading a Signal

Scanner

Open Scanner

Scoring Methodology

Signal Feed

Alerts

Backtesting

REST API

Authentication

Key Endpoints

Rate Limits

Webhooks

Example Payload

Security & Reliability

Auto-Trade Bot

FAQ

Support & Contact

Browse Q&A →

Contact Support →

Changelog →