Get the org's funding address

Where to send USDT to fund payouts, and the current balance there. Org-level, not per-order or per-batch — stable, safe to cache. Confirming a batch never returns a new address; it only moves whatever balance is already sitting here.

GET /api/v2/payouts/funding-address

Get the org's funding address

cURL

curl --request GET \
  --url https://api.mansa.xyz/api/v2/payouts/funding-address \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-key: <api-key>'

200

{
  "chain": "TRON",
  "network": "TRC20",
  "asset": "USDT",
  "address": "T...",
  "contract_address": "T...",
  "balance": {
    "available": "0",
    "total": "0"
  },
  "gas_balance": {
    "available": "0",
    "total": "0"
  }
}

Authorizations

x-api-key · string · header · required

API key for authentication

Authorization · string · header · required

ES256 JWT signed by the private key registered to the API key above. Claims: sub (=API key), uri, nbf, iat, exp, and bodyHash (HMAC-SHA512 of uri + rawBody + nbf using a shared secret, base64).

Response

200

application/json

Funding address

chain · string · required

Human-readable chain name, e.g. "TRON"

Example:

"TRON"

network · enum<string> · required

Not caller-selectable

Available options: TRC20, ERC20

asset · string · required

Always "USDT" today

Example:

"USDT"

address · string · required

This org's own deposit wallet

contract_address · string · required

The asset's own on-chain contract address — distinct from address.

balance · object · required

USDT balance at address.

Show child attributes

gas_balance · object · required

Native-token balance (e.g. TRX) at the same wallet — needed for outbound gas.

Show child attributes