# errors

> the errors the copy.top REST API and MCP server can return, and what to do about each one.

| 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.

---
html: https://copy.top/docs/errors · all docs: https://copy.top/docs.md · copy.top is independent: not affiliated with fomo, pump.fun or Hyperliquid. the API is read-only: nothing here places an order. figures are data, not advice. trading crypto is risky and past performance does not predict results.
