Trade Entity

Attributes

uuidstring

Unique 3Commas ID for this Trade entity.

account_idinteger

Unique 3Commas ID for this exchange account entity.

pairstring

Trading pair in 3Commas format (e.g., BTC_ETH).

created_atinteger

Unix timestamp when this Trade was created. Value: 1727871936

closed_atinteger

Unix timestamp when this Trade was closed. Value: 1727871937

orderobject

Details of the order applied to this Trade.

Hide child parametersShow child parameters

typestring

Type of order: market, limit

sidestring

The side of the order: buy, sell

strategystring

The strategy used for this Trade. Value: gtc, fok, ioc, post_only

position_sidestring

Position side. Value: both, long, short.

reduce_onlyboolean

Indicates whether the order is reduce only. Value: false

unitsobject

Hide child parametersShow child parameters

valuestring

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

priceobject

Hide child parametersShow child parameters

valuestring

The price of the order. Applied only for limit orders. Value: null, 0.04021

totalobject

Hide child parametersShow child parameters

valuestring

Total value of the order. Value: 0.099898773

conditionalobject

Details of the conditional order behavior applied to this Trade.

Hide child parametersShow child parameters

enabledboolean

Indicates whether the conditional order is enabled. Value: false, true

valuestring

Desribes the direction of the comparison. Example: Execute when current price becomes less than condition. Values: less, less_or_equal, greater_or_equal, greater

priceobject

Hide child parametersShow child parameters

valuestring

Conditional trigger price. Value: 1500.00

typestring

Conditional price type. Values: bid, ask, last

trailingobject

Configuration of the trailing stop applied to this Trade.

Hide child parametersShow child parameters

enabledboolean

Specifies whether the trailing stop is active. Possible values: true, false.

valuestring

Defines the absolute step size used to follow the price.
Example: value="0.01" means the stop will trail the price by a fixed amount of 0.01.

percentstring

Defines the relative step size (percentage) used to follow the price.
Example: percent="0.5" means the stop will trail the price by 0.5% of the current price.

timeoutobject

Details of the timeout behavior applied to this Trade. Applied for conditional trades only.

If timeout is enabled, after the condition is met, the order will not be placed immediately. Instead, it will wait for the specified timeout period, re-check the condition, and then place the order if the condition is still met.

Hide child parametersShow child parameters

enabledboolean

Indicates whether the timeout is enabled. Value: false, true

valuestring

Timeout value in seconds. Value: 10

leverageobject

Details of the leverage applied to this Trade.

Hide child parametersShow child parameters

typestring

Shows the leverage type that was set when creating this Trade. Value: null

statusobject

General status information for this Trade entity.

If the trade finishes with an error, the details will be provided in the error field.

Hide child parametersShow child parameters

basic_typestring

Current status of the Trade. Possible values: idle, to_process, order_placed, pending_cancellation, cancelled, panic_sell_pending, panic_sell_order_placed, panic_sold, trailing_activated, finished, failed, inactive, smart_sell, need_reset, async_order_placement, suspended

errorstring

Description of the error if the Trade has failed. Value is null if there is no error.

filledobject

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

This object reflects how much of the Trade has been filled, including quantities and pricing details.

Hide child parametersShow child parameters

unitsstring

Amount filled in base currency. Example: 2.4869

totalstring

Amount filled in quote currency. Example: 0.099998671773

pricestring

Average fill price. Example: 0.04021

valuestring

Percentage of the trade that has been filled. Example: 100.0

dataobject

Additional information about the Trade.

Hide child parametersShow child parameters

cancelableboolean

Indicates whether the Trade can be canceled. Values: false, true

{
   "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
   }
}