Trade Entity

A Trade is the core entity of the Quentrade Order Management System (OMS). It defines the lifecycle, parameters, conditional logic, execution details, and fill metrics for orders submitted to supported exchanges.

Attributes

uuidstring

Unique Quentrade ID for this Trade entity.

account_idinteger

Unique Quentrade ID for this exchange account entity.

pairstring

Trading pair in Quentrade format (e.g., BTC_ETH).

created_atinteger

Unix timestamp when this Trade was created. Example: 1727871936.

closed_atinteger

Unix timestamp when this Trade was closed. Example: 1727871937.

orderobject

Details of the order applied to this Trade.

unitsobject

Amount of units of BASE currency (ETH in this case) for this Trade.

priceobject

The price of the order. Applied only for limit orders.

totalobject

Total value of the order in quote currency.

conditionalobject

Details of the conditional order behavior applied to this Trade.

trailingobject

Configuration of the trailing stop behavior applied to this Trade.

timeoutobject

Details of timeout behavior for conditional trades. After condition is met, system waits for timeout period before checking and placing the order.

leverageobject

Details of the leverage settings applied to this Trade.

statusobject

General status information and error details for this Trade entity.

filledobject

Information about the current or final fill status of the Trade.

dataobject

Additional metadata and actionable state for the Trade.

Trade Object Example

trade_entity_response.json

200 OK

{
  "trade": {
    "uuid": "be523b7b-05a0-49b9-89f9-41ae19fff415",
    "account_id": 32576869,
    "pair": "BTC_ETH",
    "created_at": 1727871936,
    "closed_at": 1727871937,
    "order": {
      "type": "market",
      "side": "buy",
      "strategy": null,
      "position_side": "both",
      "reduce_only": false
    },
    "units": {
      "value": "2.4869"
    },
    "price": {
      "value": null
    },
    "total": {
      "value": "0.099898773"
    },
    "conditional": {
      "enabled": false,
      "value": null,
      "price": {
        "value": null,
        "type": null
      }
    },
    "trailing": {
      "enabled": false,
      "value": null,
      "percent": null
    },
    "timeout": {
      "enabled": false,
      "value": null
    },
    "leverage": {
      "type": null
    },
    "status": {
      "value": "finished",
      "error": null
    },
    "filled": {
      "units": "2.4869",
      "total": "0.099998671773",
      "price": "0.04021",
      "value": "100.0"
    },
    "data": {
      "cancelable": false
    }
  }
}

PREVIOUS Simple Trading NEXTCreate Trade