Three layers of rate limiting apply to every embed request. All three must pass.

IP limit

5 requests per minute per IP. Applies to everyone, regardless of API key.

Returns 429 with RATE_LIMITED.

Mint cooldown

30 seconds between scans of the same token per org. Prevents hammering the same address. Cache hits aren't affected by this.

Returns 429 with EMBED_MINT_COOLDOWN.

Org usage limits

Your org has daily and monthly request caps set during onboarding. Only fresh scans count against these. Cached results are free.

Returns 429 with EMBED_QUOTA_EXCEEDED when exceeded.

Contact payments@solscanner.app for limit details or adjustments.

Error examples

{ "error": "Too many requests", "code": "RATE_LIMITED" }

{ "error": "Scan cooldown: 18s remaining", "code": "EMBED_MINT_COOLDOWN" }

{ "error": "Embed quota exceeded", "code": "EMBED_QUOTA_EXCEEDED" }

Caching

Scans are cached for 1 hour with up to 3 versions per token. Within that window, requests return cached data instantly. After the cache expires, the next request runs a fresh scan.

Checking your usage

Contact us for current stats, or request admin dashboard access to see real-time numbers: daily/monthly usage vs limits, top mints, top domains.