Title: Vestige legacy API (drop-in replacement)
Source: https://nodely.io/docs/vestige/

# 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.

<a id="all-profit-goes-to-the-algorand-fee-sink"></a>

## 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`](https://allo.info/account/Y76M3MSY6DKBRHBL7C3NNDXGS5IIMQVQVUAB6MP4XEMMGVF2QWNPL226CA) |
| Paid by | The [Nodely Router](https://nodely.io/docs/vestige/aggregator#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.

<a id="quick-start"></a>

## Quick start

Replace the base URL:

```diff
https://api.vestigelabs.org
https://vestleg.api.nodely.io
```

```bash
# 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'
```

```json
[{"network_id":0,"asset_id":31566704,"denominating_asset_id":0,"price":12.5721408320605,"confidence":1,"total_lockup":1184193.67574}]
```

```js
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);
```

<a id="what-it-covers"></a>

## 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](https://nodely.io/docs/vestige/endpoints). The quote and transaction flow is in [Swap aggregator](https://nodely.io/docs/vestige/aggregator), and [Mainnet routers compared](https://nodely.io/docs/vestige/routers) puts the router next to the others on Algorand.

<a id="where-the-data-comes-from"></a>

## 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](https://nodely.io/docs/x402/prices)). 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.

<a id="rate-limits-and-caching"></a>

## 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](mailto:sales@nodely.io) about a dedicated instance.

<a id="differences-by-design"></a>

## 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](https://nodely.io/docs/vestige/aggregator#get-swapv4fee-and-get-swapv4history)) |
| `/swap/v4/history` | Swaps made through the Nodely Router |

<a id="openapi-and-llm-docs"></a>

## 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`](https://vestleg.api.nodely.io/openapi.json) | OpenAPI 3.1 description of every route, with parameters, response schemas and the conventions above |
| [`/llms.txt`](https://vestleg.api.nodely.io/llms.txt) | Short [llms.txt](https://llmstxt.org/) index: what the API is, its conventions and one line per endpoint |
| [`/llms-full.txt`](https://vestleg.api.nodely.io/llms-full.txt) | Every endpoint in full, in Markdown, for an LLM’s context |
| [`/docs`](https://vestleg.api.nodely.io/docs) | Redirects to these pages |

```bash
# Generate a typed client from the spec
bunx openapi-typescript https://vestleg.api.nodely.io/openapi.json -o vestleg.d.ts
```

<a id="status"></a>

## Status

-   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](https://algonode.betteruptime.com/).
-   Questions and bug reports: [Discord](https://discord.gg/AnH2s9dMkN) or [Telegram](https://t.me/AlgoNode).

Note

Vestige is a trademark of its owners. Nodely is not affiliated with Vestige Labs. This API reproduces the public interface of the retired Vestige free API so that the apps built on it keep working.
