README

Official PHP SDK for the MobileProxy.Space API — private mobile proxies on real GSM devices across 52 countries.

Features

• Full API coverage — all endpoints wrapped in typed, documented methods
• PSR-4 autoloading — install via Composer
• Typed exceptions — ApiException, AuthenticationException, RateLimitException
• IP rotation — dedicated changeIp() method with no rate limit
• PHP 7.4+ compatible

Installation

composer require mobirox/mobileproxy-sdk

Quick Start

use MobileProxy\Client;
use MobileProxy\Exception\ApiException;

$client = new Client('YOUR_API_TOKEN');

// Check balance
$balance = $client->getBalance();
echo "Balance: {$balance['balance']}";

// List active proxies
$proxies = $client->getMyProxy();

// Get current IP of a proxy
$ip = $client->getProxyIp(12345);

// Rotate IP (no rate limit)
$client->changeIp('your_proxy_key');

API Methods

Proxy Information

Proxy Management

Equipment & GEO

Blacklist

Purchasing & Billing

Utilities

Error Handling

use MobileProxy\Exception\ApiException;
use MobileProxy\Exception\AuthenticationException;
use MobileProxy\Exception\RateLimitException;

try {
    $client->getBalance();
} catch (AuthenticationException $e) {
    // Invalid API token
} catch (RateLimitException $e) {
    // Too many requests — back off and retry
    // Limit: 3 × (number of active proxies) requests/sec
} catch (ApiException $e) {
    echo $e->getMessage();
    echo $e->getHttpCode();
    print_r($e->getResponseBody());
}

Configuration

$client = new Client('YOUR_API_TOKEN', [
    'timeout' => 120,    // request timeout in seconds
    'debug'   => true,   // enable cURL verbose output
]);

Rate Limits

API requests are limited to 3 × (number of active proxies) per second. For example, 10 proxies = 30 req/s. The changeIp() method uses a separate endpoint with no rate limit.

Requirements

• PHP 7.4 or higher
• cURL extension
• JSON extension

Links

• API Documentation
• Dashboard
• Website
• Chrome Extension

License

MIT — see LICENSE.