Master Wallet Topup
Goal: add funds to the project master balance using a TRC20 USDT deposit address.
All requests use the encrypted envelope and shared headers. See Overview for the transport rules.
Workflow steps
Get the TRC20 deposit address
Fetch the project address used for USDT deposits.
Transfer USDT TRC20
Send funds from your blockchain wallet to the returned address. This transfer happens off-platform.
Check the project balance
Confirm the deposit has settled by reading the master balance.
API Endpoints
- POST
/api/v1/project/wallet/trc20Get the TRC20 deposit address. - POST
/api/v1/project/balanceCheck the master balance after transfer.
Schemas
ProjectWalletAddress
| Field | Type | Required | Description |
|---|---|---|---|
usdt_trc20 | string | Required | TRC20 USDT deposit address. |
ProjectBalance
| Field | Type | Required | Description |
|---|---|---|---|
available | string | Required | Available master balance as decimal string (e.g. "1234.56"). |
currency | string | Required | Balance currency, always "usdt". |
Error table
Use these error slugs to guide retries and support messaging.
| Error Slug | Description |
|---|---|
invalid_request | Request payload failed validation. |
project_not_found | Project not found for this API-KEY. |
wallet_not_found | Wallet record not found for the project. |
project_wallet_failed | Failed to generate or fetch the deposit address. |
project_balance_failed | Failed to load the project balance. |