> ## Documentation Index
> Fetch the complete documentation index at: https://docs.etherfuse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List stablebond costs

> Returns current pricing data for all stablebonds, including the bond cost in
USD, fiat, and per-provider exchange rate sources. Each bond entry includes a
`sources` map showing the exchange rate and derived `bond_cost_in_usd` from
each FX provider, enabling oracle safety checks.

Public — no API key required.



## OpenAPI

````yaml /openapi.json get /lookup/bonds/cost
openapi: 3.1.0
info:
  title: Etherfuse FX API
  description: Partner-facing ramp API for onramps, offramps, swaps, and KYC.
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sand.etherfuse.com
    description: Sandbox
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: >-
      Partner JWT authentication — exchange a JWT for an access token, or launch
      a user into the app.
  - name: Lookup
    description: >-
      Public reference data: exchange rates, stablebonds, bond costs, country
      codes.
  - name: Assets
    description: Rampable stablecoins and stablebonds available per blockchain.
  - name: Onboarding
    description: Hosted and programmatic customer onboarding.
  - name: Agreements
    description: Legal agreement acceptance during onboarding.
  - name: Bank Accounts
    description: Register and retrieve customer bank accounts.
  - name: Quotes
    description: Price quotes for onramps, offramps, and swaps.
  - name: Orders
    description: Create, track, and manage ramp orders.
  - name: Swaps
    description: Crypto-to-crypto swaps.
  - name: Sponsored
    description: Token approvals for sponsored (gasless) offramps.
  - name: Customers
    description: Customer (child-organization) records.
  - name: Wallets
    description: Register and manage customer wallets.
  - name: KYC
    description: Submit and check customer KYC status.
  - name: Webhooks
    description: Event notification subscriptions.
  - name: Organizations
    description: Organization identity, child orgs, and partner fees.
paths:
  /lookup/bonds/cost:
    get:
      tags:
        - Lookup
      summary: List stablebond costs
      description: >-
        Returns current pricing data for all stablebonds, including the bond
        cost in

        USD, fiat, and per-provider exchange rate sources. Each bond entry
        includes a

        `sources` map showing the exchange rate and derived `bond_cost_in_usd`
        from

        each FX provider, enabling oracle safety checks.


        Public — no API key required.
      operationId: get_bond_prices
      parameters:
        - name: max_age
          in: query
          description: >-
            Maximum age of a source in seconds. Sources older than this are
            excluded.
          required: false
          schema:
            type:
              - integer
              - 'null'
            format: int64
            minimum: 0
      responses:
        '200':
          description: Pricing data keyed by bond mint address
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/PaymentData'
                propertyNames:
                  type: string
              example:
                CETES7CKqqKQizuSN6iWQwmTeFRjbJR6Vw2XRKfEDR8f:
                  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
        '500':
          description: Bond prices not available
      security:
        - {}
components:
  schemas:
    PaymentData:
      type: object
      description: |-
        Current pricing for a single stablebond: cost in USD/fiat plus the
        per-provider exchange-rate `sources` used to derive it.
      required:
        - bond_cost_in_payment_token
        - bond_cost_in_usd
        - fiat_exchange_rate_with_usd
        - bond_cost_in_fiat
        - current_basis_points
        - bond_symbol
        - currency
        - current_time
        - mint
        - symbol
        - sources
      properties:
        bond_cost_in_fiat:
          type: string
          description: Bond cost denominated in the settlement (fiat) currency.
        bond_cost_in_payment_token:
          type: string
          description: Deprecated — use `bond_cost_in_fiat`.
        bond_cost_in_usd:
          type: string
          description: Bond cost denominated in USD.
        bond_symbol:
          type: string
          description: Bond symbol (e.g. `CETES`).
        currency:
          type: string
          description: Settlement currency (ISO 4217, e.g. `MXN`).
        current_basis_points:
          type: integer
          format: int32
          description: >-
            Current annualized rate of the bond, in basis points (e.g. `578` =
            5.78%).
        current_time:
          type: string
          description: Timestamp the price was computed (RFC 3339).
        fiat_exchange_rate_with_usd:
          type: string
          description: FX rate between the settlement currency and USD.
        mint:
          type: string
          description: Payment-token mint address.
        sources:
          type: object
          description: >-
            Per-FX-provider exchange rate and derived USD cost, for oracle
            safety checks.
          additionalProperties:
            $ref: '#/components/schemas/BondCostSource'
          propertyNames:
            type: string
        symbol:
          type: string
          description: Payment-token symbol (e.g. `USDC`).
      example:
        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
    BondCostSource:
      type: object
      description: >-
        A single FX provider's exchange rate and the bond cost it implies. The

        `sources` map on a bond lets clients run oracle-safety checks across
        providers.
      required:
        - exchange_rate
        - bond_cost_in_usd
        - updated_at
      properties:
        bond_cost_in_usd:
          type: string
          description: Bond cost in USD derived from this provider's rate.
        exchange_rate:
          type: string
          description: Provider's USD↔currency exchange rate.
        updated_at:
          type: integer
          format: int64
          description: Unix timestamp (seconds) of the provider's last update.
          minimum: 0
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: API key sent in the Authorization header.

````