⚙️Limits: Buy Amount & Sell Quantity

All onramp and offramp transactions are subject to provider-specific limits.

• Buy limits define the minimum and maximum fiat amount a user can spend.

• Sell limits define the minimum and maximum crypto amount a user can sell.

These limits depend on multiple factors such as provider, region, currency, payment method, and selected asset.To cover different integration scenarios, Coindisco provides three separate APIs for retrieving limits — from high-level aggregated values to fully detailed provider-specific data.Choose the appropriate endpoint based on the level of precision required in your integration:

• Use global limits for quick validation and initial UI boundaries

• Use method-level limits to display available payment options

• Use provider-level limits for precise calculations and final selection

Each option is described in detail below.

---

1. Get Global Limits (All Providers)

Use this endpoint to pre-fetch aggregated minimum and maximum limits across all providers.This is useful for:

• displaying approximate boundaries in the UI before user selection

• performing a basic validation that a transaction is possible

The response contains the widest possible range (minimum of all minimums and maximum of all maximums) for both buy and sell operations.

curl --location 'https://api.coindisco.com/api/white-label/v1/aggregated-limits/' --header 'partner-api-key: YOUR_API_KEY'

Response example

{
    "version": 1,
    "buy": {
        "3": { // currency id (USD for example)
            "min_buy": 1,
            "max_buy": 30000
        },
    },
    "sell": {
        "2": { // cryptocurrency id (ETH for example)
            "min_sell": 0.00193,
            "max_sell": 62.768
        },
    }
}

---

2. Get Available Methods with Limits

This endpoint returns a list of payment methods available for a specific context, along with their limits.Use this when:

• user has selected asset and region

• you want to show available payment methods with limits

Each method in the response includes its aggregated limits across relevant providers.

curl --location '{{domain}}/api/white-label/v1/regions/{{region_id}}/v2/payment-methods/?\
service_id=1,14& \
type=buy/sell& \ 
cryptocurrency={{bitcoin_id}}& \
network={{bitcoin_network_id}}& \
limits=true& \
currency=USD' \
--header 'partner-api-key: YOUR_API_KEY'

Response example

[
    {
        "id": 5,
        "letter_id": "mobile_wallet_apple_pay",
        "code": "mobile_wallet",
        "name": "Apple Pay",
        "icon": "https://s3.amazonaws.com/cdn-staging.coindisco.com/media/service_integration/PaymentMethod/mobile_wallet_ios_s9k38kz.png",
        "min_limit": 10,
        "max_limit": 50000
    },
    {
        "id": 10,
        "letter_id": "mobile_wallet_google_pay",
        "code": "mobile_wallet",
        "name": "Google Pay",
        "icon": "https://s3.amazonaws.com/cdn-staging.coindisco.com/media/service_integration/PaymentMethod/mobile_wallet_android.png",
        "min_limit": 10,
        "max_limit": 50000
    },
]

---

3. Get Provider-Specific Limits

This is the most detailed endpoint.

In addition to all parameters from the previous endpoint, you also pass:

• payment method

The response returns limits for each individual provider supporting this method.

Use this when:

• user selected a specific payment method

• you need exact limits per provider

curl --location '{{domain}}/api/white-label/v1/limits/evaluate/?\
currency={{usd_currency}}& \
cryptocurrency={{eth_id}}& \
network={{eth_network_id}}& \
region={{usa_region}}& \
payment_method={{credit_card}}& \
type=buy/sell' \
--header 'partner-api-key: YOUR_API_KEY'

Response example

[
    {
        "service": {
            "id": 1,
            "name": "MoonPay",
            "slug": "moonpay"
        },
        "limits": {
            "min": 20,
            "max": 30000
        }
    },
    {
        "service": {
            "id": 5,
            "name": "Transak",
            "slug": "transak"
        },
        "limits": {
            "min": 5,
            "max": 3000
        }
    },
]