curl --request POST \
--url https://api.sand.etherfuse.com/ramp/quote \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"blockchain": "stellar",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"quoteAssets": {
"sourceAsset": "MXN",
"targetAsset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"type": "onramp"
},
"quoteId": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
"sourceAmount": "1000",
"walletAddress": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
blockchain: 'stellar',
customerId: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
quoteAssets: {
sourceAsset: 'MXN',
targetAsset: 'USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5',
type: 'onramp'
},
quoteId: '3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c',
sourceAmount: '1000',
walletAddress: 'GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL'
})
};
fetch('https://api.sand.etherfuse.com/ramp/quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/quote"
payload = {
"blockchain": "stellar",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"quoteAssets": {
"sourceAsset": "MXN",
"targetAsset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"type": "onramp"
},
"quoteId": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
"sourceAmount": "1000",
"walletAddress": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"blockchain": "stellar",
"createdAt": "2026-05-02T09:14:00Z",
"destinationAmount": "58.42",
"etherfuseMidMarketRate": "17.15",
"exchangeRate": "17.12",
"expiresAt": "2026-05-02T09:16:00Z",
"feeAmount": "2.00",
"feeBps": "20",
"nominalRate": "17.15",
"quoteAssets": {
"sourceAsset": "MXN",
"targetAsset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"type": "onramp"
},
"quoteId": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
"requiresSwap": true,
"sourceAmount": "1000",
"updatedAt": "2026-05-02T09:14:00Z"
}Get quote
Retrieves a quote for converting between assets. Supports three quote types:
- Onramp: fiat → crypto (
sourceAsset: fiat currency code,targetAsset: asset identifier) - Offramp: crypto → fiat (
sourceAsset: asset identifier,targetAsset: fiat currency code) - Swap: crypto → crypto (
sourceAsset: asset identifier,targetAsset: asset identifier)
Finding supported assets: use GET /ramp/assets to list the supported
assets for quotes, ramps, and swaps, along with their identifier values.
Crypto assets use the CODE:ISSUER format (e.g.
USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN) — use the identifier
from the /ramp/assets response. Fiat currencies use standard codes (e.g. MXN). The
quote includes exchange rates, fees, and expiration information.
customerId: the org the quote is for. When you transact as your own org, use the id from GET /ramp/me. For child customers, use their org UUID.
curl --request POST \
--url https://api.sand.etherfuse.com/ramp/quote \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"blockchain": "stellar",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"quoteAssets": {
"sourceAsset": "MXN",
"targetAsset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"type": "onramp"
},
"quoteId": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
"sourceAmount": "1000",
"walletAddress": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
blockchain: 'stellar',
customerId: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
quoteAssets: {
sourceAsset: 'MXN',
targetAsset: 'USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5',
type: 'onramp'
},
quoteId: '3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c',
sourceAmount: '1000',
walletAddress: 'GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL'
})
};
fetch('https://api.sand.etherfuse.com/ramp/quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/quote"
payload = {
"blockchain": "stellar",
"customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"quoteAssets": {
"sourceAsset": "MXN",
"targetAsset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"type": "onramp"
},
"quoteId": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
"sourceAmount": "1000",
"walletAddress": "GDUKMGUGD3V6VXTU2RLAUM7A2FABLMHCPWTMDHKP7HHJ6FCZKEY4PVWL"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"blockchain": "stellar",
"createdAt": "2026-05-02T09:14:00Z",
"destinationAmount": "58.42",
"etherfuseMidMarketRate": "17.15",
"exchangeRate": "17.12",
"expiresAt": "2026-05-02T09:16:00Z",
"feeAmount": "2.00",
"feeBps": "20",
"nominalRate": "17.15",
"quoteAssets": {
"sourceAsset": "MXN",
"targetAsset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"type": "onramp"
},
"quoteId": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
"requiresSwap": true,
"sourceAmount": "1000",
"updatedAt": "2026-05-02T09:14:00Z"
}Authorizations
API key sent in the Authorization header.
Body
blockchain identifier (stellar, solana)
stellar, solana, base, polygon, monad, avalanche Organization the quote is for. Use GET /ramp/me → id when quoting for your own org; use a child customer's org UUID when quoting on their behalf.
Fiat → crypto: pay in fiat, receive a stablecoin/token on-chain.
- Onramp
- Offramp
- Swap
Show child attributes
Show child attributes
Optional partner fee override in basis points (0–500). Applied directly as this quote's partner fee — there is no separate enable step. Resolution order: this per-quote override > your organization's default (partnerFeeDefaultBps) > 0. The resulting partner fee is folded into the quote's feeBps/feeAmount; it is not returned as a separate field on the response.
0 <= x <= 500Optional Stellar wallet address. When provided for Stellar onramps, enables trustline check and setup fee calculation.
Response
The created quote
Canonical blockchain enum for API serialization.
Use this type for JSON APIs and WebSocket messages.
For database storage, convert to BlockchainType.
stellar, solana, base, polygon, monad, avalanche The amount of the destination asset the customer receives. Already net of all fees (platform fee plus any partner fee): destinationAmount = sourceAmount × exchangeRate. Do not subtract a fee from it again.
The effective, fee-inclusive rate the customer receives — all fees (platform and partner) are already reflected. Multiply by sourceAmount to get destinationAmount. For the raw pre-fee rate, use nominalRate.
Fee amount, equal to sourceAmount × feeBps, denominated in the source asset's currency (e.g., fiat for onramps; the source token for offramps and swaps — USDC when selling USDC, the bond token when selling a bond). Includes any partner fee.
Total fee in basis points (e.g., 20 = 0.20%). Combined fee that already includes any partner fee — subtract the partnerFeeBps you sent on the request to get the Etherfuse platform portion. The partner fee is not itemized separately on the quote response.
Pre-fee rate. exchange_rate is the effective rate after fees;
nominal_rate is the underlying market rate before any Etherfuse fee
deduction. UIs that want to render the raw market relationship cleanly
(e.g., "1 MXN = 1 MEXe" with the fee row shown separately) should read
this field. Always populated.
Fiat → crypto: pay in fiat, receive a stablecoin/token on-chain.
- Onramp
- Offramp
- Swap
Show child attributes
Show child attributes
Whether this quote requires an on-chain swap (true for FX ramps, false for stablebond ramps)
FX mid-market rate from a currency provider (e.g., USD/MXN). Only
populated for cross-currency quotes. Absent on direct stablebond
ramps and wraps — use nominal_rate for the pre-fee rate there.
Timestamp when the quote expires, as an RFC 3339 / ISO 8601 string (e.g. 2025-12-17T18:31:46Z) — never an epoch number. Quotes are valid for 2 minutes from creation.