> For the complete documentation index, see [llms.txt](https://coindisco.gitbook.io/coindisco/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coindisco.gitbook.io/coindisco/white-label-api/transaction-limits.md).

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

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

```json
{
  "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

```bash
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'
```

```json
[
  {
    "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

```bash
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.

```json
[
  {
    "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.