Transfer Funds to User Wallet

POST

/wallets/transfer-to-user/

Transfers funds from the master account to a specific user wallet (sub-account). This operation decreases the master account balance and increases the sub-account balance by the specified amount.

Request Parameters

Parameter	Type	Required	Description
wallet_id	string	Yes	The external ID of the user wallet (sub-account) to transfer funds to
currency	string	Yes	The currency code (e.g., "USDTTRC20", "BTC")
amount	number	Yes	The amount to transfer (must be positive)

Example Request

POST /wallets/transfer-to-user/
Content-Type: application/json
X-API-Key: your_api_key_here

{
  "wallet_id": "550e8400-e29b-41d4-a716-446655440000",
  "currency": "USDTTRC20",
  "amount": 100.00
}

Response Parameters

Parameter	Type	Description
result	object	Result object containing transaction details

Result Object

Parameter	Type	Description
id	string	Transaction identifier
amount	number	Amount transferred
currency	string	Currency code of the transferred amount
status	string	Status of the transaction (usually "completed")

Example Response

{
  "result": {
    "id": "6d3f0960-5551-4af5-9601-aeecc512a87a",
    "amount": 100.00,
    "currency": "USDTTRC20",
    "status": "completed"
  }
}

Error Codes

Status Code	Error Message	Description
400	"Account ID, currency, and amount are required"	Missing required parameters
400	"Amount must be positive"	Attempting to transfer zero or negative amount
400	"Insufficient tenant balance"	Master account has insufficient balance to complete the transfer
404	"Account not found"	The specified wallet_id does not exist
404	"Tenant balance not found"	No balance exists for the specified currency in the master account
401	authentication_failed	Authentication failed. Check your API key or OAuth 2.0 access token
403	insufficient_permissions	Your API key does not have required permissions
500	"Internal server error"	An error occurred on the server

Notes

This endpoint is used to fund individual player wallets from the master account.
The transfer is atomic and will either succeed completely or fail completely.
Both accounts must have the same currency for the transfer to succeed.
The master account balance is decreased and the user wallet balance is increased by the same amount.
You can monitor your master account balance using the /user/balances endpoint.

iGaming Integration Note

Casino operators should use this endpoint to fund player wallets for gameplay. For example, when a player makes a deposit through the platform, you can transfer the equivalent amount from your master account to the player's wallet using this endpoint. Similarly, when a player wins, you can add funds to their wallet from your master account.