API Documentation

Welcome to the Switcher API. This API enables lightning-fast arbitrage trading on Solana by scanning multiple DEX pools in real-time for profitable opportunities.

Authentication

All API endpoints require authentication using an API key. You can generate API keys from your Account page.

Getting an API Key

1. Sign in to your account
2. Navigate to the Account page
3. Click "Generate New Key" to create an API key
4. Copy your API key and store it securely

Using Your API Key

Include your API key in requests using either method:

curl -X POST https://api.switcher.click/arbitrage/find \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{"tokenAddress": "...", "privateKey": "..."}'

{
  "apiKey": "your_api_key_here",
  "tokenAddress": "...",
  "privateKey": "..."
}

Rate Limits

Base URL

Supported Pools

Switcher currently supports arbitrage trading across the following DEX pools on Solana.

Raydium

Automated Market Maker (AMM) on Solana

More DEX integrations coming soon. Stay tuned for updates on additional pool support.

Health Check

Check if the API is running.

Response

{
  "status": "healthy",
  "timestamp": "2024-01-01T12:00:00.000Z",
  "version": "1.0.0"
}

Check Wallet Balance

Get SOL balance for a wallet.

Request Body

// Headers
X-API-Key: your_api_key_here

// Body
{
  "privateKey": "your_base58_private_key_here"
}

Response

{
  "success": true,
  "data": {
    "publicKey": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "balance": 1.2345,
    "balanceFormatted": "1.2345 SOL"
  }
}

Find Arbitrage Opportunities

Find arbitrage opportunities for a specific token.

Request Body

// Headers
X-API-Key: your_api_key_here

// Body
{
  "tokenAddress": "EDcdVtzW4HG7Xtg5yH3RbzMEyfudg63RmZgdXpQFUk3s",
  "privateKey": "your_base58_private_key_here"
}

Response

{
  "success": true,
  "data": {
    "tokenAddress": "EDcdVtzW4HG7Xtg5yH3RbzMEyfudg63RmZgdXpQFUk3s",
    "poolsAnalyzed": 45,
    "validPriceCalculations": 32,
    "opportunities": [
      {
        "buyPool": {
          "id": "pool_id_1",
          "pair": "USDC",
          "price": 0.00012345,
          "tvl": 125000
        },
        "sellPool": {
          "id": "pool_id_2",
          "pair": "SOL",
          "price": 0.00012567,
          "tvl": 89000
        },
        "profitPercent": 1.29,
        "totalProfit": 0.0129
      }
    ]
  }
}

Execute Arbitrage Trade

Execute an arbitrage trade for a specific opportunity.

Request Body

// Headers
X-API-Key: your_api_key_here

// Body
{
  "tokenAddress": "EDcdVtzW4HG7Xtg5yH3RbzMEyfudg63RmZgdXpQFUk3s",
  "privateKey": "your_base58_private_key_here",
  "opportunityIndex": 0
}

Response

{
  "success": true,
  "data": {
    "execution": {
      "buyTxId": "transaction_hash_1",
      "sellTxId": "transaction_hash_2",
      "profit": 0.0129,
      "profitUSD": 3.10
    }
  }
}

Send SOL

Send SOL from one wallet to another.

Request Body

// Headers
X-API-Key: your_api_key_here

// Body
{
  "privateKey": "your_base58_private_key_here",
  "toAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "amount": 0.1
}

Response

{
  "success": true,
  "data": {
    "signature": "transaction_signature_here",
    "from": "sender_public_key",
    "to": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "amount": 0.1
  }
}

Error Handling

All endpoints return errors in a consistent format.

{
  "success": false,
  "error": "Error message description"
}

HTTP Status Codes

• 200 - Success
• 400 - Bad Request (invalid parameters)
• 404 - Endpoint not found
• 500 - Internal Server Error

Security Notes