Errors and limits
Every error says what went wrong and what to do next. Errors and empty answers are free.
Status codes
| Status | Meaning | What to do |
|---|---|---|
| 200 | Answered | Read the response and any message it provides. An empty answer leaves your allowance unchanged |
| 400 | Invalid request | Fix the parameter the message names. Unknown parameters are refused, not ignored |
| 401 | Missing or invalid API key | Check the Authorization header and that the key isn't revoked |
| 402 | No eligible plan or request allowance exhausted | Start a trial or subscription, wait for the allowance to reset, or switch to a plan with a higher limit |
| 403 | API access suspended | Contact support |
| 404 | The identifier matches nothing or is ambiguous | Follow the message, such as using TSCO:LN instead of TSCO
|
| 429 | Rate limit exceeded | Wait the seconds in Retry-After, then retry |
| 500 | Internal error | Retrying the same request is unlikely to help. The error is reported; contact support if it persists |
| 503 | Data couldn't be loaded right now | Wait the seconds in Retry-After when present, otherwise retry later with exponential backoff |
An error includes an error message. Identifier lookups include match when Crosswalk supplies an outcome. not_found and ambiguous return 404. found and no_financial_data can return a free 200 with an empty collection.
{ "error": "Nothing matches “ZZZZ”. Check the identifier, or use an ISIN or an exchange-qualified ticker (such as AAPL:US or TSCO:LN).", "match": "not_found" }
Rate limits
Your plan allows a number of requests a minute across all your keys and AI assistants: from 120 on Starter to 600 on Scale (see pricing). Requests over it get a 429 with Retry-After, and aren't counted.
Monthly request limit
Answers with data share one allowance across the REST API and MCP. Once you reach the allowance, requests pause until it resets or you switch to a plan with a higher limit. Check usage and billing for details.
Usage headers
| Header | Meaning |
|---|---|
X-Usage-Used |
Requests counted this billing period, this one included |
X-Usage-Included |
Requests your plan includes each period |
X-RateLimit-Limit |
Requests allowed a minute |