Returns the AUDD burn wallets for an asset, which is where you send AUDD before calling POST /trades/sell. Note that the path parameter is the ASSET id, not a wallet id.
The response carries tradeWallet, the single burn wallet resolved for the caller (unchanged from earlier versions of this API), and burnWallets, the full pool of burn wallets the caller may pay. Each entry has id, address, publicKey, network and status. The destination to send AUDD to is address on EVM networks (the 0x account; publicKey there is the raw public key, not a payable destination) and publicKey on Stellar (the G... account id; address is null on Stellar). Clients with one burn wallet get a one-entry list equal to tradeWallet.
The pool is static: repeated calls return the same list, and assigning an address to a customer and releasing it after the hold window is the client's responsibility. Cache the list, pass the chosen entry's id as tradeWalletId on POST /trades/sell, and refresh it periodically or when a sell is rejected with trade.wallet_not_eligible.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Success. Body: tradeWallet (the resolved burn wallet), burnWallets (array of burn wallets with id, address, publicKey, network, status; send AUDD to address on EVM networks and to publicKey on Stellar), asset, distributorCompany, distributorWallet when walletId was supplied, buyEnabled, sellEnabled.
Invalid request. Returned when the path parameter is not an asset id that resolves, when walletId names a wallet that cannot be used with this asset, or (asset.distributor_wallet_required) when walletId is omitted by a caller that does not belong to a company.
Unauthorized
Forbidden
Not found
Internal server error