Skip to content

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
Esc

Documentation

Make your first request API keys and authentication Errors and limits Connect an AI assistant (MCP) Usage and billing Contact support Get company profile Get securities and listings Get reported earnings Get financial statements Get historical financial metrics Get financial segments Get historical shares outstanding Get fund holdings Find funds holding a security Screen companies Get screener filters
↑↓ to move to open