Price Feeds

Etherfuse asset prices (stablebonds like CETES, principal tokens like MEXe) and FX rates (USD ↔ MXN/BRL) are available two ways:

On-chain, via oracles — for smart contracts and on-chain consumers.
Over HTTP, via the REST API — for backends and apps.

On-chain oracles

Switchboard (Solana)

Switchboard On-Demand serves Etherfuse FX rates (e.g. MXN/USD) on Solana — the same rates used in token pricing/minting. View the live feeds ↗

RedStone (multi-chain)

RedStone publishes push price feeds for Etherfuse assets (e.g. CETES) on Base, Solana, Polygon, and Stellar. Browse the feeds ↗

REST API pricing

For server-side pricing and FX rates, the public Lookup endpoints (no API key required) return Etherfuse’s pricing directly:

Endpoint	Returns
`GET /lookup/exchange_rate`	All USD ↔ currency FX rates (e.g. USD/MXN, USD/BRL), with a per-provider `sources` breakdown
`GET /lookup/exchange_rate/usd_to_{currency}`	A single USD → currency rate
`GET /lookup/tokens/cost`	Costs for every Etherfuse token in USD and fiat, with per-FX-provider sources for oracle-safety checks
`GET /lookup/tokens/cost/{identifier}`	Cost for one token (by symbol or Solana mint)
`GET /lookup/stablebonds`	All available stablebonds

# FX rate (public, no API key needed)
curl https://api.etherfuse.com/lookup/exchange_rate/usd_to_mxn

# Cost of one token, by symbol (case-insensitive) or mint
curl https://api.etherfuse.com/lookup/tokens/cost/mexe

Token costs

GET /lookup/tokens/cost covers both kinds of Etherfuse token:

Stablebonds (token_kind: "bond") such as CETES, whose price accrues with the underlying bond’s rate.
Principal tokens (token_kind: "principal_token") such as MEXe, which wrap a bond and hold par with its currency, so 1 MEXe is 1 MXN.

The response is keyed by uppercased token symbol. Each entry carries the token’s cost in its denomination currency (token_cost_in_fiat) and in USD (token_cost_in_usd), plus a sources map giving the exchange rate and derived USD cost from each FX provider, so you can run your own oracle-safety checks across providers:

{
  "CETES": {
    "token_symbol": "CETES",
    "token_mint": "CETES7CKqqKQizuSN6iWQwmTeFRjbJR6Vw2XRKfEDR8f",
    "token_kind": "bond",
    "currency": "MXN",
    "token_cost_in_fiat": "1.177336",
    "token_cost_in_usd": "0.069404",
    "fiat_exchange_rate_with_usd": "16.96343",
    "current_basis_points": 554,
    "sources": {
      "d2ce2919-082f-4d60-8fbb-a15b3b570e57": { "exchange_rate": "16.96343", "token_cost_in_usd": "0.069404", "updated_at": 1787243387 },
      "8e1e2967-0283-42dd-bb06-e49193c368d2": { "exchange_rate": "16.96425", "token_cost_in_usd": "0.069401", "updated_at": 1787243417 }
    }
  },
  "MEXE": {
    "token_symbol": "MEXe",
    "token_mint": "MEXeQE5UjuusUoyS2KxbUXp6o21YbbBJaNvPMMEfr4y",
    "token_kind": "principal_token",
    "underlying_bond_symbol": "CETES",
    "currency": "MXN",
    "token_cost_in_fiat": "1.000000",
    "token_cost_in_usd": "0.058950",
    "fiat_exchange_rate_with_usd": "16.96343",
    "current_basis_points": 0,
    "sources": {
      "d2ce2919-082f-4d60-8fbb-a15b3b570e57": { "exchange_rate": "16.96343", "token_cost_in_usd": "0.058950", "updated_at": 1787243387 },
      "8e1e2967-0283-42dd-bb06-e49193c368d2": { "exchange_rate": "16.96425", "token_cost_in_usd": "0.058947", "updated_at": 1787243417 }
    }
  }
}

sources keys are Etherfuse FX provider ids, and updated_at is a Unix timestamp in seconds. exchange_rate is always the raw USD to currency rate as the provider published it, so on a principal token it reads the same as on the bond it wraps. Two fields differ by token kind. current_basis_points is the bond’s annualized rate, and it is always 0 on a principal token because the coupon accrues to the bond rather than to the principal-token holder. payment_mint names the token a bond purchase settles in and is absent on principal tokens.

GET /lookup/bonds/cost and GET /lookup/bonds/cost/{identifier} are deprecated. They keep working with their existing bond_* fields and have no sunset date, but they cover only stablebonds, so they cannot price MEXe. Move to /lookup/tokens/cost. See Deprecations.

Browse these under Lookup in the API Reference.

Get Started

Concepts

User Authentication

Integration Guides

KYC

KYB

Blockchains

Resources

On-chain oracles

Switchboard (Solana)

RedStone (multi-chain)

REST API pricing

Token costs

​On-chain oracles

Switchboard (Solana)

RedStone (multi-chain)

​REST API pricing

​Token costs

On-chain oracles

REST API pricing

Token costs