API reference / RouteQuote API
RouteQuote API
Best-route DEX quotes on XDC mainnet across XSwap V2/V3, Oku and Curve, from eth_call simulations. Fathom DEX quotes are shown for information only and never chosen as the best route, because Fathom's FXD stablecoin is in emergency shutdown. Data only: no calldata, no execution.
| Base path | https://feedplumb.com/route |
|---|---|
| Authentication | Venues and health: none. Quotes: a DataQuery key (billed from the same credits). |
| Limits | Quotes cached 10 s. |
| Health | /route/health · status page |
GET /route/health
Liveness plus current block.
curl -s https://feedplumb.com/route/healthGET /route/health on this site
GET /route/venues
Venues, contracts, status and the token list (free).
curl -s https://feedplumb.com/route/venues | jq '.venues[] | {id, status}'GET /route/venues on this site
GET /route/quoteauth: DataQuery key
Best route for a swap size (2 credits).
| Parameter | Description |
|---|---|
tokenIn | symbol or address |
tokenOut | symbol or address |
amount | decimal units (or amountIn in raw units) |
curl -s "https://feedplumb.com/route/quote?tokenIn=WXDC&tokenOut=USDC&amount=1000" -H "x-api-key: <key>"Errors
| Status | Meaning |
|---|---|
401 | no key |
402 | out of credits |