Overview
This section describes how to handle errors while integrating with the CryptoMate API. Following these conventions will speed up debugging and make support interactions much faster.
Request tracing
Every failing request includes a trace_id in the error response body that uniquely identifies the call. Include it in any support request or troubleshooting conversation — it gives us everything we need to find the failing request and figure out what went wrong.
Failed requests return a JSON object with the following fields:
code — identifies the specific error type.message — human-readable description of the error.trace_id (optional) — unique identifier for the failing request, useful for troubleshooting.
Example
HTTP status codes
trace_id in the Portal
When an action triggered from the Portal fails, the error dialog shows the trace_id alongside the error message so it can be copied and shared for troubleshooting.
Always log the trace_id alongside your own request identifiers. It turns a “the API is broken” ticket into a conversation we can resolve in minutes.
