Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dynamic.xyz/docs/llms.txt

Use this file to discover all available pages before exploring further.

Dynamic enforces rate limits based upon IP address, project environment, and certain endpoints to protect against attacks and to prevent abuse of Dynamic’s platform. These limits are subject to change.

Errors

Requests returning a 429 status code have been rate limited.
{
  "message": "Rate limit exceeded",
  "code": 429
}

Rate limit categories

  • IP-based rate limits
  • Project environment-based rate limits
  • Endpoint-based rate limits

SDK rate limits

All endpoints used by the SDK prefixed by /sdk are subject to the following limits.
  • 100 requests per minute per IP
  • 10000 requests per minute per project environment

In addition the following endpoints have these limits

EndpointRate LimitPathsLimited by
Nonce10 requests per 1 minute/:environmentId/nonceIP Address
Connect10 requests per 1 minute/:environmentId/connectIP Address
Signin10 requests per 1 minute/:environmentId/verify
/:environmentId/emailVerifications/signin
/:environmentId/smsVerifications/signin
/:environmentId/providers/:providerType/signin
/:environmentId/telegram/signin
/:environmentId/farcaster/signin
/:environmentId/externalAuth/signin
IP Address
OTP3 requests per 1 minute/:environmentId/emailVerifications/create
/:environmentId/emailVerifications/retry
/:environmentId/smsVerifications/create
/:environmentId/smsVerifications/retry
IP Address
MFA5 requests per 1 minute/:environmentId/users/mfa/register/totp
/:environmentId/users/mfa/auth/totp
/:environmentId/users/mfa/register/passkey
/:environmentId/users/mfa/auth/passkey
/:environmentId/users/mfa/recovery
/:environmentId/users/mfa/auth/recovery
IP Address
Token balances20 requests per 1 minute/:environmentId/chains/:chainName/balancesIP Address
Embedded wallets (v2)20 requests per 1 minute/:environmentId/users/embeddedWallets
/:environmentId/users/embeddedWallets/walletAccounts
/:environmentId/users/embeddedWallets/sessionKey
IP Address
Update user5 requests per 1 minute/:environmentId/usersIP Address, User
Delete user2 requests per 1 minute/:environmentId/usersIP Address
Embedded Wallet Sign (v3)30 requests per 1 minute/:environmentId/waas/:walletId/signMessageIP Address, User

Server SDK rate limits

Endpoints prefixed by /server are used by server-side SDK clients (for example, the Node SDK constructed with an apiKey). These endpoints are subject to the following limits.
EndpointRate LimitPathsLimited by
Sign message10 requests per second/:environmentId/waas/:walletId/signMessageIP Address
Import private key10 requests per second/:environmentId/waas/privateKey/importIP Address
Refresh10 requests per second/:environmentId/waas/:walletId/refreshIP Address
Reshare10 requests per second/:environmentId/waas/:walletId/reshareIP Address

Developer rate limits

All endpoints used by Developers are subject to the following rate limits.
  • 1500 requests per minute per IP
  • 3000 requests per minute per project environment

In addition the following endpoints have these limits

EndpointRate LimitPathLimited by
Bulk create user150 requests per 1 minute/environments/:environmentId/users/bulkIP Address
Create embedded wallet300 requests per 1 minute/environments/:environmentId/waas/createIP Address
Organization invites20 requests per 1 minute/organizations/:organizationId/invitesIP Address

Webhooks

See webhooks limits for more information.