Errors
Every error has a stable code and a short message written so your AI can repeat it to the user word for word.
Format
Errors use HTTP status codes plus a JSON body.
{
"error": {
"code": "TOKEN_HIGH_RISK",
"message": "KITTY scored 12/100: High risk: A test wallet could buy but not sell. I won't buy it.",
"hint": "Run check_token for the full report."
}
}Common codes
The codes you are most likely to see.
TOKEN_HIGH_RISK422Scan score below 50.
TOKEN_NEEDS_CONFIRMATION422Caution band: confirm and retry with allowRisk.
NON_CANONICAL_STOCK422Address is not a published stock token.
PRICE_IMPACT_TOO_HIGH409Impact above 2%: confirm and retry.
NO_ROUTE422No liquidity for this pair.
RESERVED_TICKER422Ticker belongs to a listed asset.
QUOTA_EXCEEDED429Monthly calls used up.
RATE_LIMITED429Slow down and retry later.