Skip to main content
All REST API endpoints are available at: 
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)
  • An API key with appropriate permissions: Settings - Settings - API - API Keys Managment - Create
  • Write our support yours IP for whitelist.We have no restrictions on the number of IP addresses. Access is granted within 2 business days.
  • A programming language or HTTP client (cURL, Python, JavaScript, or similar)

​
Step 1: Authentication setup

Required headers for private endpoints:
HeaderValue
Content-typeapplication/json
tokenYour API Key

​
Step 2: First authenticated API call

The 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

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.