The rug can hide in the hop, not the token.

quote_amm prices one direct AMM pool. Real swaps route through order books, AMMs, and multiple hops — and a clean-looking token reached by rippling through a gateway that can freeze or claw back the currency mid-route is a trap a destination-only check never sees. This asks the ledger for the actual payment paths, picks the cheapest for the amount you want, and runs the rug-safety engine over every issuer and gateway the route touches.

MCP tool: find_best_path Price: $0.006 / call

Parameters

ParamDescription
to_currencytoken to acquire — 3-char or 40-char hex
to_issuerissuer of the token to acquire (r...)
to_amounthow much to acquire (default 100)
from_currencywhat you spend (default XRP)
from_issuerissuer of from_currency, if not XRP
accountyour wallet, for routes specific to your trustlines (optional)

Example

Call (MCP tools/call arguments):

{
  "to_currency": "534F4C4F00000000000000000000000000000000",
  "to_issuer": "rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz",
  "to_amount": 100
}

Result:

{
  "ok": true,
  "verdict": "route_safe",
  "confidence": "high",
  "best_route": {
    "source_cost": 1.452414,
    "source_unit": "XRP",
    "effective_price": 0.01452414,
    "hops": 1
  },
  "routes_available": 1,
  "hops_screened": [
    {
      "address": "rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz",
      "risk": "ok",
      "flags": []
    }
  ],
  "reasons": [
    "cheapest route: 1.452414 XRP for 100 SOLO, 1 hop(s), 1 route(s)"
  ]
}

FAQ

How is this different from a normal swap quote?

A quote prices a single, direct pool. find_best_path asks the XRP Ledger for the real set of payment paths — which can cross order books, AMMs, and multiple currencies — picks the cheapest for your amount, and then screens the safety of every issuer and gateway on that route. It answers 'what's the best way to execute this, and is the whole route safe?', not just 'what's the price here?'.

How can a route be unsafe if the token is fine?

To reach some tokens you ripple through an intermediary gateway's currency. If that gateway can freeze balances or claw them back, it can trap or seize your funds mid-swap — even though the token you set out to buy looks clean. This tool flags clawback, global freeze, mintable (non-blackholed) issuers, and blocklisted addresses anywhere on the route.

Do I need to pass my wallet address?

No. Without an account it returns an indicative route probed from live holders of the token. Pass your account for routes specific to your own trustlines — useful when you already hold intermediary currencies or need to know whether you must set a trustline first.

Why might it return no_route?

Either the token has no executable liquidity against what you're spending, or (for a non-XRP source) you'd need a trustline first. A missing route is reported honestly rather than as a guess.

Connect via MCP at https://cerberusindex.com/mcp — see the quickstart. Payment is automatic for x402-aware clients. Verdicts are informational risk signals, not financial advice.