Developer Docs

pip install tonpo

import asyncio
from tonpo import TonpoClient, TonpoConfig

config = TonpoConfig(
    host="your-gateway-host.com",
    port=443,
    use_ssl=True,
)

async def main():
    # Step 1: Create a Tonpo user (do this once — store the credentials)
    async with TonpoClient.admin(config) as client:
        user = await client.create_user()
        print(f"API key: {user.api_key}")  # Save this!

    # Step 2: Provision an MT5 account (do this once per account)
    async with TonpoClient.for_user(config, user.api_key) as client:
        acct = await client.create_account(
            "12345678",      # MT5 login
            "your-password", # MT5 password (encrypted at rest)
            "ICMarkets-Demo" # Broker server name
        )
        await client.wait_for_active(acct.account_id)  # up to 180s
        print(f"Account ID: {acct.account_id}")  # Save this!

    # Step 3: Trade (use stored api_key + account_id every time)
    async with TonpoClient.for_user(config, user.api_key) as client:
        info = await client.get_account_info()
        print(f"Balance: {info.balance} {info.currency}")

        result = await client.place_market_buy(
            "EURUSD",
            volume=0.10,
            sl=1.0800,
            tp=1.0950,
        )
        print(f"Order ticket: {result.ticket}")

asyncio.run(main())

curl https://{HOST}/api/users/me \
  -H "X-API-Key: your_api_key_here"

{
  "user_id": "usr_01hx...",
  "api_key": "sk_live_..."
}

{
  "mt5Login":    "12345678",
  "mt5Password": "your-password",
  "mt5Server":   "ICMarkets-Demo",
  "region":      "eu"  // optional
}

{
  "account_id":  "acc_01hx...",
  "auth_token":  "..."  // one-time token
}

{
  "symbol":    "EURUSD",
  "side":      "buy",         // "buy" | "sell"
  "orderType": "market",      // "market" | "limit" | "stop"
  "volume":    0.10,
  "price":     1.0850,        // required for limit/stop
  "sl":        1.0800,        // optional
  "tp":        1.0950,        // optional
  "comment":   "my-bot",      // optional
  "magic":     12345          // optional magic number
}

{
  "ticket": 123456789,
  "sl":     1.0820,   // optional
  "tp":     1.0960    // optional
}

pip install tonpo

from tonpo import TonpoClient, TonpoConfig

config = TonpoConfig(
    host="your-gateway.com",
    port=443,
    use_ssl=True,
)

# Admin client — no auth, use only for create_user()
async with TonpoClient.admin(config) as client:
    user = await client.create_user()

# User client — authenticated, for all trading operations
async with TonpoClient.for_user(config, api_key=user.api_key) as client:
    info = await client.get_account_info()

async with TonpoClient.for_user(config, api_key) as client:

    # Market orders
    await client.place_market_buy("EURUSD", volume=0.10, sl=1.0800, tp=1.0950)
    await client.place_market_sell("GBPUSD", volume=0.05, sl=1.2900)

    # Limit orders
    await client.place_limit_buy("EURUSD", volume=0.10, price=1.0820, sl=1.0780)
    await client.place_limit_sell("XAUUSD", volume=0.01, price=2350.00)

    # Stop orders
    await client.place_stop_buy("USDJPY", volume=0.10, price=156.50)
    await client.place_stop_sell("EURUSD", volume=0.10, price=1.0780)

    # Manage positions
    positions = await client.get_positions()
    await client.close_position(ticket=123456789)
    await client.close_position(ticket=123456789, volume=0.05)  # partial
    await client.modify_position(ticket=123456789, sl=1.0820, tp=1.0960)

async with TonpoClient.for_user(config, api_key) as client:

    # Register callbacks before subscribing
    async def on_tick(tick):
        print(f"{tick.symbol}: bid={tick.bid} ask={tick.ask}")

    async def on_position(pos):
        print(f"Position update: #{pos.ticket} P&L={pos.profit}")

    client.ws.on_tick("EURUSD", on_tick)
    client.ws.on_position(on_position)

    # Start streaming
    await client.subscribe(["EURUSD", "GBPUSD", "XAUUSD"])

    # Keep running
    await asyncio.sleep(3600)

wss://{HOST}/ws

const ws = new WebSocket(`wss://{HOST}/ws?api_key=${apiKey}`);

ws.onopen = () => {
    // Subscribe to real-time ticks
    ws.send(JSON.stringify({
        type: "subscribe",
        symbols: ["EURUSD", "XAUUSD"],
        request_id: "req_001"
    }));
};

ws.onmessage = (event) => {
    const msg = JSON.parse(event.data);
    if (msg.type === "tick") {
        console.log(msg.symbol, msg.bid, msg.ask);
    }
};

{
  "type":   "tick",
  "symbol": "EURUSD",
  "bid":    1.08542,
  "ask":    1.08556,
  "last":   1.08549,
  "volume": 12,
  "time":   1700000000000
}

{
  "error":   "Invalid or missing API key",
  "code":    401,
  "type":    "authentication_error"
}