Skip to main content
A payment can have three different limits. Check each one against the right amount: For example, a conversion of 100 USDT to NGN may fit the conversion limit while the NGN amount exceeds the selected bank payment method’s limit. Other NGN methods can have different limits.

Conversion limits

Call GET /v1/liquidity/routes to see conversions available to your business. This request requires view_rates and access to quotes. You can filter by either currency or both:
Each result includes sourceCurrency, destinationCurrency, minAmount and maxAmount. Compare sourceAmount with those limits, before fees. Limits apply to one direction. For example, USDT-to-NGN and NGN-to-USDT may have different limits. Check availability and status as well as the amounts, then request a fresh quote. If a conversion is missing or the request fails, do not assume it has no limit.

Payout limits

GET /v1/payouts/catalogue lists payment methods and amount bands by currency and, for crypto, network. minimumAmount and maximumAmount apply to what the recipient receives. Keep separate bands separate. For example, 10–100 and 200–500 allow payments in either range, but not 150. External payout options return these ranges as amountBands. The option’s minimumAmount and maximumAmount are the outer bounds; they do not make gaps available. amountBands is omitted for deposit options and payments to another Ledig business. A selected method’s availability may also include bands when explaining an amount failure. maximumAmount: null means that band has no set payout maximum. Account limits and other payment requirements still apply. Missing data is different from a returned null maximum. Check payoutAvailability, then request payment options for the recipient, destination currency, amount and crypto network where applicable. Use an ID from the returned paymentMethodIds in the quote. When you include a selected paymentMethodId in the payment-options request, availability.reason may explain why it cannot be used:

Account limits

Call GET /v1/balances/summary with balances:read to read payoutAllowance: transactionLimitUsd, monthlyLimitUsd, usedUsd, reservedUsd, remainingUsd, resetsAt and timezone. These values are in USD equivalent and the allowance is shared across profiles belonging to the same business. Check enforcementEnabled: when true, these limits apply alongside conversion and payout limits. Null limits mean unlimited; zero prevents new positive payouts. USD balance estimates remain indicative and do not approve a payment. Use the returned remaining allowance and reset time. Monthly reset times use UTC. Do not show a guessed remaining allowance when the response does not include one. INSTANT_CONVERSION_LIMIT_EXCEEDED describes a separate conversion allowance in the returned sourceCurrency. Its period, requested, remaining, limit and UTC reset details should be shown in that currency, rather than as a USD payout limit. A quote or transfer checks the current limits again. You also need enough available balance to cover the amount and fees. See Errors and troubleshooting for sample error responses.