Skip to main content

​
How Rhino.fi limits work

Rhino.fi supports enterprise-grade volumes and values, and can work with you to make sure the limits on your account match your expected transaction activity. With the Advanced Fee & Limit Management extension, you can view these limits. We’re always happy to discuss raising them so your service is never interrupted.

​
Trial and subscription limits

Your limits depend on your account type. Trial accounts have fixed limits for testing, which don’t reflect production. Subscription accounts have production limits that depend on your plan. See Trial accounts: what’s included and how it differs from a subscription for the current limits of each. Several kinds of limits can apply to your Rhino.fi activity.

​
Smart Deposit Address limits

  • Generated SDAs. Your subscription plan, or your trial account, sets the maximum number of Smart Deposit Addresses (SDAs) you can create. Your current usage against this maximum is returned by the rate limit usage endpoint (GET /sda/deposit-addresses/rate-limit-status), and is shown in the Rhino.fi Console under Settings → Usage.
  • Generation windows. There may also be limits on how many SDAs you can create in a given period, such as an hour or a day. Where these apply, they are also returned by the rate limit usage endpoint.
  • Minimum and maximum deposit. The minimum and maximum USD amount an SDA can receive, set per project. You can find them in the SDA limits section of Advanced Fee & Limit Management in the Console, or ask your Rhino.fi account manager.

​
Bridge and bridge+swap limits

To avoid transactions whose value falls below the onchain costs, Rhino.fi sets a minimum deposit amount per token, per chain. For most clients and their end customers, this is well below the amounts they transact. If some of your transactions may fall close to or below it, contact your account manager: we may be able to set custom minimums for your account.
Transactions below the minimum amount are not processed.
Rhino.fi also sets a maximum USD amount per token, per chain that can be bridged or bridge+swapped, to keep settlement times fast. You can find the limits for a specific token on a specific chain with the token config endpoint (GET /bridge/config/{chain}/{token}). If you need to send larger transactions, contact your account manager: we can set higher limits for your account.
Transactions above the maximum amount are not processed.
When you request a quote with POST /bridge/quote/bridge-swap/user, the response tells you if the transaction would fail because the amount is outside these limits. See Errors for the error names.

​
1:1 Stablecoin Settlement limits

Deposits on 1:1 Stablecoin Settlement routes follow the same limits as standard SDA deposits. For very large single transactions (above $1M USD equivalent), contact your account manager to confirm available liquidity. Volume-based limits also apply, to protect your app from abuse. They can be customized case by case:
  • Account-level limit: the total 1:1 volume across all transactions within a set number of days.
  • Recipient-level limit: the total 1:1 volume for a single recipient.
When a limit is reached, transactions fall back to the market rate. If a single recipient reaches their limit, only that recipient’s transactions fall back. For prospects testing the Rhino.fi Stablecoin Activation Stack, and for clients who want lower limits during integration testing, these limits can be lowered temporarily. Contact your account manager to discuss your needs. For more on the extension, see 1:1 Stablecoin Settlement.