Skip to content

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.

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.

Replace the base URL:

https://api.vestigelabs.org
https://vestleg.api.nodely.io
Terminal window
# The ALGO price of USDC and the USDC price of goBTC
curl '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);

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.

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 simulate before it’s returned to you.
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.

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

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
Terminal window
# Generate a typed client from the spec
bunx openapi-typescript https://vestleg.api.nodely.io/openapi.json -o vestleg.d.ts
  • Health: curl https://vestleg.api.nodely.io/networks returns the latest indexed round in block and blocks_behind, normally 0.
  • Service status: algonode.betteruptime.com.
  • Questions and bug reports: Discord or Telegram.