ritmex-bot/docs/nado/developer-resources/api/rate-limits.md

Rate limits

Overview

• Nado uses a weight-based rate-limiting system across queries and executes. We limit based on IP address, Wallet address, and a global max # of orders per subaccount per market.
• These limits equally apply to both http requests and Websocket messages.
• Limits are applied on a 1 minute and 10 seconds basis.

Limits

• IP addresses have a max weight limit of 2400 per minute or 400 every 10 seconds applied only to queries.
• Wallet addresses have a max weight limit of 600 per minute or 100 every 10 seconds applied only to executes.
• Users can have up to 500 open orders per subaccount per market.
• Orders have the following additional limits:
  • Place orders (with spot leverage): up to 600 per minute or 100 every 10 seconds across all markets.
  • Place orders (without spot leverage): up to 30 per minute or 5 every 10 seconds across all markets. Note: orders without spot leverage are 20x more expensive to place due to additional health checks needed.
  • Order cancellations: up to 600 per minute or 100 every 10 seconds.

Query Weights

Queries are rate-limited based on IP. The following weights are applied per query:

• Status: IP weight = 1
• Contracts: IP weight = 1
• Nonces: IP weight = 2
• Order: IP weight = 1
• Orders: IP weight = 2 * product_ids.length
• Subaccount Info: IP weight = 2 (or 10 with txns, or 15 with txns + pre_state="true")
• Isolated Positions: IP weight = 10
• Market Liquidity: IP weight = 1
• Symbols: IP weight = 2
• All Products: IP weight = 5
• Edge All Products: IP weight = 5
• Market Prices: IP weight = product_ids.length
• Max Order Size: IP weight = 5
• Max Withdrawable: IP weight = 5
• Max NLP Mintable: IP weight = 20
• Max NLP Burnable: IP weight = 20
• NLP Pool Info: IP weight = 20
• NLP Locked Balances: IP weight = 20
• Health Groups: IP weight = 2
• Linked Signer: IP weight = 5
• Insurance: IP weight = 2
• Fee Rates: IP weight = 2
• Assets: IP weight = 2
• Orderbook: IP weight = 1

Archive (indexer) Weights

• Archive (indexer) queries are rate-limited based on IP.
• IP addresses have a max weight limit of 2400 per minute or 400 every 10 seconds.

The following weights are applied per query:

• Orders: IP Weight = 2 + (limit * subaccounts.length / 20); where limit and subaccounts are query params.
• Matches: IP Weight = 2 + (limit * subaccounts.length / 10); where limit and subaccounts are query params.
• Events: IP Weight = 2 + (limit * subaccounts.length / 10); where limit and subaccounts are query params.
• Candlesticks: IP Weight = 1 + limit / 20; where limit is a query param.
• Edge Candlesticks: IP Weight = 1 + limit / 20; where limit is a query param.
• Product Snapshots: IP Weight = 10 for single products query, or 10 * timestamps.length for multiple product_snapshots query with max_time parameter
• Funding Rate: IP Weight = 2
• Interest & funding payments: IP Weight = 5
• Oracle Price: IP Weight = 2
• Oracle Snapshots: IP Weight = max((snapshot_count * product_ids.length / 100), 2); where snapshot_count is interval.count.min(500)
• Perp Prices: IP Weight = 2 (includes both single price and multiple perp_prices queries)
• Market Snapshots: IP Weight = max((snapshot_count * product_ids.length / 100), 2); where snapshot_count is interval.count.min(500)
• Edge Market Snapshots: IP weight = (interval.count.min(500) / 20) + (interval.count.clamp(2, 20) * 2)
• Subaccounts: IP Weight = 2
• Subaccount Snapshots: IP Weight = 2 + (limit * subaccounts.length / 10); where limit and subaccounts are query params.
• Linked Signers: IP Weight = 2
• Linked Signer Rate Limit: IP Weight = 2
• Isolated Subaccounts: IP Weight = 2
• Signatures: IP Weight = 2 + len(digests) / 10; where digests is a query param.
• Fast Withdrawal Signature: IP Weight = 10
• NLP Funding Payments: IP Weight = 5
• NLP Interest Payments: IP Weight = 5
• NLP Snapshots: IP Weight = limit.min(500) / 100; where limit is a query param.
• Tx Hashes: IP Weight = idxs.length * 2; where idxs is an array of submission indices (max 100).
• Liquidation Feed: IP Weight = 2
• Sequencer Backlog: IP Weight = 1
• Direct Deposit Address: IP Weight = 10
• Quote Price: IP Weight = 2
• Ink Airdrop: IP Weight = 2

Execute Weights

Executes are rate-limited based on Wallet address. The following weights are applied per execute:

• Place order:
  • With spot leverage: Wallet weight = 1
  • Without spot leverage: Wallet weight = 20
• Place orders:
  • With spot leverage: Wallet weight = 1 per order
  • Without spot leverage: Wallet weight = 20 per order
  • Note: 50ms processing penalty per request
• Cancel orders:
  • When no digests are provided: Wallet weight = 1
  • When digests are provided: Wallet weight = total digests
• Cancel Product Orders:
  • When no productIds are provided: Wallet weight = 50
  • When productIds are provided: Wallet weight = 5 * total productIds
• Cancel And Place:
  • The sum of Cancel orders + Place order limits
• Withdraw Collateral:
  • With spot leverage: Wallet weight = 10
  • Without spot leverage: Wallet weight = 20
• Liquidate Subaccount: Wallet weight = 20
• Mint NLP: Wallet weight = 10
• Burn NLP: Wallet weight = 10
• Link Signer: Wallet weight = 30
  • Can only perform a max of 50 link signer requests every 7 days per subaccount.
• Transfer Quote: Wallet weight = 10
  • Can only transfer to a max of 5 new recipients within 24hrs.

Trigger Service Limits

The trigger service has additional limits specific to conditional orders:

• Pending trigger orders: Max of 25 pending trigger orders per product per subaccount
• TWAP orders: Must use IOC execution type and cannot be combined with isolated margin