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

# List Wallets

> GET /v1/wallets — List registered wallets for your organization

<Note>
  **Endpoint:** `GET https://api.rebelfi.io/v1/wallets`
</Note>

List wallets registered under your organization with optional filters and pagination.

### Query Parameters

| Parameter    | Type     | Required | Default | Description                                                      |
| ------------ | -------- | -------- | ------- | ---------------------------------------------------------------- |
| `userId`     | `string` | No       | -       | Filter by external user ID                                       |
| `blockchain` | `string` | No       | -       | Filter by blockchain: `solana`, `polygon`, `ethereum`, or `base` |
| `page`       | `number` | No       | `1`     | Page number                                                      |
| `limit`      | `number` | No       | `50`    | Items per page (max 100)                                         |

### Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.rebelfi.io/v1/wallets?userId=user-123&blockchain=solana" \
    -H "x-api-key: your_api_key"
  ```

  ```typescript SDK theme={null}
  const { wallets, total } = await client.wallets.list({
    userId: 'user-123',
    blockchain: 'solana'
  });
  ```
</CodeGroup>

### Example Response

```json theme={null}
{
  "wallets": [
    {
      "walletId": 42,
      "walletAddress": "So11...abc",
      "blockchain": "solana",
      "userId": "user-123",
      "orgMetadata": { "plan": "premium" },
      "createdAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50
}
```

### Response Fields

| Field     | Type       | Description                              |
| --------- | ---------- | ---------------------------------------- |
| `wallets` | `Wallet[]` | List of wallets                          |
| `total`   | `number`   | Total number of wallets matching filters |
| `page`    | `number`   | Current page                             |
| `limit`   | `number`   | Items per page                           |