Get profit details

GET

/ver1/grid_bots/:id/profits

Permission: BOTS_READ

Security: SIGNED

Returns profit details of existing Grid Bot using its ID.

---

Path Parameter

idintegerrequired

Unique 3Commas ID for this Grid Bot entity.

Query Parameters

fromstring

Filters Grid Bots created after a specific date in ISO 8601 format.

tostring

Filters the Grid Bots created before a specific date in ISO 8601 format.

If the from and to values are not set, the response will include all records ordered in descending order by ID parameter.

Example Request

GET

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

Response Parameters

grid_line_idstring

Unique 3Commas ID for this Grid line entity.

profitstring

Profit amount from this Grid line event in the base currency.

usd_profitstring

Profit amount in USD from this Grid line event.

created_atstring

ISO 8601 datetime string indicating when the event was recorded.

More attributes

grid_linesobject

Example Response

201 Created

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