Base Earn API Errors

The Base Earn error envelope includes errorType, errorMessage, and correlationId. Include the correlation ID when reporting a failure. Do not sign or submit calls after an API error.

Status Codes

Status	Meaning
`400`	Invalid address, amount, date or missing field; incompatible provider/operation; missing or invalid withdrawal slippage bound.
`403`	The request is not permitted. Check access restrictions for the requested operation.
`404`	Vault, product or endpoint not found. Check the identifier and URL.
`405`	Wrong HTTP method for the route.
`422`	A protocol precondition failed, such as insufficient funds, unavailable liquidity, an unready vault or an immature claim.
`429`	Rate limited. Reduce request frequency, respect any retry guidance in the response, and use backoff.
`500`	The service could not complete the request. Include the correlation ID when contacting support.
`503`	Service temporarily unavailable. Retry with backoff.

Correct validation and protocol errors before retrying. After a failure, inspect the current position and request fresh calls rather than resubmitting an old transaction batch.

Overview

CLIs

Base Chain API

Tokenized Stocks API

Base Earn API

Base Verify API

Migrated Documentation

Status Codes

​Status Codes

Status Codes