API Reference

X-API-Key: gm_live_sk_4b8f2a91c3e7d5f0a6b2c4e8f1d3a5b7
Content-Type: application/json

const ws = new WebSocket('wss://api.guromarkets.com/v2/stream');

// Authenticate on connect
ws.onopen = () => {
  ws.send(JSON.stringify({
    type: 'auth',
    apiKey: 'gm_live_sk_YOUR_KEY'
  }));
};

// Subscribe to instruments
ws.send(JSON.stringify({
  type: 'subscribe',
  channels: ['quotes', 'positions'],
  instruments: ['XAUUSD', 'EURUSD', 'BTCUSD']
}));

// Handle incoming messages
ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);

  switch (msg.type) {
    case 'quote':
      console.log(`${msg.instrument}: Bid=${msg.bid} Ask=${msg.ask}`);
      break;
    case 'order.filled':
      console.log(`Order filled: ${msg.orderId} @ ${msg.price}`);
      break;
    case 'position.update':
      console.log(`P&L Update: $${msg.unrealisedPnl}`);
      break;
  }
};

// Heartbeat (every 30s)
setInterval(() => ws.send(JSON.stringify({ type: 'ping' })), 30000);

{
  "error": {
    "code": "INSUFFICIENT_MARGIN",
    "message": "Insufficient margin to open position. Required: $240.50, Available: $180.20",
    "details": {
      "required": 240.50,
      "available": 180.20,
      "instrument": "XAUUSD"
    },
    "requestId": "req_9f84b2c1d3e7",
    "timestamp": "2026-05-13T10:29:00Z"
  }
}

{
  "event": "order.filled",
  "timestamp": "2026-05-13T10:29:00Z",
  "webhookId": "wh_9f84b2c1",
  "data": {
    "orderId": "ord_4821GM",
    "instrument": "XAUUSD",
    "side": "buy",
    "volume": 0.1,
    "executionPrice": 2387.45,
    "stopLoss": 2368.00,
    "takeProfit": 2410.00,
    "commission": 0.00,
    "marginUsed": 238.75
  }
}

// Verify webhook signature (Node.js)
import crypto from 'crypto';

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature), Buffer.from(expected)
  );
}