> For the complete documentation index, see [llms.txt](https://3commas.gitbook.io/3commas-official-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3commas.gitbook.io/3commas-official-api-docs/grid-bot/grid-bot-market-orders.md).

# Grid Bot Market Orders

<br>

**Description:** Returns a list of market orders for a Grid Bot using its ID<br>

**Permission:** BOTS\_READ\
**Security:** SIGNED\ <br>

> <mark style="color:blue;">**`GET`**</mark>
>
> `/ver1/grid_bots/{id}/market_orders`

<br>

## Path Parameter<br>

**id**     `integer`     <mark style="color:orange;">required</mark>\
Unique 3Commas ID for this Grid Bot entity

<br>

## Query Parameters<br>

**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`

<br>

## Response Parameters<br>

**grid\_lines\_orders**     `object`\
An array of grid line orders associated with this trading strategy

&#x20;     **order\_id**     `integer`\
&#x20;     ID of Trade entity

&#x20;     **order\_type**     `integer`\
&#x20;     The side of the order to be created by this trade: `Buy` or `Sell`

&#x20;     **status\_string**     `integer`\
&#x20;     3Commas status for this Trade

&#x20;     **created\_at**     `integer`\
&#x20;     ISO 8601 datetime string of when this Trade entity was created

&#x20;     **updated\_at**     `string`\
&#x20;     ISO 8601 datetime string of when this Trade entity was updated

&#x20;     **quantity**     `integer`\
&#x20;     The total amount of the asset involved in the order

&#x20;     **quantity\_remaining**     `integer`\
&#x20;      The amount of the asset that remains unfulfilled from the total order quantity

&#x20;     **total**     `integer`\
&#x20;     The total value of the order based on the executed quantity and rate

&#x20;     **rate**     `integer`\
&#x20;     The rate at which the asset was bought or sold for this order

&#x20;     **average\_price**     `string`\
&#x20;     Weighted average price of the asset during trade execution

<br>

## Example Request<br>

```json
POST /ver1/grid_bots/2338357/market_orders
```

\ <br>

## Example Response and errors<br>

<details>

<summary>Status: 200 OK</summary>

<br>

```json
{
    "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"
        }
    ]
}
```

</details>