INVALID_REQUEST | 400 | A field failed validation, or RAVN doesn’t swap this pair (for example BTC to BTC) | Read details.fieldErrors and fix the named fields, or change the pair |
UNSUPPORTED_TOKEN | 400 | The token isn’t valid on that chain | Check the address and chain ID |
QUOTE_INVALID | 400 | The quoteToken is malformed or altered | Pass it exactly as received, or quote again |
QUOTE_NOT_EXECUTABLE | 400 | The quote was a preview (executable: false) | Quote again with the addresses in details.missing |
UNAUTHORIZED | 401 | The x-api-key doesn’t exist | Fix the key, or send none |
FORBIDDEN | 403 | A public key where the secret key is needed, or a site outside allowedOrigins | Use the secret key from your server, or add the site |
NO_LIQUIDITY | 404 | No venue can serve this pair or amount | See below |
NOT_FOUND | 404 | No such resource for this caller | Check the path, and that the field applies to your key type |
QUOTE_EXPIRED | 410 | The quote is too old, or re-priced below its minimum | Quote again |
ORDER_REJECTED | 422 | The venue or Solana refused a submitted order or transaction | Read message. A duplicate-order refusal means an earlier submit went through: don’t sign again. Otherwise execute or quote again |
RATE_LIMITED | 429 | Over your rate limit | Wait details.retryAfterSec. A key raises the limit |
INTERNAL | 500 | An unexpected or venue-side error | Retry. If it persists, contact support with the requestId |
BUILD_FAILED | 502 | The venue couldn’t build or take the swap right now | On /execute: quote again. On a submit: check before signing again |
VENUE_RATE_LIMITED | 503 | The venue is rate-limiting RAVN | Retry the same call after details.retryAfterSec |
UNAVAILABLE | 503 | RAVN can’t check keys or look up the quote for a moment | Retry the same call after details.retryAfterSec |
NOT_CONFIGURED | 503 | The endpoint isn’t enabled yet (for example x402) | Use the free endpoints |