marketplace-rate-limiting

Configure retry logic with exponential backoff for VTEX marketplace API calls.

39|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/vtexdocs/ai-skills --skill marketplace-rate-limiting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: marketplace-rate-limiting
Source: https://github.com/vtexdocs/ai-skills/tree/main/tracks/marketplace/skills/marketplace-rate-limiting
Command: npx skills add https://github.com/vtexdocs/ai-skills --skill marketplace-rate-limiting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rate-limiting and resilience challenges arise when VTEX marketplace integrations call VTEX APIs, risking dropped requests and degraded throughput. This Skill provides structured patterns to manage load, implement robust retries, and maintain high availability across marketplace operations.

Core Features & Use Cases

  • Exponential backoff with jitter on 429 responses to prevent thundering herd and burst traffic.
  • Circuit breakers and request queuing to regulate throughput and protect downstream services.
  • Proactive rate-limit awareness by reading VTEX headers such as X-RateLimit-Remaining and X-RateLimit-Reset and honoring Retry-After when available.
  • No tight retry loops and safe fallbacks to maintain high availability.
  • Use cases include high-volume catalog updates, pricing/inventory updates, and order-related integrations in VTEX marketplace.

Quick Start

Configure and run the rate-limited HTTP client to begin handling VTEX marketplace API calls with exponential backoff and queueing.

Frequently Asked Questions about marketplace-rate-limiting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle VTEX API rate limits and 429 errors in marketplace integrations?

Handle VTEX API rate limits by implementing exponential backoff with jitter on 429 responses and honoring Retry-After headers. This prevents thundering herd behavior and avoids dropped requests during high-volume marketplace operations.

What is exponential backoff with jitter for API retry logic?

Exponential backoff with jitter is a retry mechanism that progressively increases wait times between failed VTEX API requests while adding randomization. This prevents tight retry loops and burst traffic during rate-limited marketplace operations.

How do I read VTEX rate-limit headers to proactively manage API throughput?

Read VTEX rate-limit headers like X-RateLimit-Remaining and X-RateLimit-Reset to proactively monitor API throughput capacity. This allows your HTTP client to adjust request timing before hitting hard limits.

Can I use a circuit breaker with VTEX marketplace API calls to protect downstream services?

Yes, a configurable circuit breaker can be applied to VTEX marketplace API calls to regulate request throughput and protect downstream services. It works alongside request queuing to maintain high availability during traffic spikes.

What's the best way to manage request throughput for high-volume VTEX catalog and pricing updates?

Manage request throughput for high-volume VTEX catalog and pricing updates using a configurable rate-limited HTTP client with optional circuit-breaker and queuing. This ensures safe fallbacks and prevents degraded throughput.

Why does my VTEX marketplace integration drop requests during high traffic periods?

VTEX marketplace integrations drop requests during high traffic when tight retry loops overwhelm rate limits. Implementing backoff, rate-limit header awareness, and request queuing resolves this by managing load and maintaining availability.