# Get baseconfig

`GET https://api.cryptohopper.com/v1/hopper/{id}/config`

Part of [Bot config](https://www.cryptohopper.com/api-documentation/api-reference/bot-config.md) in the Cryptohopper API reference.

Returns the config of the hopper with every value as a string and API keys masked as ***.

OAuth scope: `read`

fast_api_connected is "1" when the hopper is connected with Fast API.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | yes | Hopper ID. |

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `layout` | string | no | full returns every documented config field, filling missing ones with an empty string or 0. Any other value, or leaving it out, returns only fields that have a non-empty value. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/config" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "name": "My BTC bot",
        "exchange": "binance",
        "collect_currency": "usdt",
        "api_key": "***",
        "api_secret": "***",
        "allowed_coins": [
            "BTC",
            "ETH"
        ],
        "max_open_positions": "10",
        "stop_loss": "1",
        "stop_loss_percentage": "5",
        "fast_api_connected": "0"
    }
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.
