Error Codes

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

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.

Start Here

Security Model

Nova Bridge

Token & Wallet Intelligence

Monitoring

Safe Use

iOS Wallet

Client Errors

Rate Limiting

Disabled Or Not Found

Upstream Or Capability Errors

Server Errors

Safe Inputs

​Client Errors

​Rate Limiting

​Disabled Or Not Found

​Upstream Or Capability Errors

​Server Errors

​Safe Inputs

Client Errors

Rate Limiting

Disabled Or Not Found

Upstream Or Capability Errors

Server Errors

Safe Inputs