> ## 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 token cost > Returns current pricing for one Etherfuse token, either a stablebond or a principal token. `identifier` is the token symbol or its Solana mint address. Symbols are matched case-insensitively, so `mexe`, `MEXE` and `MEXe` all resolve to the same token. This replaces `GET /lookup/bonds/cost/{identifier}`, which is deprecated and covers only stablebonds. Public, no API key required. ## OpenAPI ````yaml /openapi.json get /lookup/tokens/cost/{identifier} 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: 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 a customer's verification data, documents and questionnaire answers, import a verification they already passed elsewhere, and check where their KYC stands. - name: Webhooks description: Event notification subscriptions. - name: Organizations description: Organization identity, child orgs, and partner fees. - name: Statements description: >- Monthly revenue share statements for closed months, as a list or as a CSV or PDF download. - name: Deprecated description: >- Endpoints kept working until their sunset date and then removed. See the deprecations page for replacements and dates. paths: /lookup/tokens/cost/{identifier}: get: tags: - Lookup summary: Get token cost description: >- Returns current pricing for one Etherfuse token, either a stablebond or a principal token. `identifier` is the token symbol or its Solana mint address. Symbols are matched case-insensitively, so `mexe`, `MEXE` and `MEXe` all resolve to the same token. This replaces `GET /lookup/bonds/cost/{identifier}`, which is deprecated and covers only stablebonds. Public, no API key required. operationId: get_token_cost parameters: - name: identifier in: path description: >- Token symbol or Solana mint address (e.g. "MEXe", "CETES", "MEXeQE5UjuusUoyS2KxbUXp6o21YbbBJaNvPMMEfr4y"). Symbols are case-insensitive. required: true schema: type: string - 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 for the requested token content: application/json: schema: $ref: '#/components/schemas/TokenCost' '404': description: Token not found for identifier '503': description: Token cost not currently available security: - {} components: schemas: TokenCost: type: object description: >- Current pricing for one Etherfuse token: its cost in the denomination currency and in USD, plus the per-provider exchange-rate `sources` used to derive it. required: - token_symbol - token_mint - token_kind - currency - token_cost_in_fiat - token_cost_in_usd - fiat_exchange_rate_with_usd - current_basis_points - current_time - sources properties: token_symbol: type: string description: >- Display symbol (e.g. `CETES`, `MEXe`). The map key on the list endpoint is this value uppercased. token_mint: type: string description: The token's own Solana mint address. token_kind: type: string enum: - bond - principal_token description: >- `bond` for a stablebond, `principal_token` for a token that wraps one (e.g. MEXe wraps CETES). underlying_bond_symbol: type: string description: >- Principal tokens only: the symbol of the bond this token wraps. Absent on bonds. currency: type: string description: Denomination currency (ISO 4217, e.g. `MXN`). token_cost_in_fiat: type: string description: >- Token cost denominated in `currency`. A principal token holds par with its currency, so 1 MEXe reads as 1.000000 MXN. token_cost_in_usd: type: string description: Token cost denominated in USD. fiat_exchange_rate_with_usd: type: string description: FX rate between the denomination currency and USD. current_basis_points: type: integer format: int32 description: >- Annualized rate of the bond, in basis points (e.g. `554` = 5.54%). Always `0` on a principal token: the coupon accrues to the underlying bond, not to the principal-token holder. current_time: type: string description: Timestamp the price was computed (RFC 3339). payment_mint: type: string description: >- Bonds only: mint address of the token a purchase settles in. Absent on principal tokens. sources: type: object description: >- Per-FX-provider exchange rate and derived USD cost, for oracle safety checks. Keys are Etherfuse FX provider ids. additionalProperties: $ref: '#/components/schemas/TokenCostSource' propertyNames: type: string example: 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 current_time: '2026-08-20T16:30:52.382508961+00:00' 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 TokenCostSource: type: object description: |- A single FX provider's exchange rate and the token cost it implies. The `sources` map on a token lets clients run oracle-safety checks across providers. required: - exchange_rate - token_cost_in_usd - updated_at properties: exchange_rate: type: string description: >- This provider's USD to currency exchange rate. Reported as the provider gives it, never adjusted by the wrap rate on a principal token. token_cost_in_usd: type: string description: Token cost in USD derived from this provider's rate. updated_at: type: integer format: int64 description: Unix timestamp (seconds) of the provider's last update. minimum: 0 example: exchange_rate: '16.96343' token_cost_in_usd: '0.058950' updated_at: 1787243387 securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: API key sent in the Authorization header. ````