Treasury API

Manage your treasury funds, check balances, and configure payouts.

Get Balance

HTTPGET

curl -X GET https://api.etbx.com/api/v1/partners/balance -H "Authorization: Bearer YOUR_API_KEY"

Responsejson

{
  "data": {
    "treasuryBalance": 5000.50,
    "ethBalance": 0.15,
    "treasuryAddress": "0x742d..."
  }
}

Get/Set Fee

GETGET

curl -X GET https://api.etbx.com/api/v1/partners/fee -H "Authorization: Bearer YOUR_API_KEY"

GET Responsejson

{
  "data": {
    "feePercent": 0.5
  }
}

PUTPUT

curl -X PUT https://api.etbx.com/api/v1/partners/fee \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"feePercent": 0.5}'

PUT Responsejson

{
  "data": {
    "feePercent": 0.5
  }
}

Sets the platform fee in percent (0-100). Default is 0.25%.

Set Webhook

HTTPPUT

curl -X PUT https://api.etbx.com/api/v1/partners/webhook \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhookUrl": "https://your-app.com/webhooks/etbx"}'

Payout Destination

HTTPPUT

curl -X PUT https://api.etbx.com/api/v1/partners/treasury/payout-destination \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "mobile",
    "phone": "+251912345678"
  }'

Configures the partner payout method. Types: "mobile (telebirr), bank

Next Steps

Webhooks - Event notifications