generated: '2026-08-24'
method: searched
source: >-
  https://docs.biconomy.io/overview/supertransaction-api, https://docs.biconomy.io/gasless-apps/sponsorship,
  and a full-text search of the 644 KB https://docs.biconomy.io/llms-full.txt corpus for rate-limit
  language (2026-08-24).
limit_count: 0
published_numeric_limits: false
response_headers:
  documented: false
  observed: false
  x_ratelimit: null
  ratelimit: null
  retry_after: null
  finding: >-
    Biconomy documents NO rate-limit response headers. A search of the complete published
    documentation corpus returns no X-RateLimit-*, no RFC 9331/9440-style RateLimit-*, and no
    Retry-After. The only rate-limit language in the corpus refers to the Usage Limit POLICY on
    Smart Sessions — an on-chain constraint on how often a delegated agent may act — which is a
    different mechanism from transport throttling and must not be read as one. The consequence for
    an agent is that there is no runtime budget signal at all: it cannot know how close it is to a
    limit and can only discover exhaustion by being refused.
  checked: '2026-08-24'
specification: API Commons Rate Limits
specificationVersion: '0.1'
schema: https://raw.githubusercontent.com/api-evangelist/interface-research/main/schema/api-commons.yml#/$defs/RateLimits
provider: Biconomy
providerId: biconomy
created: '2026-05-25'
modified: '2026-05-25'
reconciled: false
tags:
  - Rate Limiting
  - Account Abstraction
  - MEE
description: >-
  Documented rate-limit posture for the Biconomy Supertransaction API.
  Specific quantitative RPS/quota numbers are issued per project from the
  Biconomy Dashboard and are not published as a fixed rate card. Sponsorship
  policy limits (per-tx USD cap, per-user / per-day caps, allowed contracts,
  chain whitelist) are configured per project and enforced before /v1/quote
  returns a sponsored quote.
sources:
  - https://docs.biconomy.io/overview/supertransaction-api
  - https://docs.biconomy.io/gasless-apps/sponsorship
  - https://dashboard.biconomy.io
algorithm: token-bucket
responseCodes:
  throttled: 429
  quotaExceeded: 402
  unauthorized: 401
  forbidden: 403
limits:
  - tier: Developer
    surface: /v1/quote
    rpm: dashboard
    description: Per-API-key request rate on quote composition. Issued from dashboard.biconomy.io.
  - tier: Developer
    surface: /v1/execute
    rpm: dashboard
    description: Per-API-key request rate on supertransaction execution.
  - tier: Sponsorship
    surface: Paymaster
    perTxUsd: dashboard
    perUserDailyUsd: dashboard
    perProjectMonthlyUsd: dashboard
    description: Sponsorship paymaster spend caps configured per project in the dashboard.
notes:
  - Biconomy does not publish a fixed quantitative rate card; limits are issued and adjusted per project from
    the dashboard.
  - 429 responses indicate request-rate throttling; 402 / sponsorship-rejected indicates a spend-cap or policy
    violation rather than a transport rate limit.
  - All sponsorship limits and configurations are managed exclusively through the Biconomy Dashboard, not in
    code.