> 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/get-profit-details-of-grid-bot.md).

# Get profit details of Grid Bot

<br>

**Description:** Returns profit details of existing Grid Bot using its ID<br>

<br>

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

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

<br>

## Path Parameter<br>

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

<br>

## Query parameters<br>

**from**     `string`\
Filters Grid Bots created after a specific date in ISO 8601 format

**to**     `string`\
Filters the Grid Bots created before a specific date in ISO 8601 format

<br>

{% hint style="info" %}
If the from and to values are not set, the response will include all records ordered in descending (`DESC`) order by ID parameter
{% endhint %}

<br>

## Parameters response<br>

**grid\_line\_id**     `string`\
Unique 3Commas ID for this Grid line entity

**profit**     `string`\
Profit amount from this Grid line event in the base currency

**usd\_profit**     `string`\
Profit amount in USD from this Grid line event

**created\_at**     `string`\
ISO 8601 datetime string indicating when the event was recorded

**grid\_line**     `object`\
\[TBD]

&#x20;     **id**     `string`\
&#x20;     Unique 3Commas ID for this Grid line entity

&#x20;     **price**     `string`\
&#x20;     The price value at which the asset was bought or sold when this grid line was executed

&#x20;     **side**     `string`\
&#x20;     Order side for this Grid line

&#x20;     **order\_placed**     `boolean`\
&#x20;     Indicates whether the order for this Grid line has been placed

<br>

## Example Request<br>

```json
GET /ver1/grid_bots/2338357/profits?from=2024-09-01T04:00:00.000Z&to=2024-10-11T03:59:59.000Z
```

<br>

## Example response and errors<br>

<details>

<summary>Status: 201 Created</summary>

<br>

```json
[
    {
        "grid_line_id": 256470631,
        "profit": "0.5387463715614246",
        "usd_profit": "0.5387463715614246",
        "created_at": "2024-10-06T11:45:47.500Z",
        "grid_line": {
            "id": 256470631,
            "price": "0.022954",
            "side": "buy",
            "order_placed": false
        }
    },
    {
        "grid_line_id": 256439950,
        "profit": "0.2721254846234494",
        "usd_profit": "0.2721254846234494",
        "created_at": "2024-10-04T16:23:16.731Z",
        "grid_line": {
            "id": 256439950,
            "price": "0.022503",
            "side": "buy",
            "order_placed": false
        }
    },
    ...
]
```

</details>