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

# Overview

> WellWallet OpenAPI overview — base URL, authentication, quickstart examples, rate limits.

All REST API endpoints are available at:

```text theme={null}
https://tag.alfa-bot.com/api/prod/v1/{endpoint}
```

* All endpoints return time in Unix-time format and respond with JSON.

***

## Quickstart

### Prerequisites

* A WellWallet account ([Sign up](https://t.me/wellwallet))
* An API key with appropriate permissions: Settings - Settings - API - API Keys Managment - Create
* Write [our support](https://t.me/WellWallet_Support) yours IP for whitelist.We have no restrictions on the number of IP addresses. Access is granted within 2 business days.
* Enable 2FA in the bot — Settings → Settings → Security → 2FA
* Enable backup email in the bot — Settings → Settings → Security → Email
* Switch on the necessary APIs — Settings → Settings → API → API Keys Management → choose API key → Manage → choose the necessary settings
* A programming language or HTTP client (cURL, Python, JavaScript, or similar)

### Step 1: Authentication setup

**Required headers for private endpoints:**

| Header         | Value              |
| -------------- | ------------------ |
| `Content-type` | `application/json` |
| `token`        | Your API Key       |

### Step 2: First authenticated API call

The [Test Method](/api-reference/test/test-method) endpoint retrieves the default response.

***

## Wallet Types

WellWallet supports two main wallet models:

* Personal Wallet
* Exchange Wallet

Each wallet type is designed for a different balance management approach.

***

## Personal Wallet — Separate Balance

The Personal Wallet is designed for users who want all received funds to remain on a dedicated address and not be moved within the system.

### Advantages

* Direct storage on the blockchain — funds remain on a single address without internal transfers
* Maximum transparency — every transaction is visible on the blockchain

### Limitations

* Risk with suspicious deposits — if suspicious funds are received, the entire balance may be affected
* No cross-chain USDT balance — ERC-20 and TRC-20 funds are stored separately
* Transfers within WellWallet are processed as regular blockchain transactions with network fees

***

## Exchange Wallet — Flexibility and Instant Transfers

The Exchange Wallet offers more convenient fund management, reduces the risk of blocking due to suspicious deposits, and enables instant transfers within the system.

### How it works

* When depositing, funds are credited to a dedicated address, undergo verification, and are moved to the central exchange wallet.
* When withdrawing, funds are sent from the central exchange wallet.

### Advantages

* Reduced risk of blocking — suspicious transactions are not mixed with the user’s other funds
* Instant transfers between WellWallet users with no fees
* Cross-chain USDT balance for ERC-20 and TRC-20 — deposit in one network and withdraw in another

### Limitations

* All user funds are stored in the central exchange wallet of WellWallet, without a dedicated storage address

***

## Webhooks

WellWallet sends webhook notifications from fixed IP addresses.

Use IP allowlisting to protect your webhook endpoint and accept requests only from trusted WellWallet sources.

### Webhook Source IP Addresses

```text theme={null}
54.171.15.37/32
108.128.68.222/32
63.33.226.230/32
```

## Limits

The default API request limits are:

* 10,000 requests per day
* 100,000 requests per month

If you need higher limits, contact the WellWallet team.