| REST status | when | what to do |
|---|---|---|
| 400 | a parameter is missing or out of range | read the error text: it names the parameter |
| 401 | the key is unknown, or the route needs a key | check the key, or create a free one at copy.top/account#api |
| 404 | unknown route, unknown trader or coin | use search to resolve a name first |
| 429 | over a limit | wait the seconds in retry-after |
| 503 | busy, or a read took too long | try again a few seconds later |
over MCP, the same cases come back as a tool result with isError: true and a short sentence that says what to do. JSON-RPC errors (-32600, -32601, -32602) mean the request itself is malformed: one message per request, no batches.
copy.top