Vestige legacy API (drop-in replacement)
Nodely serves the Vestige Labs API 4.x at https://vestleg.api.nodely.io, as a drop-in replacement for the retired Vestige free API. It has the same paths, parameters, field names, protocol ids and error format, so an app that used https://api.vestigelabs.org changes only its base URL. It’s free and needs no API key.
All profit goes to the Algorand fee sink
Section titled “All profit goes to the Algorand fee sink”This is what makes it different. Nodely keeps nothing from this API. The data endpoints are free. The only charges are a small router fee on swaps that have ALGO on one side and, on swaps into ALGO, 50 % of any output above the quote. The router contract pays all of it to the Algorand fee sink, in the same atomic group as the swap.
| Router fee | 0.10 % when the ALGO side is under $1,000, 0.12 % from $1,000. ASA to ASA swaps pay no fee |
| Positive slippage | On a swap into ALGO, 50 % of any output above the quote also goes to the fee sink, and you keep the other 50 %. Into an ASA, all of it is yours |
| Paid to | The fee sink, Y76M3MSY6DKBRHBL7C3NNDXGS5IIMQVQVUAB6MP4XEMMGVF2QWNPL226CA |
| Paid by | The Nodely Router app itself, as an inner payment in your swap. You can see it in every swap group |
| Kept by Nodely | Nothing: no platform fee, no spread, no paid plan |
The fee sink is the protocol account that collects Algorand’s transaction fees and pays block proposers. Router fees paid into it go back to the people who run and secure the network, not to a company.
Quick start
Section titled “Quick start”Replace the base URL:
https://api.vestigelabs.orghttps://vestleg.api.nodely.io# The ALGO price of USDC and the USDC price of goBTCcurl 'https://vestleg.api.nodely.io/assets/price?asset_ids=31566704'curl 'https://vestleg.api.nodely.io/assets/price?asset_ids=386192725&denominating_asset_id=31566704'[{"network_id":0,"asset_id":31566704,"denominating_asset_id":0,"price":12.5721408320605,"confidence":1,"total_lockup":1184193.67574}]const VESTIGE = "https://vestleg.api.nodely.io"; // was https://api.vestigelabs.org
const quote = await fetch(`${VESTIGE}/swap/v4?from_asa=0&to_asa=31566704&amount=100000000&mode=sef`).then((r) => r.json());console.log(quote.amount_out, quote.fee_bps);What it covers
Section titled “What it covers”Every route of Vestige Labs API 4.0.0 answers, on Algorand mainnet (network 0):
| Area | Routes |
|---|---|
| Networks and status | /ping, /networks, /networks/{id}, /usage |
| Protocols and pools | /protocols, /protocols/{id}, /protocols/volume, /pools |
| Assets and prices | /assets, /assets/price, /assets/list, /assets/search |
| Charts | /assets/{id}/history, /assets/{id}/candles, /assets/{id}/composition |
| Trades | /swaps, /marks |
| Wallets | /wallets/{address}/value, /wallets/{address}/pnl |
| Protocol positions | /vaults, /balances |
| Asset notes | /notes, /notes/first, /notes/count |
| Swap aggregator | /swap/v4, POST /swap/v4/transactions, /swap/v4/fee, /swap/v4/history |
Parameters and responses are in the API reference. The quote and transaction flow is in Swap aggregator, and Mainnet routers compared puts the router next to the others on Algorand.
Where the data comes from
Section titled “Where the data comes from”Nothing is proxied from Vestige. Every answer comes from Nodely’s own index of Algorand mainnet:
- Prices, pools, TVL and swaps come from the state of every DEX pool, replayed from on-chain state changes since round 19,247,000 (the same engine as the DEX prices API). Live prices are recomputed at least every 10 seconds.
- Venues: Tinyman 1.0, 1.1 and 2.0, Pact, Pact StableSwap, Algofi, Algofi StableSwap, Humble 1.0 and 2.0, tALGO and xALGO, plus rug.ninja bonding-curve balances and Vestige Vault locks. Nodely also indexes venues Vestige doesn’t have, under protocol ids from 100: Pact weighted (100), Pact concentrated liquidity (101), Biatec (102), LiquiHog (103), Folks lending markets (104) and Lofty OTC (105).
- Asset labels, logos and descriptions keep Vestige’s numeric label ids (0 freeze, 1 clawback, 2 Pera verified, 3 Pera suspicious, 4 Wormhole, 5 and 6 rug.ninja bonding and graduated, 7 no swaps in 7 days, 8 curated pegged and blue chip, 9 ALGO), filled from Pera, Tinyman’s asset list and Nodely’s own labels.
- Quotes and swap transactions come from Nodely’s own router. Every transaction group is checked with algod
simulatebefore it’s returned to you.
Rate limits and caching
Section titled “Rate limits and caching”| Limit | About 120 requests a minute per IP (2 per second, bursts up to 180), the same as Vestige’s keyless limit. POST /swap/v4/transactions allows bursts of 20. Over the limit you get 429 |
/wallets/{address}/value |
At most 5 valuations run at once; each address is cached for 60 seconds |
| Cached routes | History, candles, composition, protocol volume and the asset list are cached by Cloudflare for up to a minute (see Cache-Control). Prices, quotes, swaps and /networks are never cached |
| Errors | FastAPI style, as Vestige: {"detail": ...}, 422 for a bad parameter, 404 for an unknown path or id |
Need more? Contact sales@nodely.io about a dedicated instance.
Differences by design
Section titled “Differences by design”Nodely matched Vestige’s answers endpoint by endpoint, against Vestige’s own API, on 2026-11-15. All 23 compared requests return the same status codes and fields. The values below differ on purpose:
| Field | Nodely |
|---|---|
Pool id |
The pool’s app id (the LP token id for Tinyman 2.0), not Vestige’s internal numbering |
| ALGO values (TVL, volume, wallet value) | Priced with Nodely’s prices. Vestige’s own price model can’t be reproduced, so values can differ by a few percent. Folks fAssets are priced (Vestige leaves them at 0) |
total_lockup of ALGO |
ALGO in live AMM pools only (Vestige counts more than pool reserves for ALGO) |
confidence |
Routed liquidity L in USD, as L / (L + 1000) |
Note offset |
round << 16 | intra: same order as Vestige’s transaction counter, other numbers |
views1h, views1d |
Always 0: they were Vestige’s website traffic |
/usage |
This instance’s request counts per route. There are no API keys, so api_keys is empty |
/swap/v4/fee |
bps_fee is 0: in Vestige’s unit it is the share of positive slippage the aggregator keeps for its operator, and Nodely keeps none (on swaps into ALGO half goes to the fee sink instead). The router fee is in the added router_fee_bps fields (details) |
/swap/v4/history |
Swaps made through the Nodely Router |
OpenAPI and LLM docs
Section titled “OpenAPI and LLM docs”The API describes itself, so code generators and AI agents can use it without these pages:
| URL | What it is |
|---|---|
/openapi.json |
OpenAPI 3.1 description of every route, with parameters, response schemas and the conventions above |
/llms.txt |
Short llms.txt index: what the API is, its conventions and one line per endpoint |
/llms-full.txt |
Every endpoint in full, in Markdown, for an LLM’s context |
/docs |
Redirects to these pages |
# Generate a typed client from the specbunx openapi-typescript https://vestleg.api.nodely.io/openapi.json -o vestleg.d.tsStatus
Section titled “Status”- Health:
curl https://vestleg.api.nodely.io/networksreturns the latest indexed round inblockandblocks_behind, normally 0. - Service status: algonode.betteruptime.com.
- Questions and bug reports: Discord or Telegram.