Skip to main content
Nova public API errors use a consistent envelope: 
{
  "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

CodeHTTPDescription
INVALID_REQUEST400Invalid or missing request parameters.
SECRET_FIELD_DISALLOWED400Public requests cannot include private keys, seed phrases, passcodes, backup codes, signing payloads, or raw transaction payloads.

​
Rate Limiting

CodeHTTPDescription
RATE_LIMITED429Too many requests. Retry after the public rate-limit window resets.

​
Disabled Or Not Found

CodeHTTPDescription
NOT_FOUND404Route not found on the Nova public API.
PUBLIC_NYOMI_DISABLED410The public Nyomi API is disabled while agentic runtime ownership is rebuilt.
AGENTIC_V1_DISABLED410Legacy /v1/chat/* and /v1/agent/* routes are disabled.

​
Upstream Or Capability Errors

CodeHTTPDescription
BRIDGE_ROUTE_UNAVAILABLE503Nova Bridge could not build the requested route.
BRIDGE_STATUS_UNAVAILABLE503Nova Bridge status could not be loaded.
TOKEN_RISK_UNAVAILABLE503Token risk data is temporarily unavailable.
TOKEN_SEARCH_UNAVAILABLE503Token search is temporarily unavailable.
TRENDING_TOKENS_UNAVAILABLE503Trending token data is temporarily unavailable.
TOKEN_DETAILS_UNAVAILABLE503Token profile data is temporarily unavailable.
TOKEN_PRICES_UNAVAILABLE503Token price data is temporarily unavailable.
TOKEN_CHART_UNAVAILABLE503Token chart data is temporarily unavailable.
WALLET_OVERVIEW_UNAVAILABLE503Wallet overview data is temporarily unavailable.
WALLET_TOKENS_UNAVAILABLE503Wallet token holdings are temporarily unavailable.
WALLET_TRADES_UNAVAILABLE503Wallet trade history is temporarily unavailable.
WALLET_ACTIVITY_UNAVAILABLE503Wallet activity is temporarily unavailable.
TRADER_LEADERBOARD_UNAVAILABLE503Trader leaderboard data is temporarily unavailable.
TRADE_FEED_UNAVAILABLE503Trade feed data is temporarily unavailable.
TOKEN_SIGNALS_UNAVAILABLE503Token signal data is temporarily unavailable.

​
Server Errors

CodeHTTPDescription
OPENAPI_UNAVAILABLE500The public OpenAPI spec could not be loaded.
INTERNAL_SERVER_ERROR500Unhandled 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.