# Workspace Wallets (Coinbax Core API)

> Source: https://developers.coinbax.com/reference/coinbax-core/workspace-wallets/
> Staging base URL: https://core-staging.coinbax.com/api/v1

## List wallet accounts

`GET /workspaces/{id}/wallet-accounts`

- Auth: Bearer token
- Operation ID: `listWorkspaceWalletAccounts`

Retrieve wallet accounts for a workspace from its configured wallet provider (Turnkey).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes | Workspace UUID |

### Example request

```bash
curl https://core-staging.coinbax.com/api/v1/workspaces/<id>/wallet-accounts \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

### Responses

**200** Wallet accounts retrieved successfully

```json
{
  "success": true,
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150,
      "totalPages": 8
    }
  },
  "data": {
    "accounts": [
      {
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "addressFormat": "ADDRESS_FORMAT_ETHEREUM",
        "path": "m/44'/60'/0'/0/0",
        "curve": "CURVE_SECP256K1"
      }
    ],
    "message": "string"
  }
}
```

**400** Wallet provider not configured

**401** Unauthorized - missing or invalid authentication

**404** Resource not found

**500** Internal server error

---

## Create wallet accounts

`POST /workspaces/{id}/wallet-accounts`

- Auth: Bearer token
- Operation ID: `createWorkspaceWalletAccounts`

Create new wallet accounts for a workspace in its configured wallet provider (Turnkey).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes |  |

### Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `accounts` | array of object | yes |  |

```json
{
  "accounts": [
    {
      "addressFormat": "ADDRESS_FORMAT_ETHEREUM",
      "curve": "string",
      "path": "string"
    }
  ]
}
```

### Example request

```bash
curl -X POST https://core-staging.coinbax.com/api/v1/workspaces/<id>/wallet-accounts \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "accounts": [
    {
      "addressFormat": "ADDRESS_FORMAT_ETHEREUM",
      "curve": "string",
      "path": "string"
    }
  ]
}'
```

### Responses

**200** Wallet accounts created successfully

```json
{
  "success": true,
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150,
      "totalPages": 8
    }
  },
  "data": {
    "accounts": [
      {
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "addressFormat": "ADDRESS_FORMAT_ETHEREUM",
        "path": "m/44'/60'/0'/0/0",
        "curve": "CURVE_SECP256K1"
      }
    ],
    "message": "string"
  }
}
```

**400** Bad request - validation error

**401** Unauthorized - missing or invalid authentication

**404** Resource not found

**500** Internal server error

---

## Get wallet balances

`GET /workspaces/{id}/wallet-balances`

- Auth: Bearer token
- Operation ID: `getWorkspaceWalletBalances`

Retrieve blockchain balances for all wallet accounts in a workspace.
Fetches balances from both Solana and EVM networks with graceful degradation.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes | Workspace UUID |

### Example request

```bash
curl https://core-staging.coinbax.com/api/v1/workspaces/<id>/wallet-balances \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

### Responses

**200** Wallet balances retrieved successfully

```json
{
  "success": true,
  "data": {
    "balances": [
      {
        "address": "0x1234...",
        "network": "base",
        "nativeBalance": "0.5",
        "nativeSymbol": "ETH",
        "tokens": [
          {
            "symbol": "USDC",
            "balance": "100.00",
            "contractAddress": "0xusdc..."
          }
        ]
      }
    ],
    "warnings": []
  },
  "meta": {
    "timestamp": "2026-02-24T12:00:00.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}
```

**400** Wallet provider not configured

**401** Unauthorized - missing or invalid authentication

**404** Resource not found

**500** Internal server error