Skip to main content
POST
/
ramp
/
quote
Get quote for conversion
curl --request POST \
  --url https://api.etherfuse.com/ramp/quote \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "quoteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "blockchain": "stellar",
  "quoteAssets": {
    "type": "onramp",
    "sourceAsset": "MXN",
    "targetAsset": "<string>"
  },
  "sourceAmount": "<string>",
  "walletAddress": "<string>",
  "partnerFeeBps": 250
}
'
{
  "quoteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "blockchain": "stellar",
  "quoteAssets": {
    "type": "onramp",
    "sourceAsset": "MXN",
    "targetAsset": "<string>"
  },
  "sourceAmount": "<string>",
  "destinationAmount": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "expiresAt": "2023-11-07T05:31:56Z",
  "exchangeRate": "<string>",
  "etherfuseMidMarketRate": "<string>",
  "feeBps": "<string>",
  "feeAmount": "<string>",
  "destinationAmountAfterFee": "<string>",
  "partnerFeeBps": 123,
  "partnerFeeAmount": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Pass the key directly (e.g., Authorization: your-api-key). Do not use a Bearer prefix.

Body

application/json
​
quoteId
string<uuid>
required

Unique identifier for the quote

​
customerId
string<uuid>
required

ID of the customer requesting the quote

​
blockchain
enum<string>
required

Blockchain for the quote

Available options:
stellar,
solana,
base,
polygon,
monad
​
quoteAssets
Onramp · object
required

Quote assets configuration based on quote type

​
sourceAmount
string
required

Amount of the source asset

​
walletAddress
string | null

Public key of the destination wallet. Optional but recommended for Stellar onramps. When provided for Stellar onramp quotes, the system checks whether the wallet has an on-chain account and trustline. If setup is needed (new account or missing trustline), the fee will include a one-time onboarding cost to fund the wallet. Without this field, the quote assumes the wallet is already set up.

​
partnerFeeBps
integer

Optional partner fee override in basis points (0–500). If provided, this value is used as the partner fee for this quote instead of the organization's default. Only applies when the organization has partner fees enabled.

Required range: 0 <= x <= 500

Response

Quote retrieved successfully

​
quoteId
string<uuid>
required

Unique identifier for the quote

​
blockchain
enum<string>
required

Blockchain for the quote

Available options:
stellar,
solana,
base,
polygon,
monad
​
quoteAssets
Onramp · object
required
​
sourceAmount
string
required

Amount of the source asset

​
destinationAmount
string
required

Amount of the destination asset after conversion

​
createdAt
string<date-time>
required

Timestamp when the quote was created

​
updatedAt
string<date-time>
required

Timestamp when the quote was last updated

​
expiresAt
string<date-time>
required

Timestamp when the quote expires

​
exchangeRate
string
required

Fee-inclusive exchange rate between source and destination assets. This is the rate the user will actually receive — fees are already reflected in this rate. Multiply by sourceAmount to get destinationAmount.

​
etherfuseMidMarketRate
string | null

Raw mid-market rate before fees. For stablebond ramps, this is the bond price. For FX ramps, this is the forex mid-market rate between the underlying fiat currencies.

​
feeBps
string | null

Fee in basis points (e.g., "20" = 0.20%)

​
feeAmount
string | null

Fee amount in source asset currency

​
destinationAmountAfterFee
string | null

Amount the user actually receives after fees are deducted

​
partnerFeeBps
integer | null

Partner fee in basis points applied to this quote (e.g., 100 = 1.00%). Only present when a partner fee is configured for the requesting organization.

​
partnerFeeAmount
string | null

Partner fee amount in source asset currency. Only present when a partner fee is configured.