Grid Bot Market Orders

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

Permission: BOTS_READ Security: SIGNED

GET

/ver1/grid_bots/{id}/market_orders

Path Parameter

id integer required Unique 3Commas ID for this Grid Bot entity

Query Parameters

limit integer Quantity of the records you want to get in response Minimum: 1, Maximum: 1000 Default: 100

offset integer Used to specify the starting point for a set of records to return in a paginated list Default: 0

Response Parameters

grid_lines_orders object An array of grid line orders associated with this trading strategy

order_id integer ID of Trade entity

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

status_string integer 3Commas status for this Trade

created_at integer ISO 8601 datetime string of when this Trade entity was created

updated_at string ISO 8601 datetime string of when this Trade entity was updated

quantity integer The total amount of the asset involved in the order

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

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

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

average_price string Weighted average price of the asset during trade execution

Example Request

POST /ver1/grid_bots/2338357/market_orders

Example Response and errors

Status: 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"
        }
    ]
}