On This Page
Reference
Errors & Limits
Understand request limits, identify errors, and know when to retry.
Request Limits
- Default Allowance
- 500 requests per account per UTC day, shared across API keys and connected apps.
- Your Limit
- Check Developer Settings for your account's current allowance and usage.
- Rate Limited
- An HTTP
429response includesRetry-After. Wait for that period before retrying.
Status Codes
| Status | Meaning | What to Do |
|---|---|---|
400 | Something in the request is malformed. | Fix the named parameter and try again. |
401 | The key is missing or invalid. | Check the Authorization header and confirm the key is valid and has not expired or been revoked. |
403 | This key is not enabled, or it may not call this route. | Access is invite-only for now. DM @traded_gg on X with the email or wallet you use on traded.gg. |
404 | The path does not exist, or an observation read found no rows. | Check the path and the card ID. ID resolution itself answers 200 with a per-id status or a not_found list. |
422 | A parameter value is outside the contract: unknown metric, window, marketplace, or grade, or an axis the metric does not support. | Read the valid values from the error message or the metric catalog and try again. |
429 | You hit the daily request limit. | Wait for Retry-After, then retry. |
5xx | Something failed on our side. | Wait a moment and retry. |
- Status
400- Meaning
- Something in the request is malformed.
- What to Do
- Fix the named parameter and try again.
- Status
401- Meaning
- The key is missing or invalid.
- What to Do
- Check the Authorization header and confirm the key is valid and has not expired or been revoked.
- Status
403- Meaning
- This key is not enabled, or it may not call this route.
- What to Do
- Access is invite-only for now. DM @traded_gg on X with the email or wallet you use on traded.gg.
- Status
404- Meaning
- The path does not exist, or an observation read found no rows.
- What to Do
- Check the path and the card ID. ID resolution itself answers 200 with a per-id status or a not_found list.
- Status
422- Meaning
- A parameter value is outside the contract: unknown metric, window, marketplace, or grade, or an axis the metric does not support.
- What to Do
- Read the valid values from the error message or the metric catalog and try again.
- Status
429- Meaning
- You hit the daily request limit.
- What to Do
- Wait for Retry-After, then retry.
- Status
5xx- Meaning
- Something failed on our side.
- What to Do
- Wait a moment and retry.
Setting up access? Start with the Quick Start or Connect an Agent.