Blockchain addresses & withdrawals
Preview the withdrawal fee and total debit
POST
/crypto/withdrawal-feesScope
crypto:writeAuth Bearer keyIdempotentPreview the exact currency, network, amount and destination before sending. Pass the returned feeMinor, networkFeeMinor, totalDebitMinor and termsHash as acceptedFee on the withdrawal. Changed terms require a new preview; retries retain the original idempotency key.
Headers
Idempotency-KeystringrequiredRetrying with the same key and payload replays the original response.
Request body
json
{
"asset": "USDT",
"network": "ETHEREUM",
"address": "0x1111111111111111111111111111111111111111",
"amount": "100"
}Responses
200Accepted fee terms and recipient amount
json
{
"currency": "USDT",
"decimals": 6,
"recipientMinor": 100000000,
"feeMinor": 1000000,
"networkFeeMinor": 0,
"totalDebitMinor": 101000000,
"termsHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}Errors
Errors use RFC 9457 problem details. Branch on code, and log request_id.
400Bad request401Unauthenticated403Forbidden409Idempotency conflict422Validation error429Rate limitedcURL
curl -X POST "https://business.boundlesspay.com/api/public/v1/crypto/withdrawal-fees" \
-H "Authorization: Bearer $BOUNDLESS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{ "asset": "USDT", "network": "ETHEREUM", "address": "0x1111111111111111111111111111111111111111", "amount": "100" }'