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"
}Body
Optional partner fee override in basis points (0 to 500). Applied directly as this quote's partner fee, with no separate enable step. On a quote for one of your child organizations, the resolution order is: this per-quote override > your organization's default (partnerFeeDefaultBps) > 0. We ignore it on a quote for your own organization, which has no partner fee. 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 <= 500Response
The created quote
Total fee in basis points (e.g., 20 = 0.20%). Combined fee that already includes any partner fee. On a child organization's quote, subtract the partnerFeeBps you sent on the request to get the Etherfuse platform portion. A quote for your own organization has no partner fee, so feeBps is all platform fee. 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.