# Get Key

> Returns the string value stored for the authenticated profile under the given key.
This is a general-purpose key-value store used for per-profile data such as watchlists,
UI preferences, notes, or account-level configuration. Callers may store any string;
JSON-encoded objects are common but not required.
Returns 400 if the key format is invalid, or 404 if the key has never been written.


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

## `GET /settings/{key}`

**Get Key**

Returns the string value stored for the authenticated profile under the given key.
This is a general-purpose key-value store used for per-profile data such as watchlists,
UI preferences, notes, or account-level configuration. Callers may store any string;
JSON-encoded objects are common but not required.
Returns 400 if the key format is invalid, or 404 if the key has never been written.


Tags: `Settings`

#### Path parameters

- `key` (string) (required) — Setting key (pattern: ^[A-Za-z0-9_\-:#]+$, max 256 chars)


### Responses

#### `200` — Setting retrieved successfully

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

A single key-value entry scoped to the authenticated profile. Keys identify the setting (e.g. "watchlist:default", "ui:theme"). Values are arbitrary strings; callers typically encode structured data (e.g. JSON) before storing.

- `key` (string) (required) — The setting key. Pattern ^[A-Za-z0-9_\-:#]+$, max 256 chars.
- `value` (string) — The stored string value. Null if no value has been written yet. Callers may store any text (JSON-encoded objects are common but not required).
- `updated_at` (string) — ISO 8601 timestamp of the last write. Null if the setting has never been set.

#### `400` — Invalid key format (key must match ^[A-Za-z0-9_\-:#]+$, max 256 chars)

**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`



#### `404` — Key not found — no value has been stored under this key yet

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



#### `500` — Internal server error

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