Transfers API

Disburse ETB from treasury or sub-wallets to user wallets or other sub-wallets. Transfers happen on-chain.

Disburse ETB

HTTPPOST

curl -X POST https://api.etbx.com/api/v1/partners/disburse \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amountEtb": 100,
    "toUserId": "waas_xxx_user_001",
    "fromSubWalletId": "sub_wallet_id_123",
    "toSubWalletId": "sub_wallet_id_456"
  }'

Request Fields

Field	Type	Required	Description
amountEtb	number	Yes	Amount of ETB to transfer
toUserId	string	Optional*	Recipient user ID
toSubWalletId	string	Optional*	Recipient sub-wallet ID
fromSubWalletId	string	No	Source sub-wallet ID (defaults to treasury)

* Either toUserId or toSubWalletId is required.

Responsejson

{
  "data": {
    "success": true,
    "amountEtb": 100,
    "fromAddress": "0xabc...",
    "toAddress": "0xuser...",
    "txHash": "0xabc123..."
  }
}

Fees

All transfers incur a 0.25% platform fee:

Amount	Fee	User Receives
100 ETB	0.25 ETB	99.75 ETB
1000 ETB	2.5 ETB	997.5 ETB

Error Handling

Error	Status
Insufficient balance	400
User wallet not provisioned	400

Next Steps

Treasury - Fund your treasury
Webhooks - Event notifications