Updating Quotas

Manage collateral quotas for quoted tokens.

For SDK implementation, see Updating Quotas.

Why

Quotas are required for non-underlying tokens to count as collateral:

  • Enable collateral - Purchase quota to enable a token as collateral

  • Increase exposure - Raise quota limit to hold more of a token

  • Reduce fees - Lower quota to reduce ongoing quota fees

  • Disable collateral - Set quota to zero to disable token

Without a quota, holding a token on a Credit Account with debt risks losing it to liquidators since it doesn't count toward your health factor.

What

updateQuota changes the quota for a specific token. On execution:

  1. Quota change is applied (can be positive or negative)

  2. If quota goes from zero to positive, token is enabled as collateral

  3. If quota goes to zero, token is disabled as collateral

  4. Quota fees are applied based on the change

Parameter
Type
Description

token

address

The quoted token (cannot be underlying)

quotaChange

int96

Delta in underlying units (negative to reduce)

minQuota

uint96

Minimum resulting quota to not revert

How

Enable a Token as Collateral

Increase Existing Quota

Decrease Quota

Disable Token Completely

Use type(int96).min to fully disable:

Combined: Add Token + Set Quota

When adding a quoted token as collateral, always pair with quota update:

Gotchas

Account Must Have Debt

Quotas can only be updated when the account has non-zero debt:

For zero-debt accounts, first borrow, then update quotas.

Forbidden Tokens Cannot Increase

If a token is forbidden, you cannot increase its quota:

Quota Limits

Each market has per-account quota limits:

Quota Fees

Quotas incur ongoing fees:

  • Increase fee: One-time fee on quota increase

  • Quota rate: Ongoing rate (similar to interest) on quota amount

Check rates before setting large quotas:

minQuota Parameter

Use minQuota to prevent front-running:

Zero Debt Closure Requirement

Before closing with zero debt, all quotas must be disabled:

See Also

Last updated