> 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-profits.md).

# Grid Bot Profits

<br>

**Description:** Returns profit data for a specific Grid Line associated with a Grid Bot, identified by its unique ID<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>

## Body Parameters<br>

**id**     `string`\
Filters the Grid Bots created after a specific date. Use an ISO 8601 datetime string as the value

**id**     `string`\
Filters the Grid Bots created before a specific date. Use an ISO 8601 datetime string as the value

<br>

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

\ <br>

## Response Parameters<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

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

**grid\_line**     `object`\
Details about a specific Grid line event

&#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**     `string`\
&#x20;     Indicates whether the order for this Grid line has been placed

<br>

## Example Request<br>

```
GET /ver1/grid_bots/2338357/profits
```

<br>

## Example Response and errors<br>

<details>

<summary>Status: 200 OK</summary>

<br>

```
[
    {
        "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": 256427676,
        "profit": "0.0673937919894358",
        "usd_profit": "0.0673937919894358",
        "created_at": "2024-10-03T20:01:44.874Z",
        "grid_line": {
            "id": 256427676,
            "price": "0.022059",
            "side": "buy",
            "order_placed": true
        }
    }
]

```

</details>

<details>

<summary>Status: 401 Unauthorized</summary>

<br>

```json
{
    "error": "signature_invalid",
    "error_description": "Provided signature is invalid"
}
```

</details>