Skip to main content

​
API Status Codes

The status codes returned by the API are the same as the HTTP status codes, like 200, 400, 500, etc. Don’t know about http status codes?

​
Custom Error Codes by hydric

for every error, hydric returns a custom code to make it easier to handle custom errors in your side. for example LIQUIDITY_POOL_NOT_FOUND. Below you can see the exhaustive list of hydric error codes:
Error CodeStatusTitleDescription
API_KEY_DISABLED403Authentication FailedThe provided API key exists but is disabled.
API_KEY_EXPIRED403Authentication FailedThe provided API key exists but has expired.
API_KEY_INVALID401Authentication FailedThe provided API key is not valid.
API_KEY_MISSING401Authentication FailedThe request lacks an API key. Provide one in the Authorization header.
API_KEY_NOT_FOUND401Authentication FailedThe provided API key does not exist.
INVALID_BASKET_ID400Invalid ParametersThe provided basket identifier is not one of the supported ones.
INVALID_BLOCKCHAIN_ADDRESS400Invalid ParametersThe provided blockchain identity (address/chain id pair) is malformed or refers to an unsupported network.
INVALID_PAGINATION_CURSOR400Invalid ParametersThe pagination cursor is malformed or has expired. Request a new starting page to reset.
INVALID_POOL_ADDRESS400Invalid ParametersThe provided pool address is syntactically invalid or does not match the expected format for the target blockchain
INVALID_PROTOCOL_ID400Invalid ParametersThe protocol identifier is not recognized. Protocol IDs must match the hydric slug format (e.g., uniswap-v3).
LIQUIDITY_POOL_NOT_FOUND404Not FoundThe requested liquidity pool could not be found. This may occur if the pool is not yet indexed or the address is incorrect for the specified network.
RATE_LIMIT_EXCEEDED429Rate Limit ExceededYou have exceeded the maximum number of requests allowed within the time window. Please wait and retry after the specified duration.
ROUTE_NOT_FOUND404Route Not FoundThe requested endpoint does not exist. Please refer to the hydric API reference for valid routes.
TOKEN_BASKET_NOT_FOUND404Not FoundThe requested token basket could not be found.
TOKEN_NOT_FOUND404Not FoundThe requested token could not be located. Ensure the token address and chain ID are correct.
UNKNOWN_ERROR500Unknown ErrorAn internal server error occurred. Please try again later.
UNSUPPORTED_CHAIN_ID400Invalid Parametershydric does not currently support or index the provided Chain ID
VALIDATION_ERROR400Invalid ParametersThe request payload contains invalid data types or malformed parameters