Discovering tokens, pools and routes

This guide shows how to use the Mento SDK v3 to discover tradable tokens, FPMM pools, and routes between tokens. The SDK uses a route cache by default for fast lookups; you can also fetch fresh data from the chain.

---

Create the client

import { Mento, ChainId } from '@mento-protocol/mento-sdk'

// Celo Mainnet (use ChainId.CELO_SEPOLIA for testnet)
const mento = await Mento.create(ChainId.CELO)

---

Tokens

Get Mento stable tokens and collateral assets:

const stableTokens = await mento.tokens.getStableTokens()
const collateral = await mento.tokens.getCollateralAssets()

---

Pools

List all pools (FPMM and legacy Virtual/BiPoolManager):

const pools = await mento.pools.getPools()

The SDK returns enriched pool data: addresses, token info, pricing, fees, rebalancing state, and trading limits. Use this when you need full pool details for UIs or risk checks, not just a path between two tokens.

---

Routes

The SDK uses a pre-computed route cache by default for fast quote and swap lookups. You can also fetch routes fresh from the chain.

Find a route between two tokens (for quoting and swapping):

const USDm = '0x765DE816845861e75A25fCA122bb6898B8B1282a'
const CELO = '0x471EcE3750Da237f93B8E339c536989b8978a438'

const route = await mento.routes.findRoute(USDm, CELO)
console.log(`Hops: ${route.path.length}`)

Get all tradable routes (from the pre-generated cache by default):

const routes = await mento.routes.getRoutes()

Force a fresh route set from the blockchain:

const freshRoutes = await mento.routes.getRoutes({ cached: false })

---

Trading status

Check whether a pair is tradable (circuit breaker and trading limits):

const isTradable = await mento.trading.isPairTradable(USDm, CELO)

For a specific pool, get full tradability status:

const pools = await mento.pools.getPools()
const status = await mento.trading.getPoolTradabilityStatus(pools[0])

if (!status.circuitBreakerOk) {
  console.log('Trading suspended by circuit breaker')
} else if (!status.limitsOk) {
  console.log('Trading limit reached')
}

---

Runnable examples: mento-sdk-examples.