> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bullring.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Stable partner error codes and retry behavior.

THE SIGNAL

Partner errors include a stable `code`:

```json theme={null}
{
  "statusCode": 400,
  "message": "The idempotency ID was already used for a different request",
  "code": "IDEMPOTENCY_CONFLICT"
}
```

Common codes:

| Code | Meaning |
| - | - |
| `AUTHENTICATION_REQUIRED` | Missing key ID or signature credentials |
| `SIGNATURE_INVALID` | Signature does not match the exact request |
| `SIGNING_KEY_UNKNOWN` | Key ID is not active for a partner |
| `TIMESTAMP_EXPIRED` | Timestamp is outside the five-minute window |
| `IDEMPOTENCY_REQUIRED` | Write request omitted an idempotency ID |
| `IDEMPOTENCY_CONFLICT` | ID was reused for a different request |

Retry `5xx` responses and timeouts with the same idempotency ID. Fix `4xx` request errors before retrying.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.