Documentation

Getting Started

Trigger.Trade is a professional PHP-based trading connector that allows you to trade on multiple cryptocurrency exchanges through a unified API.

What You Get

• Complete source code (PHP 8.0+)
• Support for 10 active exchanges: Bybit, BloFin, Toobit, Evedex, Pionex, Bitget, BingX, Binance, Kraken, OKX
• Coming Soon: Gate.io, MEXC (Spot), KuCoin, Coinbase Advanced, Deribit, HTX, Crypto.com, dYdX, BitMEX, Bitfinex, WhiteBIT, BitMart, Phemex, Hyperliquid, Apex Pro
• Coming Soon: MT4, MT5, and cTrader platform integrations
• 200+ features including multi-TP, pyramiding prevention, encryption
• Comprehensive documentation
• Admin dashboard
• JSON Generator - Generate trading configurations (login required)
• API Encryptor - Encrypt API credentials (login required)
• Monthly updates with new exchanges and features

Quick Start Workflow

1. Subscribe: Purchase a subscription plan
2. Login: Login with Whop
3. Get API Keys: Follow the API Keys guide below
4. Generate Config: Use the JSON Generator to create your trading setup
5. Setup TradingView: Follow the TradingView setup guide
6. Start Trading: Activate your TradingView alerts

Requirements

• Active subscription (for generator and encryptor access)
• API keys from your exchange
• TradingView account (for webhook alerts)
• Server hosting Trigger.Trade connector (provided by you or your hosting provider)

Getting API Keys from Exchanges

To use Trigger.Trade, you need API keys from your exchange. Follow these guides to obtain them.

TradingView Webhook Setup

Connect your TradingView alerts to Trigger.Trade using webhooks. Follow these steps to set up automated trading.

Prerequisites

• TradingView account (Free or Premium)
• Trigger.Trade subscription (for generator access)
• API keys from your exchange
• Your Trigger.Trade webhook URL

Step 1: Generate Your Webhook Configuration

1. Login to Trigger.Trade:
   • Go to login page
   • Login with Whop (if subscribed)
   • You'll be redirected to the dashboard after login
2. Open JSON Generator:
   • Navigate to the Generator page
   • If not logged in, you'll be redirected to login
3. Configure Settings:
   • Select your exchange (Bybit, BloFin, etc.)
   • Enter your API credentials
   • Set trading parameters (leverage, margin mode, etc.)
   • Configure quantity and order types
