'/%3e%3c!--%20Subtle%20grid%20lines%20showing%20assembly%20--%3e%3cline%20x1='64'%20y1='20'%20x2='64'%20y2='108'%20stroke='%234c1d95'%20stroke-width='0.5'%20opacity='0.2'/%3e%3cline%20x1='20'%20y1='64'%20x2='108'%20y2='64'%20stroke='%234c1d95'%20stroke-width='0.5'%20opacity='0.2'/%3e%3c!--%20Piece%201:%20Top-left%20—%20slightly%20offset%20outward%20--%3e%3crect%20x='24'%20y='24'%20width='36'%20height='36'%20rx='6'%20fill='url(%23p1)'%20opacity='0.9'%20transform='translate(-2,%20-2)'/%3e%3c!--%20Piece%202:%20Top-right%20—%20slightly%20offset%20outward%20--%3e%3crect%20x='68'%20y='24'%20width='36'%20height='36'%20rx='6'%20fill='url(%23p2)'%20opacity='0.85'%20transform='translate(2,%20-2)'/%3e%3c!--%20Piece%203:%20Bottom-left%20—%20slightly%20offset%20outward%20--%3e%3crect%20x='24'%20y='68'%20width='36'%20height='36'%20rx='6'%20fill='url(%23p3)'%20opacity='0.8'%20transform='translate(-2,%202)'/%3e%3c!--%20Piece%204:%20Bottom-right%20—%20slightly%20offset%20outward%20--%3e%3crect%20x='68'%20y='68'%20width='36'%20height='36'%20rx='6'%20fill='url(%23p4)'%20opacity='0.85'%20transform='translate(2,%202)'/%3e%3c!--%20Connector%20glow%20at%20center%20where%20pieces%20almost%20meet%20--%3e%3ccircle%20cx='64'%20cy='64'%20r='8'%20fill='%23fff'%20opacity='0.15'/%3e%3ccircle%20cx='64'%20cy='64'%20r='4'%20fill='%23c4b5fd'%20opacity='0.4'/%3e%3c!--%20Edge%20highlights%20—%20light%20seams%20between%20pieces%20--%3e%3cline%20x1='62'%20y1='26'%20x2='62'%20y2='58'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='66'%20y1='26'%20x2='66'%20y2='58'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='62'%20y1='70'%20x2='62'%20y2='102'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='66'%20y1='70'%20x2='66'%20y2='102'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='26'%20y1='62'%20x2='58'%20y2='62'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='26'%20y1='66'%20x2='58'%20y2='66'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='70'%20y1='62'%20x2='102'%20y2='62'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='70'%20y1='66'%20x2='102'%20y2='66'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3c!--%20Floating%20accent%20particles%20--%3e%3ccircle%20cx='18'%20cy='18'%20r='1.2'%20fill='%23a78bfa'%20opacity='0.5'/%3e%3ccircle%20cx='110'%20cy='18'%20r='1'%20fill='%23818cf8'%20opacity='0.4'/%3e%3ccircle%20cx='110'%20cy='110'%20r='1.2'%20fill='%23c4b5fd'%20opacity='0.45'/%3e%3ccircle%20cx='18'%20cy='110'%20r='1'%20fill='%23ddd6fe'%20opacity='0.4'/%3e%3c/svg%3e){kind=small}
Getting Started
Rate Limits
API requests are rate-limited to ensure fair usage and platform stability.
Default Limits
| Scope | Requests / minute |
|---|---|
| All API keys | 60 |
Public API requests are fixed at 60 requests per minute for every Verified level. Limits are applied per API key using a sliding window. Listing creation has an additional limit: 5/hour (Verified Lv.2: 10/hour).
Response Headers
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 |
When Rate Limit is Exceeded
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.