Trading

Add Event (Sent by FM to Maker)

Forwards an order to a maker for execution. The WS connection providing market data updates for the corresponding stream is used to send the event.

Event Schema

{
  "event": "add", // event type, required
  "instrument": <string>, // instrument name, required
  "clientOrderId": <UUID>, // client order id, required
  "price": <uint64>, // order limit price, optional
  "size": <int64>, // order size, required
  "side": <string>, // order side, required; can be "bid" or "ask"
  "type": <enum>, // order type, required; e.g., "limitFOK", "limitIOC"
  "clientId": <uint32> // FM id of an order owning client (taker), required
}
The FM sends the taker order to the Maker via the connection corresponding to the assigned stream.

Event Example

{
  "event": "add",
  "instrument": "BTC-USD",
  "clientOrderId": "bce0f241-e372-4b31-902c-f91404662a0a",
  "price": 100000000,
  "size": 100000000,
  "side": "ask",
  "type": "limitFOK",
  "clientId": 2
}

Execution Report (Trade)

Confirms a trade execution.

Event Schema

{
  "event": "executionReport", // event type, required
  "reqId": <string>, // execution report id, required
  "executionType": "trade", // type of the report, required
  "clientOrderId": <UUID>, // client order id, required
  "remainingQuantity": <int64>, // quantity open for execution, required
  "dealId": <string>, // deal id, required
  "dealPrice": <uint64>, // execution price, required
  "dealSize": <int64>, // executed size, required
  "dealVolume": <int64> // executed volume, required
}

Event Example

{
  "event": "executionReport",
  "reqId": "6",
  "executionType": "trade",
  "clientOrderId": "50c21deb-30d1-44c5-a8f7-79c352bcbbcc",
  "remainingQuantity": 0,
  "dealId": "deal_id",
  "dealPrice": 200000000,
  "dealSize": 200000000,
  "dealVolume": 400000000
}

Execution Report (Reject)

Rejects a trade with a reason.

Event Schema

{
  "event": "executionReport", // event type, required
  "reqId": <string>, // execution report id, required
  "executionType": "reject", // type of the report, required
  "clientOrderId": <UUID>, // client order id, required
  "reason": <string> // reject reason, required
}

Event Example

{
  "event": "executionReport",
  "reqId": "6",
  "executionType": "reject",
  "clientOrderId": "50c21deb-30d1-44c5-a8f7-79c352bcbbcc",
  "reason": "insufficient liquidity"
}