4. Set Base URL:
   • Enter your domain (e.g., https://yourdomain.com)
   • This is where your Trigger.Trade is hosted
5. Generate Configuration:
   • Click "Generate JSON & Webhook"
   • You'll see webhook URL and JSON payload

Step 2: Create TradingView Alert

1. Open TradingView Chart:
   • Go to TradingView.com
   • Open a chart for your trading pair (e.g., BTCUSDT)
   • Add your trading strategy/indicator
2. Create Alert:
   • Click the "Alert" button (bell icon) on the chart
   • Or right-click on the chart → "Add Alert"
3. Configure Alert Conditions:
   • Condition: Select your strategy condition (e.g., "Strategy Alert")
   • Expiration: Set alert expiration (or leave unlimited)
   • Frequency: Choose "Once Per Bar Close" (recommended)
4. Set Notification Method:
   • Scroll down to "Notifications" section
   • Click "Webhook URL" checkbox
   • You'll see a URL field appear

Step 3: Configure Webhook in TradingView

1. Copy Webhook URL:
   • In Trigger.Trade Generator, select the tab for your action:
     • Enter Long: For opening long positions
     • Exit Long: For closing long positions
     • Enter Short: For opening short positions
     • Exit Short: For closing short positions
   • Click "Copy URL" button next to the webhook URL
   • The URL will look like: https://yourdomain.com/blofin/public/trade.php
2. Paste in TradingView:
   • Paste the webhook URL into TradingView's "Webhook URL" field
3. Copy JSON Payload:
   • In Trigger.Trade Generator, copy the JSON payload
   • Click "Copy JSON" button
4. Paste JSON in Message Field:
   • In TradingView alert, find the "Message" field
   • Paste the JSON payload here
   • This JSON will be sent as POST body to your webhook

Step 4: Test Your Setup

1. Use Testnet First:
   • Set use_testnet: "1" in your JSON
   • Use testnet API keys
   • Test with small amounts
2. Create Test Alert:
   • Set alert condition to trigger immediately
   • Save and activate the alert
   • Wait for alert to trigger
3. Verify Execution:
   • Check your exchange account for the order
   • Check Trigger.Trade admin panel for trade logs
   • Verify Telegram notifications (if enabled)

Step 5: Create Multiple Alerts

For a complete trading system, create separate alerts for each action:

• Long Entry Alert: Uses "Enter Long" webhook and JSON
• Long Exit Alert: Uses "Exit Long" webhook and JSON
• Short Entry Alert: Uses "Enter Short" webhook and JSON
• Short Exit Alert: Uses "Exit Short" webhook and JSON

Note: All alerts use the same webhook URL, but different JSON payloads based on the position type.

TradingView Alert Message Format

The JSON payload you paste in TradingView's "Message" field will be sent as the POST body. TradingView supports variables in the message:

{
  "mode": "trade",
  "api_key": "YOUR_API_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "coin_pair": "{{ticker}}",
  "position": "0",
  "qty": "100",
  "entry_order_type": "1",
  "leverage": "10"
}

TradingView Variables:

• {{ticker}} - Symbol name (e.g., BTCUSDT)
• {{close}} - Close price
• {{time}} - Alert time
• {{volume}} - Volume

You can use these variables in your JSON for dynamic values.

Troubleshooting TradingView Webhooks

Telegram Notifications Setup

Get real-time notifications about your trades directly in Telegram. This feature allows you to monitor your trading activity, receive error alerts, and track successful trades.

Step 1: Add the Trigger.Trade Bot

1. Open Telegram: Open the Telegram app on your phone or desktop
2. Add the Bot: Click this link to add the bot: @DaviddTechAPIbot
3. Start the Bot: Click "Start" or send /start to the bot
4. Verify Connection: The bot will confirm it's ready to send you notifications

Step 2: Get Your Telegram Chat ID

You need your Telegram Chat ID to receive notifications. There are two methods:

Method 1: Using @userinfobot (Easiest)

1. Open Telegram: Search for @userinfobot
2. Start the Bot: Click "Start" or send /start
3. Get Your ID: The bot will immediately send you a message with your information
4. Copy Your ID: Look for a number labeled "Id:" - this is your Chat ID (e.g., 123456789)
5. Save It: Copy this number - you'll use it as your channelName in Trigger.Trade

Method 2: Using @getidsbot

1. Search: Find @getidsbot in Telegram
2. Start: Click "Start" or send /start
3. Get ID: The bot will reply with your Chat ID
4. Copy: Save the numeric ID shown

Method 3: For Telegram Channels/Groups

If you want to send notifications to a Telegram channel or group:

1. Create Channel/Group: Create a new Telegram channel or group
2. Add Bot as Admin: Add @DaviddTechAPIbot as an administrator to your channel/group
3. Get Channel ID: Forward a message from the channel to @userinfobot
4. Use Channel ID: The ID will be negative (e.g., -1001234567890)

Step 3: Configure Telegram in JSON Generator

1. Login: Login to Trigger.Trade (subscription required)
2. Open Generator: Navigate to the JSON Generator
3. Scroll to Advanced Options: Find the "Advanced Options" section
4. Set Telegram Bot Mode: Choose your notification preference:
   • All: Receive all notifications (successful trades, errors, info)
   • Errors Only: Only receive error notifications
   • Notifications: Manual trader mode (notifications only)
5. Enter Chat ID: In the "Telegram Channel ID" field, enter your Chat ID from Step 2
6. Generate JSON: Click "Generate JSON & Webhook"
7. Copy JSON: Your generated JSON will include the Telegram settings

Step 4: Add Telegram Settings to Your JSON

Your generated JSON will include these Telegram fields:

{
  "mode": "trade",
  "api_key": "YOUR_API_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "coin_pair": "BTCUSDT",
  "position": "0",
  "qty": "100",
  "telegram_bot": "0",
  "channelName": "123456789"
}

Telegram Bot Modes Explained:

• "0" - All: Receive all trade notifications including successful trades, errors, and balance updates
• "1" - Errors Only: Only receive notifications when errors occur
• "2" - Notifications: Manual trader mode - notifications only, no trades executed

Step 5: Test Your Telegram Notifications

Make sure you've added and started the @DaviddTechAPIbot before testing.

1. Send Test Alert: Trigger a test trade from TradingView
2. Check Telegram: You should receive a notification in Telegram
3. Verify Format: The notification should include:
   • Trade status (success/error)
   • Symbol and position
   • Order details
   • Balance information
   • Execution time

Telegram Notification Format

Your Telegram notifications will look like this:

✅ Trade Executed Successfully

📊 Symbol: BTCUSDT
📈 Position: Long
💰 Quantity: 0.001 BTC
💵 Price: $45,000.00
⚡ Leverage: 10x
📊 Margin Mode: Isolated

💼 Balance Info:
   Wallet Balance: $1,000.00
   Available Margin: $950.00

⏱ Execution Time: 0.234s
🆔 Log ID: abc123xyz

Troubleshooting Telegram Notifications

API Encryptor Guide

The API Encryptor adds an extra layer of security to your API credentials by encrypting them before use. This helps protect your credentials even if they're intercepted.

What is the Encryptor?

The encryptor uses industry-standard encryption to protect your API credentials:

• Algorithm: AES-256-CBC encryption
• Key Derivation: PBKDF2 with SHA-256
• Iterations: 100,000 iterations (high security) or 1,000 (standard)
• Purpose: Adds an extra layer of security to your API keys

Step 1: Access the Encryptor

1. Login: Login to Trigger.Trade with your subscription
2. Navigate: Go to the API Encryptor page
3. Verify Access: You should see the encryptor form (if not, you'll be redirected to login)

Step 2: Enter Your API Credentials

1. API Key: Enter your exchange API key
2. Secret Key: Enter your exchange secret key
3. Passphrase: Enter your passphrase (required for BloFin, optional for others)
   • If left empty, a default passphrase will be used
   • For BloFin, you must enter your actual passphrase

Step 3: Choose Security Level

Select your preferred security level:

• Standard (1K iterations): Faster encryption, good security
  • Recommended for: Frequent use, lower security requirements
  • Encryption time: ~0.1 seconds
• High (100K iterations): Slower encryption, maximum security
  • Recommended for: High-value accounts, maximum security
  • Encryption time: ~1-2 seconds

Step 4: Encrypt Your Credentials

1. Click "Encrypt API Credentials": The encryption happens in your browser
2. Wait for Encryption: This may take 1-2 seconds for high security
3. View Results: Your encrypted credentials will appear in the output panel

Step 5: Copy Encrypted Credentials

1. Encrypted API Key: Click the copy button next to the encrypted API key
2. Encrypted Secret Key: Click the copy button next to the encrypted secret key
3. Save Securely: Store these encrypted values securely

Step 6: Use Encrypted Credentials in Generator

1. Open Generator: Go to the JSON Generator
2. Enable Encryption: In Advanced Options, set "Encryption" to "ON"
3. Paste Encrypted Values:
   • Paste your encrypted API key in the API Key field
   • Paste your encrypted secret key in the Secret Key field
   • If you used a custom passphrase, you'll need to provide it (or use default)
4. Generate JSON: Click "Generate JSON & Webhook"
5. Use in TradingView: The generated JSON will work with encrypted credentials

How Encryption Works

The encryption process:

1. Key Derivation: Your passphrase (or default) is used with PBKDF2 to derive an encryption key
2. Encryption: Your API credentials are encrypted using AES-256-CBC
3. Encoding: The encrypted data is base64 encoded for easy transmission
4. Decryption: When used, Trigger.Trade decrypts the credentials server-side

Encryption Example

Your plain text credentials:

API Key: abc123xyz789
Secret Key: secret123456

After encryption (example):

Encrypted API Key: U2FsdGVkX1+vupppZksvRf5pq5g5XkFy...
Encrypted Secret Key: U2FsdGVkX1+3xJKLmNOPQRSTUVWX...

Best Practices

• Use High Security: For production trading, use the "High" security level
• Store Securely: Keep your encrypted credentials in a secure password manager
• Don't Share: Even encrypted credentials should not be shared publicly
• Regular Updates: Re-encrypt credentials if you suspect they've been compromised
• Backup: Keep a secure backup of your encrypted credentials

Troubleshooting

API Reference

Endpoint

POST /blofin/public/trade.php

Basic Trade Request

{
  "mode": "trade",
  "api_key": "YOUR_API_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "coin_pair": "BTCUSDT",
  "position": "0",
  "qty": "0.001",
  "entry_order_type": "0",
  "leverage": "10",
  "margin_mode": "isolated"
}

Position Values

• 0 - Open Long
• 1 - Open Short
• 3 - Close Long
• 4 - Close Short
• 5 - Reduce Long
• 6 - Reduce Short

Order Types

• 0 - Market Order
• 1 - Limit Order

Response Format

{
  "success": true,
  "status": "success",
  "order_id": "123456789",
  "message": "Order placed successfully",
  "data": {
    "symbol": "BTCUSDT",
    "side": "buy",
    "quantity": "0.001",
    "price": "50000",
    "execution_time_ms": 85.5
  }
}

Key Features

Multi-Take Profit

Set up to 3 take-profit levels with custom sizes:

{
  "mode": "trade",
  "coin_pair": "BTCUSDT",
  "position": "0",
  "qty": "0.001",
  "tp_1_price": "52000",
  "tp_1_size": "50",
  "tp_2_price": "53000",
  "tp_2_size": "30",
  "tp_3_price": "54000",
  "tp_3_size": "20"
}

Pyramiding Prevention

Prevent conflicting positions:

{
  "mode": "trade",
  "coin_pair": "BTCUSDT",
  "position": "0",
  "pyramiding": "0"
}

pyramiding: "0" - Enabled (blocks conflicts)
pyramiding: "1" - Disabled (allows duplicates)

API Encryption

Encrypt your API credentials:

{
  "mode": "encrypt_credentials",
  "api_key": "YOUR_API_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "passphrase": "YOUR_PASSPHRASE",
  "security_level": 1
}

Telegram Notifications

Enable Telegram notifications:

{
  "mode": "trade",
  "telegram_bot": "1",
  "channelName": "@your_channel"
}

Supported Exchanges

Code Examples

PHP Example

<?php
require_once 'vendor/autoload.php';
require_once 'blofin/src/BlofinClient.php';

$client = new BlofinConnector\BlofinClient(
    'YOUR_API_KEY',
    'YOUR_SECRET_KEY',
    '0', // testnet: 0=mainnet, 1=testnet
    '' // passphrase (if required)
);

$result = $client->execute([
    'mode' => 'trade',
    'coin_pair' => 'BTCUSDT',
    'position' => '0',
    'qty' => '0.001',
    'leverage' => '10',
    'take_profit_price' => '52000',
    'stop_loss_price' => '48000'
]);

print_r($result);
?>

cURL Example

curl -X POST https://your-domain.com/blofin/public/trade.php \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "trade",
    "api_key": "YOUR_API_KEY",
    "secret_key": "YOUR_SECRET_KEY",
    "coin_pair": "BTCUSDT",
    "position": "0",
    "qty": "0.001"
  }'

JavaScript Example

fetch('https://your-domain.com/blofin/public/trade.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    mode: 'trade',
    api_key: 'YOUR_API_KEY',
    secret_key: 'YOUR_SECRET_KEY',
    coin_pair: 'BTCUSDT',
    position: '0',
    qty: '0.001'
  })
})
.then(response => response.json())
.then(data => console.log(data));

