Get market orders of Grid Bot

GET

/ver1/grid_bots/:id/market_orders

Permission: BOTS_READ

Security: SIGNED

Returns a list of market orders for a Grid Bot using its ID.

---

Path Parameter

idintegerrequired

Unique 3Commas ID for this Grid Bot entity.

Query Parameters

limitinteger

Quantity of the records you want to get in response.

min: 1

max: 1000

default: 100

offsetinteger

Used to specify the starting point for a set of records to return in a paginated list.

default: 0

Example Request

GET

/ver1/grid_bots/2338357/market_orders

Response Parameters

grid_lines_ordersobject

An array of grid line orders associated with this trading strategy.

Hide child parametersShow child parameters

order_idinteger

ID of Trade entity.

order_typestring

The side of the order to be created by this trade: Buy or Sell.

status_stringstring

3Commas status for this Trade.

created_atstring

ISO 8601 datetime string of when this Trade entity was created.

updated_atstring

ISO 8601 datetime string of when this Trade entity was created.

quantitystring

The total amount of the asset involved in the order.

quantity_remainingstring

The amount of the asset that remains unfulfilled from the total order quantity.

totalstring

The total value of the order based on the executed quantity and rate.

ratestring

The rate at which the asset was bought or sold for this order.

average_pricestring

Weighted average price of the asset during trade execution.

balancing_ordersobject

An array of grid line orders associated with this trading strategy.

Hide child parametersShow child parameters

order_idinteger

ID of Trade entity.

order_typestring

The side of the order to be created by this trade: Buy or Sell.

status_stringstring

3Commas status for this Trade.

created_atstring

ISO 8601 datetime string of when this Trade entity was created.

updated_atstring

ISO 8601 datetime string of when this Trade entity was created.

quantitystring

The total amount of the asset involved in the order.

quantity_remainingstring

The amount of the asset that remains unfulfilled from the total order quantity.

totalstring

The total value of the order based on the executed quantity and rate.

ratestring

The rate at which the asset was bought or sold for this order.

average_pricestring

Weighted average price of the asset during trade execution.

Example Response

200 OK

{
  "grid_lines_orders": [
    {
      "order_id": 1060886383,
      "order_type": "BUY",
      "status_string": "Inactive",
      "created_at": "2024-10-03T19:53:50.598Z",
      "updated_at": "2024-10-03T19:53:51.202Z",
      "quantity": "1227.0",
      "quantity_remaining": "1227.0",
      "total": "0.0",
      "rate": "0.016287",
      "average_price": "0.0"
    },
    {
      "order_id": 1060886382,
      "order_type": "BUY",
      "status_string": "Inactive",
      "created_at": "2024-10-03T19:53:50.505Z",
      "updated_at": "2024-10-03T19:53:51.111Z",
      "quantity": "1223.0",
      "quantity_remaining": "1223.0",
      "total": "0.0",
      "rate": "0.016352",
      "average_price": "0.0"
    }
  ],
  "balancing_orders": [
    {
      "order_id": 1060886271,
      "order_type": "BUY",
      "status_string": "Filled",
      "created_at": "2024-10-03T19:53:39.784Z",
      "update_at": "2024-10-03T19:53:41.227Z",
      "quantity": "4495.0",
      "quantity_remaining": "0.0",
      "total": "98.77216807",
      "rate": "0.021973786",
      "average_price": "0.021973786"
    }
  ]
}