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, publicKey, network and status. 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, publicKey, network, status), 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