curl --request GET \
--url https://api.sand.etherfuse.com/lookup/tokens/cost/{identifier}const options = {method: 'GET'};
fetch('https://api.sand.etherfuse.com/lookup/tokens/cost/{identifier}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/lookup/tokens/cost/{identifier}"
response = requests.get(url)
print(response.text){
"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
}
}
}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.
curl --request GET \
--url https://api.sand.etherfuse.com/lookup/tokens/cost/{identifier}const options = {method: 'GET'};
fetch('https://api.sand.etherfuse.com/lookup/tokens/cost/{identifier}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/lookup/tokens/cost/{identifier}"
response = requests.get(url)
print(response.text){
"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
}
}
}Path Parameters
Token symbol or Solana mint address (e.g. "MEXe", "CETES", "MEXeQE5UjuusUoyS2KxbUXp6o21YbbBJaNvPMMEfr4y"). Symbols are case-insensitive.
Query Parameters
Maximum age of a source in seconds. Sources older than this are excluded.
x >= 0Response
Pricing for the requested token
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.
Display symbol (e.g. CETES, MEXe). The map key on the list endpoint is this value uppercased.
The token's own Solana mint address.
bond for a stablebond, principal_token for a token that wraps one (e.g. MEXe wraps CETES).
bond, principal_token Denomination currency (ISO 4217, e.g. MXN).
Token cost denominated in currency. A principal token holds par with its currency, so 1 MEXe reads as 1.000000 MXN.
Token cost denominated in USD.
FX rate between the denomination currency and USD.
Annualized rate of the bond, in basis points (e.g. 554 = 5.54%). Read from BondPrice. Always 0 on a principal token: the coupon accrues to the underlying bond, not to the principal-token holder.
Timestamp the price was computed (RFC 3339).
Per-FX-provider exchange rate and derived USD cost, for oracle safety checks. Keys are Etherfuse FX provider ids.
Show child attributes
Show child attributes
Principal tokens only: the symbol of the bond this token wraps. Absent on bonds.
Bonds only: mint address of the token a purchase settles in. Absent on principal tokens.