> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://docs.prividium.com/api/mcp` to find what you need.
>
> **Have feedback?** Use `submit_feedback` on the same MCP server.

# wallets

## POST /user-wallets/initiate

`POST /user-wallets/initiate`

Generate a SIWE message for wallet association

### Request body (required) (`application/json`)

- `walletAddress` `string` _(required)_
- `domain` `string` _(required)_

### Responses

#### `200`: Default Response

Body (`application/json`):

- `message` `string` _(required)_
- `nonce` `string` _(required)_
- `nonceToken` `string` _(required)_

#### `400`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl /api/user-wallets/initiate \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddress": "string",
  "domain": "string"
}'
```

```ts
fetch('/api/user-wallets/initiate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    walletAddress: 'string',
    domain: 'string'
  })
})
```

## POST /user-wallets/associate

`POST /user-wallets/associate`

Associate a wallet with the current user after signature verification

### Request body (required) (`application/json`)

- `walletAddress` `string` _(required)_
- `message` `string` _(required)_
- `signature` `string` _(required)_
- `nonceToken` `string` _(required)_

### Responses

#### `200`: Default Response

Body (`application/json`):

- `success` `boolean` _(required)_

#### `400`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `409`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl /api/user-wallets/associate \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddress": "string",
  "message": "string",
  "signature": "string",
  "nonceToken": "string"
}'
```

```ts
fetch('/api/user-wallets/associate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    walletAddress: 'string',
    message: 'string',
    signature: 'string',
    nonceToken: 'string'
  })
})
```

## GET /user-wallets/

`GET /user-wallets/`

List all wallets associated with the current user

### Responses

#### `200`: Default Response

Body (`application/json`):

- `wallets` `string[]` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl /api/user-wallets/
```

```ts
fetch('/api/user-wallets/')
```

## DELETE /user-wallets/{walletAddress}

`DELETE /user-wallets/{walletAddress}`

Remove a wallet association from the current user

### Path parameters

- `walletAddress` `string` _(required)_

### Responses

#### `204`: Default Response

#### `400`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `404`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl /api/user-wallets/string \
  --request DELETE
```

```ts
fetch('/api/user-wallets/string', {
  method: 'DELETE'
})
```