API Documentation

Integrate volume generation programmatically

Getting Started

The Solana Volume Bot API enables programmatic access to our volume generation platform. Perfect for integrating volume campaigns into your existing infrastructure.

Base URL

https://api.solanavolumebot.pro/v1

API Availability

API access is currently in beta. Contact our team at [email protected] to request API credentials and beta access.

Key Features

Launch and manage volume campaigns programmatically
Real-time campaign status and analytics via webhooks
RESTful API with JSON responses
Comprehensive error handling and validation
Secure API key authentication

Authentication

All API requests require authentication using an API key. Include your API key in the request headers for every API call.

Header Format

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Example Request

curl -X POST https://api.solanavolumebot.pro/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token_address": "YOUR_TOKEN_ADDRESS",
    "wallet_count": 100,
    "min_trade": 0.05,
    "max_trade": 0.15,
    "duration": 60
  }'

Security Best Practices

• Never commit API keys to version control
• Store keys in environment variables
• Rotate keys regularly
• Use separate keys for development and production
• Monitor API usage for unauthorized access

API Endpoints

Create Campaign

POST

/campaigns

Launch a new volume generation campaign for your token.

Request Body

{
  "token_address": "string",      // Required: Solana token contract address
  "dex_platform": "string",       // Optional: pump.fun, raydium, jupiter, orca
  "wallet_count": number,         // Required: 100-10000
  "min_trade": number,            // Required: Minimum trade size in SOL
  "max_trade": number,            // Required: Maximum trade size in SOL
  "duration": number,             // Required: Campaign duration in minutes (1-600)
  "comment_rate": number,         // Optional: 0-100, default 0
  "favorite_rate": number,        // Optional: 0-100, default 0
  "webhook_url": "string"         // Optional: Webhook for status updates
}

Response (201 Created)

{
  "campaign_id": "camp_abc123xyz",
  "status": "pending",
  "token_address": "YOUR_TOKEN_ADDRESS",
  "estimated_volume": 7.5,
  "service_fee": 0.3,
  "payment_address": "PAYMENT_WALLET_ADDRESS",
  "created_at": "2025-12-28T10:30:00Z"
}

Get Campaign Status

GET

/campaigns/:campaign_id

Retrieve the current status and analytics of a campaign.

Response (200 OK)

{
  "campaign_id": "camp_abc123xyz",
  "status": "running",
  "token_address": "YOUR_TOKEN_ADDRESS",
  "progress": {
    "total_trades": 245,
    "successful_trades": 241,
    "failed_trades": 4,
    "volume_generated": 6.42,
    "estimated_volume": 7.5,
    "completion_percent": 85
  },
  "started_at": "2025-12-28T10:35:00Z",
  "estimated_completion": "2025-12-28T11:35:00Z"
}

List Campaigns

GET

/campaigns?status=running&limit=10&offset=0

Retrieve a list of your campaigns with optional filtering.

Query Parameters

• status - Filter by status: pending, running, completed, failed
• limit - Number of results (max 100, default 10)
• offset - Pagination offset

Rate Limits

API requests are rate-limited to ensure fair usage and platform stability.

Standard Tier

Requests per minute:60

Concurrent campaigns:5

Daily volume limit:10,000 SOL

Enterprise Tier

Requests per minute:300

Concurrent campaigns:50

Daily volume limit:Unlimited

Rate Limit Exceeded (429)

When rate limits are exceeded, the API returns a 429 status code. Implement exponential backoff in your client to handle rate limiting gracefully.

Webhooks

Receive real-time notifications about campaign status changes and completion via webhooks.

Webhook Events

campaign.started

Campaign has begun execution

campaign.progress

Periodic updates during execution (every 25%)

campaign.completed

Campaign finished successfully

campaign.failed

Campaign encountered an error

Webhook Security

All webhook requests include an X-Signature header containing an HMAC-SHA256 signature. Verify this signature to ensure the request originates from our servers.

Code Examples

JavaScript / Node.js

const axios = require('axios');

const createCampaign = async () => {
  try {
    const response = await axios.post(
      'https://api.solanavolumebot.pro/v1/campaigns',
      {
        token_address: 'YOUR_TOKEN_ADDRESS',
        wallet_count: 150,
        min_trade: 0.05,
        max_trade: 0.15,
        duration: 60,
        comment_rate: 50,
        favorite_rate: 60
      },
      {
        headers: {
          'Authorization': 'Bearer YOUR_API_KEY',
          'Content-Type': 'application/json'
        }
      }
    );

    console.log('Campaign created:', response.data);
    return response.data.campaign_id;
  } catch (error) {
    console.error('Error:', error.response.data);
  }
};

createCampaign();

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.solanavolumebot.pro/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "token_address": "YOUR_TOKEN_ADDRESS",
    "wallet_count": 150,
    "min_trade": 0.05,
    "max_trade": 0.15,
    "duration": 60,
    "comment_rate": 50,
    "favorite_rate": 60
}

response = requests.post(
    f"{BASE_URL}/campaigns",
    json=payload,
    headers=headers
)

if response.status_code == 201:
    campaign = response.json()
    print(f"Campaign created: {campaign['campaign_id']}")
else:
    print(f"Error: {response.json()}")

Ready to Integrate?

Request API access to start building automated volume solutions for your projects.

Request API Access Contact Support