⚙️Transaction limits

Buy limits are fiat amounts. Sell limits are crypto amounts. Limits can vary by provider, region, currency, asset, network, and payment method.

Aggregated limits

Use aggregated limits for initial UI boundaries, not final provider validation.

curl 'https://api.coindisco.com/api/white-label/v1/aggregated-limits/' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'

{
  "version": 1,
  "buy": {
    "3": {
      "min_buy": 1,
      "max_buy": 30000
    }
  },
  "sell": {
    "2": {
      "min_sell": 0.00193,
      "max_sell": 62.768
    }
  }
}

The keys are resource IDs: currency IDs for buy and cryptocurrency IDs for sell.

Payment methods with limits

curl 'https://api.coindisco.com/api/white-label/v1/regions/157/v2/payment-methods/?type=buy&cryptocurrency=1&network=1&limits=true&currency=USD&service_id=1,5' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'

[
  {
    "id": 5,
    "letter_id": "mobile_wallet_apple_pay",
    "code": "mobile_wallet",
    "name": "Apple Pay",
    "icon": "https://cdn.example.com/payment-methods/apple-pay.png",
    "min_limit": 10,
    "max_limit": 50000
  }
]

Use type=buy or type=sell.

Provider-specific limits

curl 'https://api.coindisco.com/api/white-label/v1/limits/evaluate/?type=buy&currency=3&cryptocurrency=1&network=1&region=157&payment_method=39' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'

Add service=5 to evaluate one provider.

[
  {
    "service": {
      "id": 5,
      "name": "Example Provider",
      "slug": "example-provider"
    },
    "limits": {
      "min": 5,
      "max": 3000
    }
  }
]

Always run final validation through quote search. A limit response does not guarantee that the complete combination is currently quoteable.