LCX Liberty. American DeFi. Your keys. Your assets. Your control.
RWA API
RWA refusals
Every code the RWA API refuses with, and what to do about each.
Codes
A refusal is the API's usual error envelope: success: false, a code and a message. Where a rule refused the quote, refusalReason names it.
| Code | Status | What to do |
|---|---|---|
not_an_rwa | 422 | Neither token is in the RWA registry on that chain. GET /v1/rwa/assets lists them; /v1/quote routes any token. |
no_reference_price | 422 | The RWA token has no live reference price (no feed for it, or its feed has not updated in four days). Set allowUnreferenced: true to take the engine's quote without the check, or wait. |
below_tolerance | 422 | The quote pays further below the reference than maxRefDeviationBps allows. The body carries refDeviationBps and marketOpen. Send a smaller amount, or a wider tolerance (at most 500). |
off_reference | 422 | The market pays more than 3% above the reference for the token you are buying: it trades under what it stands for. Set allowOffReference: true only if you mean to buy it anyway. |
insufficient_liquidity | 422 | refusalReason: below_floor. No route fills this size within the engine's floor. fillsUpTo, when present, is the largest amount that does. |
excluded_coin | 422 | The token is on our exclusion list and is not quoted. |
bad_tolerance | 400 | maxRefDeviationBps must be above 0 and at most 500. |
idempotency_key_reused | 422 | The Idempotency-Key was used with a different request body. Use a new key for a new request. |