Error codes
The API uses standard HTTP status codes. Each error body follows a consistent JSON schema with a machine-readable type plus a human-readable message.
Error structure
{{
"error": "<machine_readable_type>",
"message": "<human_readable>",
"details": {{ ... }}
}}Common codes
| Status | Type | Suggested action |
|---|---|---|
| 400 | bad_request | Validate inputs. |
| 401 | unauthorized | Missing / invalid / revoked key. |
| 403 | tier_denied | Endpoint above the current tier. |
| 404 | not_found | Resource does not exist. |
| 429 | rate_limited | Honor Retry-After. |
| 5xx | server_error | Retry with back-off ; contact support if persistent. |
Institutional disclaimer
Trinity Insights is an educational and analytical tool. Content does not constitute investment advice. Trinity Insights is not a Crypto-Asset Service Provider (CASP) registered under MiCA Regulation (EU) 2023/1114, nor a Financial Investment Advisor (CIF), nor a PSAN. See the full disclaimer.