TradingView Webhook Example

In TradingView alert, set:

• Webhook URL: https://yourdomain.com/blofin/public/trade.php
• Message: (JSON payload from generator)

{
  "mode": "trade",
  "api_key": "YOUR_API_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "coin_pair": "{{ticker}}",
  "position": "0",
  "qty": "100",
  "entry_order_type": "1",
  "leverage": "10"
}

Error Codes Reference

When trading with Trigger.Trade, you may encounter error codes from the exchanges. We've compiled a comprehensive reference guide to help you understand and resolve these errors.

Common Error Categories

Quick Troubleshooting Tips

1. Check API Credentials: Verify your API key, secret key, and passphrase (for BloFin) are correct
2. Verify Permissions: Ensure your API key has trading permissions enabled
3. Check IP Whitelist: If using IP restrictions, ensure your server IP is whitelisted
4. Verify Balance: Ensure you have sufficient balance for the order
5. Check Order Size: Verify order size meets minimum requirements (usually $5 USDT minimum)
6. Verify Trading Pair: Ensure the symbol format is correct (e.g., BTCUSDT for Bybit, BTC-USDT for BloFin)
7. Check Position Mode: Ensure position mode matches your account settings

Troubleshooting

Common Issues

Database Connection Error

Solution: Check file permissions and ensure SQLite extension is enabled.

chmod 777 database/
php -m | grep sqlite

API Authentication Failed

Solution: Verify your API key, secret key, and permissions on the exchange.

• Double-check API key and secret key are correct
• Verify API keys have trading permissions enabled
• Check if IP restrictions are blocking your server
• For BloFin, ensure passphrase is correct

Order Execution Failed

Solution: Check error message in response. Common issues:

• Insufficient balance
• Invalid symbol
• Order size too small
• Market closed
• Leverage too high
• Position mode mismatch

Telegram Notifications Not Working

Solution:

• Make sure you've added and started @DaviddTechAPIbot
• Verify your Chat ID is correct (get it from @userinfobot)
• Check that channelName field contains your Chat ID
• Ensure telegram_bot is set to "0", "1", or "2"

Webhook Not Receiving Requests

Solution:

• Verify webhook URL is accessible (test in browser)
• Check server logs for incoming requests
• Ensure HTTPS is enabled (TradingView requires HTTPS)
• Verify TradingView alert is actually triggering
• Check firewall settings

JSON Generator Not Accessible

Solution: The generator requires login. Make sure you:

• Have an active subscription
• Are logged in with Whop
• Have an active Whop subscription