List yield tokens

Fetch the complete registry of tokenized Overpass wrappers and their latest stats.

GET https://api-v1.overpass.ag/v1/tokens

The endpoint is public and does not require authentication.

Query parameters

Parameter	Type	Required	Description
`protocol`	string	No	Return wrappers for one source protocol, such as `kamino`.
`underlyingMint`	string	No	Return wrappers backed by one underlying token mint.
`limit`	integer	No	Number of wrappers to return. Defaults to `100`; maximum `500`.
`cursor`	string	No	Opaque cursor from the previous response.

Request

Use limit=500 to retrieve the current registry in one request. Continue pagination whenever nextCursor is not null.

curl --get 'https://api-v1.overpass.ag/v1/tokens' \
  --data-urlencode 'limit=500'

Response

{
  "items": [
    {
      "wrapperMint": "HtnnuzVtecjktsUoZjHaZoZ9u4jPAzGpujE82U3v3cAV",
      "wrapperVault": "9iJeZPrNJrBEjj4h7tD9P3hygyM4hpZmyqrQmHjNUpdA",
      "underlyingMint": "So11111111111111111111111111111111111111112",
      "sourcePool": "HaVsdBb4mMoYQ3vnS7wCdvhixg5xFQALmFwyL9QJm3fn",
      "protocol": "kamino",
      "creator": "UserevMsvU5K9u6iW7DT9XJVyVLpmfDCEAfXixBbE7R",
      "creationTimestamp": "2026-05-19T10:46:22.000Z",
      "decimals": 9,
      "underlyingDecimals": 9,
      "name": "SOL in Kamino Sanctum Market",
      "symbol": "infSOL",
      "uri": "https://ipfs.io/ipfs/Qmaph9w7nvQ7D6wsUq4Z8EB3YqurH7b3RsaTbAQtcHs94Z",
      "imageUrl": "https://ipfs.io/ipfs/QmeyFwBddBQZ9hJGu2waW4wPPN2qqyxMApfXXT2VujAfmS",
      "creatorDepositFeeBps": 0,
      "sampledAt": "2026-07-10T00:32:58.000Z",
      "slot": "431906361",
      "underlyingHeldRaw": "4860547156821",
      "wrapperSupplyRaw": "4822869747063",
      "navPerWrapper": 1.007812238,
      "underlyingPriceUsd": 77.97507993366663,
      "priceUsd": 78.58423981617747,
      "tokenizedTvlUsd": 379001.5530744735,
      "underlyingPoolTvlUsd": 1066853.7523347072,
      "liveApy": 0.08646796988090966,
      "cumulativeApy": 0.06981283141486361,
      "cumulativeGrowthPct": 0.007811890304898039,
      "performanceStartTimestamp": "2026-05-28T22:26:07.000Z",
      "totalVolumeUnderlyingRaw": "30160264546962",
      "totalVolumeUsd": 2338319.210438918,
      "cumulativeInterestUnderlyingRaw": "20046445833",
      "cumulativeInterestUsd": 1549.1625237776943,
      "stateSlot": "431906345",
      "stateUpdatedAt": "2026-07-10T00:32:59.670Z",
      "priceUpdatedAt": "2026-07-10T00:32:59.670Z",
      "poolUpdatedAt": "2026-07-10T00:32:59.670Z",
      "apyUpdatedAt": "2026-07-10T00:32:59.670Z",
      "staleFlags": []
    }
  ],
  "nextCursor": null
}

Live values in the response change as Overpass samples the wrapper and its source pool.

Field semantics

Fields	Description
`wrapperMint`, `wrapperVault`, `underlyingMint`, `sourcePool`, `protocol`	Addresses and protocol needed to identify and route the wrapper.
`underlyingHeldRaw`, `wrapperSupplyRaw`	Integer token amounts encoded as strings. Scale them using `underlyingDecimals` and `decimals`.
`navPerWrapper`	Underlying tokens redeemable per wrapper token before transaction-specific slippage.
`underlyingPriceUsd`, `priceUsd`	Current USD prices for the underlying and wrapper tokens.
`tokenizedTvlUsd`	Current value held by the Overpass wrapper.
`underlyingPoolTvlUsd`	Total value in the external source pool, not the wrapper TVL.
`liveApy`, `cumulativeApy`, `cumulativeGrowthPct`	Decimal fractions. For example, `0.0864` represents `8.64%`.
`totalVolumeUnderlyingRaw`, `totalVolumeUsd`	Cumulative wrapper deposits and withdrawals.
`cumulativeInterestUnderlyingRaw`, `cumulativeInterestUsd`	Cumulative interest attributed to wrapper holders.
`sampledAt`, `stateUpdatedAt`, `priceUpdatedAt`, `poolUpdatedAt`, `apyUpdatedAt`	Sampling and source-specific freshness timestamps.
`staleFlags`	Sources that are outside their freshness threshold. An empty array means no source is currently flagged stale.

Nullable fields have not been observed or cannot currently be calculated. Do not replace them with zero.

Paginate through every wrapper

const tokens: Array<Record<string, unknown>> = [];
let cursor: string | null = null;

do {
  const params = new URLSearchParams({ limit: "500" });
  if (cursor) params.set("cursor", cursor);

  const response = await fetch(
    `https://api-v1.overpass.ag/v1/tokens?${params}`,
  );

  if (!response.ok) {
    throw new Error(`Overpass token request failed: ${response.status}`);
  }

  const page = await response.json();
  tokens.push(...page.items);
  cursor = page.nextCursor;
} while (cursor);

Treat nextCursor as opaque. Do not construct or modify it.

Filter wrappers

Fetch every Kamino-backed wrapper:

curl --get 'https://api-v1.overpass.ag/v1/tokens' \
  --data-urlencode 'protocol=kamino' \
  --data-urlencode 'limit=500'

Fetch wrappers for one underlying mint:

curl --get 'https://api-v1.overpass.ag/v1/tokens' \
  --data-urlencode 'underlyingMint=So11111111111111111111111111111111111111112'

You can combine both filters.

Fetch one wrapper

Use a wrapper mint to fetch one token and the same stats without a paginated envelope.

GET https://api-v1.overpass.ag/v1/tokens/:wrapperMint

curl 'https://api-v1.overpass.ag/v1/tokens/HtnnuzVtecjktsUoZjHaZoZ9u4jPAzGpujE82U3v3cAV'

The endpoint returns 404 with {"error":"not_found"} when the wrapper does not exist. Use wrapperMint and underlyingMint from this response to get a swap quote.

Start here

Overpass API

Core concepts

Guides

Integrations

Reference

List yield tokens

Query parameters

Request

Response

Field semantics

Paginate through every wrapper

Filter wrappers

Fetch one wrapper

​Query parameters

​Request

​Response

​Field semantics

​Paginate through every wrapper

​Filter wrappers

​Fetch one wrapper

Query parameters

Request

Response

Field semantics

Paginate through every wrapper

Filter wrappers

Fetch one wrapper