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

# Error Codes

> Common Nova public API error codes and response format

Nova public API errors use a consistent envelope:

```json theme={"dark"}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Please retry later."
  }
}
```

Some errors also include `requestId` when an upstream provider or internal request id is available.

## Client Errors

| Code                      | HTTP | Description                                                                                                                        |
| ------------------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------- |
| INVALID\_REQUEST          | 400  | Invalid or missing request parameters.                                                                                             |
| SECRET\_FIELD\_DISALLOWED | 400  | Public requests cannot include private keys, seed phrases, passcodes, backup codes, signing payloads, or raw transaction payloads. |

## Rate Limiting

| Code          | HTTP | Description                                                         |
| ------------- | ---- | ------------------------------------------------------------------- |
| RATE\_LIMITED | 429  | Too many requests. Retry after the public rate-limit window resets. |

## Disabled Or Not Found

| Code                    | HTTP | Description                                                                  |
| ----------------------- | ---- | ---------------------------------------------------------------------------- |
| NOT\_FOUND              | 404  | Route not found on the Nova public API.                                      |
| PUBLIC\_NYOMI\_DISABLED | 410  | The public Nyomi API is disabled while agentic runtime ownership is rebuilt. |
| AGENTIC\_V1\_DISABLED   | 410  | Legacy `/v1/chat/*` and `/v1/agent/*` routes are disabled.                   |

## Upstream Or Capability Errors

| Code                             | HTTP | Description                                         |
| -------------------------------- | ---- | --------------------------------------------------- |
| BRIDGE\_ROUTE\_UNAVAILABLE       | 503  | Nova Bridge could not build the requested route.    |
| BRIDGE\_STATUS\_UNAVAILABLE      | 503  | Nova Bridge status could not be loaded.             |
| TOKEN\_RISK\_UNAVAILABLE         | 503  | Token risk data is temporarily unavailable.         |
| TOKEN\_SEARCH\_UNAVAILABLE       | 503  | Token search is temporarily unavailable.            |
| TRENDING\_TOKENS\_UNAVAILABLE    | 503  | Trending token data is temporarily unavailable.     |
| TOKEN\_DETAILS\_UNAVAILABLE      | 503  | Token profile data is temporarily unavailable.      |
| TOKEN\_PRICES\_UNAVAILABLE       | 503  | Token price data is temporarily unavailable.        |
| TOKEN\_CHART\_UNAVAILABLE        | 503  | Token chart data is temporarily unavailable.        |
| WALLET\_OVERVIEW\_UNAVAILABLE    | 503  | Wallet overview data is temporarily unavailable.    |
| WALLET\_TOKENS\_UNAVAILABLE      | 503  | Wallet token holdings are temporarily unavailable.  |
| WALLET\_TRADES\_UNAVAILABLE      | 503  | Wallet trade history is temporarily unavailable.    |
| WALLET\_ACTIVITY\_UNAVAILABLE    | 503  | Wallet activity is temporarily unavailable.         |
| TRADER\_LEADERBOARD\_UNAVAILABLE | 503  | Trader leaderboard data is temporarily unavailable. |
| TRADE\_FEED\_UNAVAILABLE         | 503  | Trade feed data is temporarily unavailable.         |
| TOKEN\_SIGNALS\_UNAVAILABLE      | 503  | Token signal data is temporarily unavailable.       |

## Server Errors

| Code                    | HTTP | Description                                  |
| ----------------------- | ---- | -------------------------------------------- |
| OPENAPI\_UNAVAILABLE    | 500  | The public OpenAPI spec could not be loaded. |
| INTERNAL\_SERVER\_ERROR | 500  | Unhandled server error.                      |

## Safe Inputs

Use public wallet addresses, token mints, transaction signatures, and URLs. Do not send private keys, seed phrases, recovery phrases, passcodes, backup codes, signed transactions, raw transactions, or signing payloads.