Overview

The WHALE TG API is a comprehensive solution for programmatically purchasing Telegram accounts. It supports three account statuses with automatic 2FA disabling and a smart retry system that ensures successful purchases.

Base URL:  https://whaletg.com
API Version: 2.4.1
Content-Type: application/json
Required Header: X-API-Key: YOUR_API_KEY

Account Types

Choose from three different account statuses, each with different pricing:

Active Accounts

Normal, fully functional Telegram accounts

Full Price

Restricted Accounts

Accounts with limited functionality

30% Discount

Spam Accounts

Accounts marked as spam by Telegram

50% Discount

Authentication

All API requests require authentication using an API key in the request header:

X-API-Key: your_api_key_here

To obtain your API key:

  1. Register on the WHALE TG bot
  2. Complete the verification process
  3. Generate API key from your profile settings
  4. Use it in all your API requests

API Endpoints

GET /balance

Get user balance and account information

Headers:

X-API-Key: your_api_key_here

Response:

{
    "balance": 150.50,
    "currency": "USD"
}
POST /purchase-by-status

Purchase account by specific status

Request Body:

{
    "country_code": "SA",
    "status": "spam"  // active, spam, or restricted
}

Response Success:

{
    "success": true,
    "phone": "+966501234567",
    "operation_id": "abc123def456",
    "price": 3.5,
    "status": "spam",
    "message": "Account reserved"
}
POST /get-code

Get activation code for purchased account

Request Body:

{
    "operation_id": "abc123def456"
}

Response:

{
    "success": true,
    "phone": "+966501234567",
    "activation_code": "12345",
    "status": "spam",
    "message": "Code retrieved"
}

Quick Start

Get started with WHALE TG API in just 5 minutes. Follow these simple steps:

Step-by-Step Guide:

  1. Obtain your API key from the WHALE TG bot
  2. Check your balance: GET /balance
  3. Browse available countries: GET /countries
  4. Purchase an account: POST /purchase-by-status
  5. Get activation code: POST /get-code
View Code Examples

Code Examples

Python Example:

import requests

BASE_URL = "  https://whaletg.com"
API_KEY = "your_api_key_here"
headers = {"X-API-Key": API_KEY}

# Check balance
response = requests.get(f"{BASE_URL}/balance", headers=headers)
balance = response.json()["balance"]
print(f"Balance: ${balance}")

# Purchase spam account
data = {"country_code": "SA", "status": "spam"}
response = requests.post(f"{BASE_URL}/purchase-by-status", 
                         json=data, headers=headers)
result = response.json()

if result["success"]:
    operation_id = result["operation_id"]
    print(f"Account reserved: {result['phone']}")
    
    # Get activation code
    code_data = {"operation_id": operation_id}
    response = requests.post(f"{BASE_URL}/get-code", 
                             json=code_data, headers=headers)
    code_result = response.json()
    
    if code_result["success"]:
        print(f"Activation code: {code_result['activation_code']}")

cURL Examples:

Get Balance:

curl -X GET "  https://whaletg.com/balance" \
  -H "X-API-Key: YOUR_API_KEY"

Error Codes

Code Description Solution
200 OK Success Operation completed successfully
401 Invalid API Key Check your API key or get a new one
403 User not verified Complete verification in the bot