Get crypto withdrawal limits

[GET] /api/v2/merchant-balance/withdrawal/limits

Returns the authoritative min and max values for a withdrawal to the selected (network, asset) pair.

Values are already tightened by your resolved limit rules.

The deposit leg is the USD deducted from your balance.

The payout leg is the crypto you receive.

Request query params type:

type QueryParams = {
  network: string;   // e.g. "CELO"
  asset: string;     // e.g. "USDC"
}

Request URL example:

GET /api/v2/merchant-balance/withdrawal/limits?network=CELO&asset=USDC

Response type:

type Response = {
  deposit: {           // the USD deducted from your balance
    min: number;
    max: number;
    minUsd: number;
    maxUsd: number;
    step: number;
    supportsDecimals: boolean;
  };
  payout: {            // the crypto you receive
    min: number;
    max: number;
    minUsd: number;
    maxUsd: number;
    step: number;
    supportsDecimals: boolean;
  };
}

Response example:

{
  "deposit": {
    "min": 5,
    "max": 10000,
    "minUsd": 5,
    "maxUsd": 10000,
    "step": 0.01,
    "supportsDecimals": true
  },
  "payout": {
    "min": 5,
    "max": 10000,
    "minUsd": 5,
    "maxUsd": 10000,
    "step": 0.000001,
    "supportsDecimals": true
  }
}

Those figures are the treasury per-transaction rule that applies to every account today — see Merchant balance. A given pair can come back narrower, and the separate $10,000-a-month withdrawal cap is not reflected here: this endpoint answers "what may one withdrawal be", not "how much is left this month". Get limits answers the second question.