laravel-bitunix-api/examples/GetSingleAccountExample.php

<?php

/**
 * Example usage of Get Single Account functionality
 *
 * This example demonstrates how to use the LaravelBitunixApi package
 * to get account details from Bitunix exchange.
 */

require_once __DIR__.'/../vendor/autoload.php';

use Msr\LaravelBitunixApi\Requests\GetSingleAccountRequestContract;

// Example configuration (in real usage, these would be in your .env file)
config([
    'bitunix-api.future_base_uri' => 'https://fapi.bitunix.com/',
    'bitunix-api.api_key' => 'your-api-key-here',
    'bitunix-api.api_secret' => 'your-api-secret-here',
    'bitunix-api.language' => 'en-US',
]);

try {
    // Get the API instance
    $api = app(GetSingleAccountRequestContract::class);

    echo "💰 Get Single Account Examples\n\n";

    // Example 1: Get USDT account details
    echo "1. Getting USDT account details...\n";
    $response = $api->getSingleAccount('USDT');

    if ($response->getStatusCode() === 200) {
        $data = json_decode($response->getBody()->getContents(), true);
        if ($data['code'] === 0) {
            echo "✅ USDT account details retrieved successfully!\n";
            
            $account = $data['data'][0];
            echo "Account Details:\n";
            echo "  Margin Coin: " . $account['marginCoin'] . "\n";
            echo "  Available: " . $account['available'] . "\n";
            echo "  Frozen: " . $account['frozen'] . "\n";
            echo "  Margin: " . $account['margin'] . "\n";
            echo "  Transfer: " . $account['transfer'] . "\n";
            echo "  Position Mode: " . $account['positionMode'] . "\n";
            echo "  Cross Unrealized PnL: " . $account['crossUnrealizedPNL'] . "\n";
            echo "  Isolation Unrealized PnL: " . $account['isolationUnrealizedPNL'] . "\n";
            echo "  Bonus: " . $account['bonus'] . "\n";
        } else {
            echo "❌ API Error: " . $data['msg'] . "\n";
        }
    } else {
        echo "❌ HTTP Error: " . $response->getStatusCode() . "\n";
    }

    echo "\n";

    // Example 2: Get BTC account details
    echo "2. Getting BTC account details...\n";
    $response = $api->getSingleAccount('BTC');

    if ($response->getStatusCode() === 200) {
        $data = json_decode($response->getBody()->getContents(), true);
        if ($data['code'] === 0) {
            echo "✅ BTC account details retrieved successfully!\n";
            
            $account = $data['data'][0];
            echo "Account Details:\n";
            echo "  Margin Coin: " . $account['marginCoin'] . "\n";
            echo "  Available: " . $account['available'] . "\n";
            echo "  Frozen: " . $account['frozen'] . "\n";
            echo "  Margin: " . $account['margin'] . "\n";
            echo "  Transfer: " . $account['transfer'] . "\n";
            echo "  Position Mode: " . $account['positionMode'] . "\n";
            echo "  Cross Unrealized PnL: " . $account['crossUnrealizedPNL'] . "\n";
            echo "  Isolation Unrealized PnL: " . $account['isolationUnrealizedPNL'] . "\n";
            echo "  Bonus: " . $account['bonus'] . "\n";
        } else {
            echo "❌ API Error: " . $data['msg'] . "\n";
        }
    } else {
        echo "❌ HTTP Error: " . $response->getStatusCode() . "\n";
    }

    echo "\n";

    // Example 3: Get multiple account details
    echo "3. Getting multiple account details...\n";
    $marginCoins = ['USDT', 'BTC', 'ETH'];

    foreach ($marginCoins as $marginCoin) {
        echo "Getting {$marginCoin} account details...\n";
        
        $response = $api->getSingleAccount($marginCoin);
        
        if ($response->getStatusCode() === 200) {
            $data = json_decode($response->getBody()->getContents(), true);
            if ($data['code'] === 0) {
                $account = $data['data'][0];
                echo "✅ {$marginCoin} account: Available={$account['available']}, Frozen={$account['frozen']}, Margin={$account['margin']}\n";
            } else {
                echo "❌ Failed to get {$marginCoin} account: " . $data['msg'] . "\n";
            }
        } else {
            echo "❌ HTTP Error for {$marginCoin}: " . $response->getStatusCode() . "\n";
        }
    }

    echo "\n";

    // Example 4: Error handling
    echo "4. Error handling example...\n";
    $invalidMarginCoin = 'INVALID';
    
    $response = $api->getSingleAccount($invalidMarginCoin);
    
    if ($response->getStatusCode() === 200) {
        $data = json_decode($response->getBody()->getContents(), true);
        if ($data['code'] === 0) {
            echo "✅ Account details retrieved successfully!\n";
        } else {
            echo "❌ API Error: " . $data['msg'] . "\n";
            echo "This is expected for invalid margin coin\n";
        }
    } else {
        echo "❌ HTTP Error: " . $response->getStatusCode() . "\n";
    }

} catch (Exception $e) {
    echo '❌ Exception: '.$e->getMessage()."\n";
}

/**
 * Get Single Account Features:
 * 
 * - Get account details for specific margin coin
 * - Rate limit: 10 req/sec/uid
 * - Returns comprehensive account information
 * - Supports multiple margin coins
 * 
 * Response includes:
 * - marginCoin: Margin Coin
 * - available: Available quantity in the account
 * - frozen: Locked quantity of orders
 * - margin: Locked quantity of positions
 * - transfer: Maximum transferable amount
 * - positionMode: Position mode (ONE_WAY or HEDGE)
 * - crossUnrealizedPNL: Unrealized PnL for cross positions
 * - isolationUnrealizedPNL: Unrealized PnL for isolation positions
 * - bonus: Futures Bonus
 * 
 * Environment Variables Required:
 *
 * BITUNIX_API_KEY=your-api-key
 * BITUNIX_API_SECRET=your-api-secret
 * BITUNIX_LANGUAGE=en-US
 */