> ## 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.

# Get all bond 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.
This endpoint is public and does not require authentication.




## OpenAPI

````yaml /openapi.yaml get /lookup/bonds/cost
openapi: 3.1.0
info:
  title: FX API
  version: 1.0.0
  description: >
    API for managing FX operations including onboarding, quotes, orders, and
    customer management.

    This API provides endpoints for managing customers, bank accounts, crypto
    wallets, orders, and webhooks.
servers:
  - url: https://api.etherfuse.com
    description: Production API
  - url: https://api.sand.etherfuse.com
    description: Sandbox API (for testing)
security: []
tags:
  - name: Lookup
    description: Public endpoints for looking up stablebond and exchange rate data
  - name: Assets
    description: Get available assets for ramping
  - name: Onboarding
    description: Customer onboarding and KYC
  - name: Bank Accounts
    description: Manage customer bank accounts
  - name: Agreements
    description: Handle customer agreements and consents
  - name: Quotes
    description: Get quotes for conversions
  - name: Orders
    description: Create and manage orders
  - name: Swaps
    description: Create and manage swaps
  - name: Customers
    description: Manage customers
  - name: Crypto Wallets
    description: Manage crypto wallets
  - name: Webhooks
    description: Manage webhook subscriptions
  - name: Organizations
    description: Manage organizations and child organizations
paths:
  /lookup/bonds/cost:
    get:
      tags:
        - Lookup
      summary: Get all bond 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.

        This endpoint is public and does not require authentication.
      operationId: getBondCosts
      parameters:
        - name: max_age
          in: query
          required: false
          schema:
            type: integer
          description: >-
            Maximum age of a source in seconds. Sources older than this are
            excluded from the `sources` map. When omitted, all sources are
            returned.
          example: 3600
      responses:
        '200':
          description: Bond costs retrieved successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/BondCost'
              example:
                CETES7CKqqKQizuSN6iWQwmTeFRjbJR6Vw2XRKfEDR8f:
                  bond_cost_in_payment_token: '1.153754'
                  bond_cost_in_usd: '0.064785'
                  fiat_exchange_rate_with_usd: '17.80900'
                  bond_cost_in_fiat: '1.153754'
                  current_basis_points: 578
                  bond_symbol: CETES
                  currency: MXN
                  current_time: '2026-03-23T16:50:32.821673099+00:00'
                  mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                  symbol: USDC
                  sources:
                    provider_1:
                      exchange_rate: '17.81'
                      bond_cost_in_usd: '0.064781'
                      updated_at: 1711212632
                    provider_2:
                      exchange_rate: '17.79'
                      bond_cost_in_usd: '0.064854'
                      updated_at: 1711212630
        '500':
          description: Bond prices not available
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    BondCost:
      type: object
      properties:
        bond_cost_in_payment_token:
          type: string
          deprecated: true
          description: Bond cost in fiat (deprecated, same as bond_cost_in_fiat)
        bond_cost_in_usd:
          type: string
          description: Bond cost in USD using the aggregated exchange rate
        fiat_exchange_rate_with_usd:
          type: string
          description: >-
            Aggregated USD-to-fiat exchange rate used for the primary
            bond_cost_in_usd calculation
        bond_cost_in_fiat:
          type: string
          description: Bond cost in the bond's native fiat currency
        current_basis_points:
          type: integer
          description: Current interest rate in basis points
        bond_symbol:
          type: string
          description: Bond symbol (e.g., CETES, USTRY, GILTS)
        currency:
          type: string
          description: Fiat currency code (e.g., MXN, USD, EUR)
        current_time:
          type: string
          description: ISO 8601 timestamp of when this price was computed
        mint:
          type: string
          description: Payment token mint address (e.g., USDC mint)
        symbol:
          type: string
          description: Payment token symbol (e.g., USDC)
        sources:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/BondCostSource'
          description: >-
            Per-provider exchange rate data with derived bond_cost_in_usd for
            each provider
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
      example:
        error: Invalid request parameters
    BondCostSource:
      type: object
      properties:
        exchange_rate:
          type: string
          description: This provider's USD-to-fiat exchange rate
        bond_cost_in_usd:
          type: string
          description: Bond cost in USD derived from this provider's exchange rate
        updated_at:
          type: integer
          description: Unix timestamp of when this provider's rate was last updated

````