rpc_example.php

<?php

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

use Oyi77\MetaapiCloudPhpSdk\MetaApi\MetaApi;

/**
 * MetaApi RPC Connection Example
 *
 * Demonstrates how to:
 * - Connect to MetaApi via RPC (request/response pattern)
 * - Query account information, positions, orders
 * - Execute trades with various order types
 * - Calculate margin requirements
 */

$token = getenv('TOKEN') ?: '<put your token here>';
$accountId = getenv('ACCOUNT_ID') ?: '<put your account ID here>';

try {
    // Create MetaApi instance
    $metaApi = new MetaApi($token, [
        'region' => 'new-york',
        'domain' => 'agiliumtrade.agiliumtrade.ai',
    ]);

    // Get RPC connection for account
    $connection = $metaApi->rpcConnection($accountId);

    // Connect to websocket
    echo "Connecting to MetaApi RPC...\n";
    $connection->connect(10.0);

    // Wait for synchronization
    echo "Waiting for synchronization...\n";
    $connection->waitSynchronized(300);
    echo "Synchronized!\n\n";

    // Get account information
    echo "Account Information:\n";
    $accountInfo = $connection->getAccountInformation();
    print_r($accountInfo);
    echo "\n";

    // Get open positions
    echo "Open Positions:\n";
    $positions = $connection->getPositions();
    print_r($positions);
    echo "\n";

    // Get pending orders
    echo "Pending Orders:\n";
    $orders = $connection->getOrders();
    print_r($orders);
    echo "\n";

    // Get server time
    echo "Server Time:\n";
    $serverTime = $connection->getServerTime();
    print_r($serverTime);
    echo "\n";

    // Calculate margin for a trade
    echo "Calculating margin for 0.1 lot GBPUSD buy...\n";
    $marginInfo = $connection->calculateMargin([
        'symbol' => 'GBPUSD',
        'type' => 'ORDER_TYPE_BUY',
        'volume' => 0.1,
        'openPrice' => 1.25,
    ]);
    print_r($marginInfo);
    echo "\n";

    // Example: Place a limit buy order with trailing stop loss and expiration
    /*
    echo "Placing limit buy order...\n";
    $result = $connection->createLimitBuyOrder(
        'GBPUSD',
        0.01,
        1.2400,
        1.2300,
        1.2600,
        [
            'comment' => 'PHP SDK Example',
            'clientId' => 'example_' . time(),
            'trailingStopLoss' => [
                'distance' => [
                    'distance' => 50,
                    'units' => 'RELATIVE_POINTS',
                ],
            ],
            'expiration' => [
                'type' => 'ORDER_TIME_SPECIFIED',
                'time' => (new DateTime('+1 day'))->format('c'),
            ],
        ]
    );
    print_r($result);
    echo "\n";
    */

    // Close connection
    $connection->close();
    echo "Connection closed.\n";

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