API Documentation

Introduction

The DipCatcher Pro API provides programmatic access to our trading signals, market analysis, and portfolio management features. Build custom trading bots, integrate signals into your existing systems, or create entirely new trading applications.

Base URL

https://api.dipcatcher.pro/v1

WebSocket URL

Supabase Realtime (via Supabase client)

Quick Start

To get started with the DipCatcher Pro API:

Sign up for a DipCatcher Pro account
Generate your API keys from the dashboard
Make your first API call

Authentication

All API requests require authentication using API keys. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

Example Request

curl -X GET https://api.dipcatcher.pro/v1/signals \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Rate Limits

API rate limits vary by subscription plan:

Plan	Requests/Minute	Requests/Hour	Requests/Day
Starter	60	1,000	10,000
Professional	300	5,000	50,000
Enterprise	Unlimited	Unlimited	Unlimited

Signals

GET /signals

Retrieve the latest trading signals based on AI analysis.

Query Parameters

Parameter	Type	Required	Description
symbol	string	No	Filter by trading pair (e.g., BTC/USDT)
exchange	string	No	Filter by exchange
strength	integer	No	Minimum signal strength (1-10)
limit	integer	No	Number of results (default: 20, max: 100)

Response Example

{
  "status": "success",
  "data": {
    "signals": [
      {
        "id": "sig_1234567890",
        "symbol": "BTC/USDT",
        "exchange": "Binance",
        "type": "buy",
        "strength": 8.5,
        "entry_price": 43250.00,
        "target_price": 45000.00,
        "stop_loss": 42000.00,
        "confidence": 0.85,
        "timestamp": "2024-01-15T10:30:00Z",
        "analysis": {
          "rsi": 28.5,
          "macd": "bullish_cross",
          "volume": "increasing",
          "support_level": 42800
        }
      }
    ],
    "meta": {
      "total": 15,
      "page": 1,
      "per_page": 20
    }
  }
}

POST /signals/subscribe

Subscribe to real-time signal notifications via WebSocket at Supabase Realtime (via Supabase client)

Market Data

GET /market/ticker

Get real-time market ticker data for all supported trading pairs.

GET /market/candles

Retrieve historical OHLCV candlestick data.

Portfolio

GET /portfolio/balance

Get your current portfolio balance across all connected exchanges.

POST /portfolio/trades

Execute trades based on signals or custom parameters.

SDKs & Libraries

We provide official SDKs for popular programming languages:

Python

pip install dipcatcher

Node.js

npm install dipcatcher

PHP

composer require dipcatcher/sdk

Getting Started

Endpoints

Resources