cTrader Trading API

Submit a market or pending order. Market (Buy/Sell) needs symbol + volume; price is ignored. Pending (*Limit/*Stop) additionally needs price, on the right side of the market (a buy stop above the ask, a buy limit below it), or the order is refused with 10015 before it is sent. Volume must be a multiple of the symbol's volumeStep (10014 otherwise). Optional: stopLoss, takeProfit, an expiry for pending orders (expiration or expirationUtc, both UTC, not both; absent → good-till-cancelled), comment, expertId (a.k.a. magic), and clientOrderId. slippage is accepted and ignored. With a clientOrderId a retry is safe: the first request with an id trades, and any repeat with the same id, whether it overlaps the first or comes up to 10 minutes later, trades nothing and gets the first request's reply with the header Idempotent-Replayed: true. Reusing an id for a different order is refused with 409 MRPC_CLIENT_ORDER_ID_REUSED.

• symbol* (required): Symbol to trade, e.g. EURUSD.
• operation* (required): Buy, Sell, BuyLimit, SellLimit, BuyStop, SellStop (case- and separator-insensitive). BuyStopLimit and SellStopLimit are refused, see below.
• volume* (required): Volume in lots.
• price: Required for pending orders; ignored for market orders.
• stopLoss / takeProfit: Optional SL/TP prices.
• expiration: Pending-order expiry (date string, UTC); absent → good-till-cancelled.
• expirationUtc: The same as ISO-8601 such as 2026-11-03T17:00:00Z; use instead of expiration.
• comment / expertId: Order comment and magic number.
• clientOrderId: Your own id for this order, 1–64 characters, remembered for 10 minutes. Echoed in the reply.

{
  "symbol": "EURUSD",
  "operation": "Buy",
  "volume": 0.01,
  "stopLoss": 1.11000,
  "takeProfit": 1.12500,
  "comment": "my-strategy",
  "expertId": 26111001,
  "clientOrderId": "copy-7f3a-0001"
}

curl -X POST https://api.fxsocket.com/ctrader/{account_id}/OrderSend \
  -H "X-API-Key: fxs_live_..." \
  -H "Content-Type: application/json" \
  -d '{"symbol":"EURUSD","operation":"Buy","volume":0.01,"stopLoss":1.11,"takeProfit":1.125,"comment":"my-strategy","expertId":26111001,"clientOrderId":"copy-7f3a-0001"}'

{
  "success": true,
  "outcome": "applied",
  "retcode": 10009,
  "retcodeDescription": "Done",
  "deal": 343051307,
  "order": 328018035,
  "volume": 0.01,
  "price": 1.11685,
  "bid": 1.11662,
  "ask": 1.11685,
  "comment": "",
  "position": 302262716,
  "time": "2026-11-10T22:38:46.909Z",
  "timeUtc": "2026-11-10T22:38:46.909Z",
  "remainderTicket": 0,
  "clientOrderId": "copy-7f3a-0001"
}

Modify an existing position or pending order. The ticket type decides what's modifiable: a position ticket accepts only stopLoss and takeProfit; a pending-order ticket also accepts price and expiration. Omit a field to keep its current value. A modify that changes nothing answers retcode 10025 (No changes) with outcome no_change, without a request to cTrader.

• ticket* (required): Position or pending-order ticket.
• stopLoss / takeProfit: New SL/TP; omit to keep current.
• price: New price (pending orders only).
• expiration: New expiration (date string, UTC), pending orders only.
• expirationUtc: The same as ISO-8601, instead of expiration.

{
  "ticket": 302262716,
  "stopLoss": 1.11000,
  "takeProfit": 1.12500
}

curl -X POST https://api.fxsocket.com/ctrader/{account_id}/OrderModify \
  -H "X-API-Key: fxs_live_..." \
  -H "Content-Type: application/json" \
  -d '{"ticket":302262716,"stopLoss":1.11,"takeProfit":1.125}'

{
  "success": true,
  "outcome": "applied",
  "retcode": 10009,
  "retcodeDescription": "Done",
  "deal": 0,
  "order": 0,
  "volume": 0.0,
  "price": 0.0,
  "bid": 1.11662,
  "ask": 1.11685,
  "comment": "",
  "position": 302262716,
  "time": "",
  "remainderTicket": 0
}

Close a position or delete a pending order: the action is inferred from the ticket type. For a position, supply volume for a partial close (must respect the symbol's volumeStep) or omit it for a full close. For a pending order, volume is ignored and the order is deleted. A position keeps its ticket through a partial close, so remainderTicket is always 0 on cTrader.

• ticket* (required): Position ticket (closes it) or pending-order ticket (deletes it).
• volume: Partial close volume; omit or 0 = full close.

{
  "ticket": 302262716
}

curl -X POST https://api.fxsocket.com/ctrader/{account_id}/OrderClose \
  -H "X-API-Key: fxs_live_..." \
  -H "Content-Type: application/json" \
  -d '{"ticket":302262716}'

{
  "success": true,
  "outcome": "applied",
  "retcode": 10009,
  "retcodeDescription": "Done",
  "deal": 343051320,
  "order": 328018048,
  "volume": 0.01,
  "price": 1.11662,
  "bid": 1.11662,
  "ask": 1.11685,
  "comment": "",
  "position": 302262716,
  "time": "2026-11-10T22:38:51.590Z",
  "timeUtc": "2026-11-10T22:38:51.590Z",
  "remainderTicket": 0
}

Margin a hypothetical order would need, in the account currency. cTrader computes it at the current price; the bridge moves it to the price you pass: on an account in the symbol's quote currency, and for CFDs and indices, the margin follows the price, on an account in the base currency or a third one it does not depend on it. With tiered leverage the result is an approximation. Does not place an order, purely a sizing/risk query.

• symbol* (required): Symbol name as listed by /symbols.
• operation* (required): Buy, Sell, BuyLimit, SellLimit, BuyStop, SellStop.
• volume* (required): Volume in lots.
• price* (required): Hypothetical entry price.

curl -H "X-API-Key: fxs_live_..." \
  "https://api.fxsocket.com/ctrader/{account_id}/OrderCalcMargin?symbol=EURUSD&operation=Buy&volume=0.1&price=1.11685"

{
  "symbol": "EURUSD",
  "operation": "Buy",
  "volume": 0.1,
  "price": 1.1,
  "margin": 100.0,
  "currency": "EUR"
}

Projected P&L for a hypothetical open → close move, in the account currency, converted at the current rate. Computed by the bridge from the symbol's contract size and cTrader's conversion rates. Does not place an order, useful for position sizing and UI.

• symbol* (required): Symbol name as listed by /symbols.
• operation* (required): Buy or Sell (pending variants accepted, only the direction is used).
• volume* (required): Volume in lots.
• priceOpen* (required): Hypothetical open price.
• priceClose* (required): Hypothetical close price.

curl -H "X-API-Key: fxs_live_..." \
  "https://api.fxsocket.com/ctrader/{account_id}/OrderCalcProfit?symbol=EURUSD&operation=Buy&volume=0.1&priceOpen=1.11685&priceClose=1.12685"

{
  "symbol": "EURUSD",
  "operation": "Buy",
  "volume": 0.1,
  "priceOpen": 1.1,
  "priceClose": 1.11,
  "profit": 89.56,
  "currency": "EUR"
}