Skip to main content
GET
/
lookup
/
bonds
/
cost
/
{identifier}
Get stablebond cost
curl --request GET \
  --url https://api.etherfuse.com/lookup/bonds/cost/{identifier}
{
  "bond_cost_in_fiat": "1.153754",
  "bond_cost_in_payment_token": "1.153754",
  "bond_cost_in_usd": "0.064785",
  "bond_symbol": "CETES",
  "currency": "MXN",
  "current_basis_points": 578,
  "current_time": "2026-03-23T16:50:32.821673099+00:00",
  "fiat_exchange_rate_with_usd": "17.80900",
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "sources": {
    "provider_1": {
      "bond_cost_in_usd": "0.064781",
      "exchange_rate": "17.81",
      "updated_at": 1711212632
    },
    "provider_2": {
      "bond_cost_in_usd": "0.064854",
      "exchange_rate": "17.79",
      "updated_at": 1711212630
    }
  },
  "symbol": "USDC"
}

Path Parameters

identifier
string
required

Bond mint address or symbol (e.g. "CETES", "USTRY", "CETES7CKqqKQizuSN6iWQwmTeFRjbJR6Vw2XRKfEDR8f")

Query Parameters

max_age
integer<int64> | null

Maximum age of a source in seconds. Sources older than this are excluded.

Required range: x >= 0

Response

Pricing data for the requested bond

Current pricing for a single stablebond: cost in USD/fiat plus the per-provider exchange-rate sources used to derive it.

bond_cost_in_fiat
string
required

Bond cost denominated in the settlement (fiat) currency.

bond_cost_in_payment_token
string
required

Deprecated — use bond_cost_in_fiat.

bond_cost_in_usd
string
required

Bond cost denominated in USD.

bond_symbol
string
required

Bond symbol (e.g. CETES).

currency
string
required

Settlement currency (ISO 4217, e.g. MXN).

current_basis_points
integer<int32>
required

Current fee, in basis points.

current_time
string
required

Timestamp the price was computed (RFC 3339).

fiat_exchange_rate_with_usd
string
required

FX rate between the settlement currency and USD.

mint
string
required

Payment-token mint address.

sources
object
required

Per-FX-provider exchange rate and derived USD cost, for oracle safety checks.

symbol
string
required

Payment-token symbol (e.g. USDC).