# Settings

> Returns the stored values for one or more keys belonging to the authenticated profile.
Pass a single key or a comma-separated list of keys via the `keys` query parameter.
Keys that have never been written are included in the response with a null value.
Returns 400 if any key fails the format validation (^[A-Za-z0-9_\-:#]+$, max 256 chars each).
Max 50 keys per request.


Source: /trader/api/settings/get-client-settings-batch

## `GET /settings`

**Settings**

Returns the stored values for one or more keys belonging to the authenticated profile.
Pass a single key or a comma-separated list of keys via the `keys` query parameter.
Keys that have never been written are included in the response with a null value.
Returns 400 if any key fails the format validation (^[A-Za-z0-9_\-:#]+$, max 256 chars each).
Max 50 keys per request.


Tags: `Settings`

#### Query parameters

- `keys` (string) (required) — Comma-separated setting keys (pattern: ^[A-Za-z0-9_\-:#]+$, max 256 chars each, max 50 keys)


### Responses

#### `200` — Settings retrieved successfully

**Content-Type:** `application/json`

Batch response for multi-key settings lookup. Each requested key is present as a property. Keys that have never been written are included with a null value.

- `settings` (object) (required) — Map of key → ClientSettingResponse for each requested key.

#### `400` — Missing or invalid keys parameter (each key must match ^[A-Za-z0-9_\-:#]+$, max 256 chars, max 50 keys)

**Content-Type:** `application/json`

- `error` (object) (required)
  - `type` (string) (required) — Error type code
  - `message` (string) (required) — Human-readable error message
  - `field` (string) — Field name if error is field-specific

#### `401` — Unauthorized

**Content-Type:** `application/json`



#### `500` — Internal server error

**Content-Type:** `application/json`