Getting Started

Rate Limits

API requests are rate-limited to ensure fair usage and platform stability.

Default Limits

Plan	Requests / minute
Free	`60`
Verified Lv.2	`300`

Rate limits are applied per API key using a sliding window. Listing creation has an additional limit: 5/hour (Verified Lv.2: 10/hour).

Every API response includes rate limit information in the headers:

Headers

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 54
X-RateLimit-Reset: 1710720000

Header	Description
`X-RateLimit-Limit`	Max requests per window
`X-RateLimit-Remaining`	Remaining requests in current window
`X-RateLimit-Reset`	Unix timestamp when window resets

Requests that exceed the rate limit will receive a 429 Too Many Requests response:

429 Response

{
  "ok": false,
  "error": "Rate limit exceeded",
  "code": "RATE_LIMITED",
  "retryAfter": 32
}

Wait for the number of seconds indicated by retryAfter before making another request.