> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ledig.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Limits

> Check how much you can convert or send before creating a payment.

A payment can have three different limits. Check each one against the right amount:

| Limit | Amount to check | Where to find it |
| - | - | - |
| Conversion | Amount you convert, in the source currency. | `GET /v1/liquidity/routes` |
| Payout method or network | Amount the recipient receives, in the destination currency. | `GET /v1/payouts/catalogue` and payment options |
| Account | The payment's USD-equivalent value. | `GET /v1/balances/summary` and your dashboard's account limits |

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:

```http theme={null}
GET /v1/liquidity/routes?sourceCurrency=USDT&destinationCurrency=NGN
```

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](https://docs.ledig.io/guides/quotes.md).

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:

| Reason | Meaning |
| - | - |
| `payout_amount_out_of_range` | The amount is below or above this method's limits. Returned bounds use the destination currency. |
| `payout_amount_unavailable` | The amount falls outside the supported bands. |
| `network_unavailable` | The selected network is unavailable. |
| `recipient_incompatible` | This recipient cannot use the selected payment option. |
| `payout_unavailable` | Sending is unavailable for this request. |

## 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.

| Error | Details you can use |
| - | - |
| `PAYOUT_TRANSACTION_LIMIT_EXCEEDED` | `requestedUsd` and `limitUsd`, when returned. |
| `PAYOUT_MONTHLY_LIMIT_EXCEEDED` | `requestedUsd`, `remainingUsd`, `resetsAt` and `timezone`, when returned. |

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](https://docs.ledig.io/guides/balances.md) to cover the amount and fees. See [Errors and troubleshooting](https://docs.ledig.io/errors/errors-and-troubleshooting.md) for sample error responses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.