Perfect API Documentation

Explore our comprehensive API documentation to integrate Perfect API services into your applications.

Authentication

All API requests must include your API key in the request body.

Base URL

https://botzverse.com/api/v1/perfect

Request Format

{
  "key": "your_api_key",
  "action": "action_name"
}

Balance Check

Check your account balance.

Request

{
  "key": "your_api_key",
  "action": "balance"
}

Response

{
  "status": "success",
  "balance": 100.00,
  "currency": "USD"
}

Services List

Get list of available services.

Request

{
  "key": "your_api_key",
  "action": "services"
}

Response

[
  {
    "service": 1,
    "name": "Service Name",
    "type": "Default",
    "category": "No drop | 100% stability",
    "min": 1,
    "max": 1000,
    "rate": 0.50
  }
]

Create Order

Create a new service order.

Request

{
  "key": "your_api_key",
  "action": "add",
  "service": 1,
  "quantity": 100,
  "link": "channel_name"
}

Response

{
  "status": "success",
  "order": 12345
}

Order Status

Check the status of one or multiple orders.

Single Order Request

{
  "key": "your_api_key",
  "action": "status",
  "order": 12345
}

Multiple Orders Request

{
  "key": "your_api_key",
  "action": "status",
  "orders": "12345,12346,12347"
}

Response

[{
  "order": 12345,
  "status": "processing",
  "charge": 50.00,
  "currency": "USD",
  "start_count": 0,
  "remains": 0
}]

Error Handling

All error responses follow this format:

Error Response Format

{
  "error": "Error description"
}

Common Error Messages

  • • Invalid API key or inactive user
  • • Invalid action
  • • Invalid service or service not active
  • • Insufficient balance
  • • Order not found

Best Practices

• Always validate your API key before making requests

• Check your balance before creating new orders

• Verify service availability before placing orders

• Implement proper error handling in your application

• Use appropriate rate limiting to avoid API abuse

• Keep your API key secure and never share it publicly