> 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-required-balances-to-start-bot.md).

# Get required balances to start bot

<br>

**Description:** Returns the amount of funds required to launch the Grid Bot and details about the current balance state.<br>

{% hint style="info" %}
This endpoint works only for the spot exchange.
{% endhint %}

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

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

<br>

## Path Parameters<br>

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

<br>

## Parameters response<br>

**missing\_balance**     `object`\
\[TBD]

&#x20;     **base**     `object`\
&#x20;     Details of the missing amount in the base currency

&#x20;           **quantity**     `string`\
&#x20;           The amount of the base currency that is missing

&#x20;           **currency**     `string`\
&#x20;           The name or symbol of the base currency

&#x20;     **quote**     `object`\
&#x20;     Details of the missing amount in the quote currency

&#x20;           **quantity**     `string`\
&#x20;           The amount of the quote currency that is missing

&#x20;           **currency**     `string`\
&#x20;           The name or symbol of the quote currency

**required\_balance**     `object`\
The total amount of funds required in base and quote currencies to launch the Grid Bot

&#x20;     **base**     `object`\
&#x20;     Details of the required amount in the base currency

&#x20;           **quantity**     `string`\
&#x20;           The total amount of the base currency required

&#x20;           **currency**     `string`\
&#x20;           The name or symbol of the base currency

&#x20;     **quote**     `object`\
&#x20;     Details of the required amount in the quote currency

&#x20;           **quantity**     `string`\
&#x20;           The total amount of the quote currency required

&#x20;           **currency**     `string`\
&#x20;           The name or symbol of the quote currency

**need\_balancing**     `boolean`\
Indicates whether additional funds are required to balance the Grid Bot (`true`) or not (`false`)

**balancing\_available**     `boolean`\
Indicates whether the bot can be balanced with the current available funds (`true`) or not (`false`)

**necessary\_quantities**     `object`\
Details of the exact amount and currency required to balance the Grid Bot

&#x20;     **quantity**     `string`\
&#x20;     The specific amount of the required currency needed to balance the bot

&#x20;     **currency**     `string`\
&#x20;     The symbol of the currency required for balancing

<br>

## Example Request<br>

```
GET /ver1/grid_bots/12345678/required_balances
```

## Example Response and errors<br>

<details>

<summary>Status: 200 OK</summary>

\
\`\`\`json { "missing\_balance": { "base": { "quantity": "0.0", "currency": "BTC" }, "quote": { "quantity": "8500.0", "currency": "USDT" } }, "required\_balance": { "base": { "quantity": "2.0", "currency": "BTC" }, "quote": { "quantity": "18500.0", "currency": "USDT" } }, "need\_balancing": true, "balancing\_available": true, "necessary\_quantities": { "quantity": "8500.0", "currency": "USDT" } } \`\`\`

</details>

<details>

<summary>Status: 404 Not Found</summary>

<br>

```json
{
    "error": "not_found",
    "error_description": "Not Found"
}
```

</details>

<details>

<summary>Status: 500 Internal Server Error</summary>

<br>

```json
{
    "error": "grid_lines_not_marked",
    "error_description": "Grid lines empty or not marked"
}
```

</details>