> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equa.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet Endpoints

> Blockchain wallet address management for entities

> **Source:** `equa-server/modules/api/src/endpoints/wallet-endpoint.ts`

# Wallet Endpoints

Endpoints for managing blockchain wallet addresses associated with entities. Used for tracking crypto wallet addresses for shareholders, organizations, and other entities.

All wallet endpoints require authentication.

**Endpoint count:** 5

## Create Wallet Address

```
POST /v1/wallet
```

| Field        | Value                     |
| ------------ | ------------------------- |
| Auth         | Required                  |
| Request Type | `NewWalletAddressRequest` |

Create a new wallet address record.

**Request Body** (`NewWalletAddressRequest`):

```json theme={null}
{
  "entity": "uuid",
  "address": "0x1234...abcd",
  "network": "ethereum",
  "label": "Primary Wallet"
}
```

***

## Update Wallet Address

```
PUT /v1/wallet/:wallet
```

| Field        | Value                      |
| ------------ | -------------------------- |
| Auth         | Required                   |
| Request Type | `EditWalletAddressRequest` |

Update an existing wallet address record.

**Path Parameters:**

| Parameter | Type   | Description              |
| --------- | ------ | ------------------------ |
| `wallet`  | `uuid` | Wallet address record ID |

***

## List Entity Wallet Addresses

```
GET /v1/entity/:entity/wallet
```

| Field        | Value           |
| ------------ | --------------- |
| Auth         | Required        |
| Request Type | `EntityRequest` |

Get all wallet addresses for an entity.

**Path Parameters:**

| Parameter | Type   | Description |
| --------- | ------ | ----------- |
| `entity`  | `uuid` | Entity ID   |

***

## Get Wallet Address

```
GET /v1/entity/:entity/wallet/:address
```

| Field        | Value           |
| ------------ | --------------- |
| Auth         | Required        |
| Request Type | `EntityRequest` |

Get a specific wallet address for an entity.

**Path Parameters:**

| Parameter | Type   | Description              |
| --------- | ------ | ------------------------ |
| `entity`  | `uuid` | Entity ID                |
| `address` | `uuid` | Wallet address record ID |

***

## Delete Wallet Address

```
DELETE /v1/entity/:entity/wallet/:address
```

| Field        | Value           |
| ------------ | --------------- |
| Auth         | Required        |
| Request Type | `EntityRequest` |

Delete a wallet address record.

**Path Parameters:**

| Parameter | Type   | Description              |
| --------- | ------ | ------------------------ |
| `entity`  | `uuid` | Entity ID                |
| `address` | `uuid` | Wallet address record ID |
