Skip to main content
A quote tells you the exchange rate, fees, and destination amount before you commit to a payment. Zeam supports two types of quotes depending on the scenario.

Connect quote

Get a quote from a payment connector for off-ramp delivery:
curl -s -X POST https://api.zeam.money/gw/v1/connect-quote \
  -H "Authorization: Bearer $CONNECT_TOKEN" \
  -H "x-zeam-auth: $CONNECT_SECRET" \
  -H 'Content-Type: application/json' \
  -d '{
    "connectorId": "'$CONNECTOR_ID'",
    "amount": "100.00",
    "currency": "USDC"
  }' | jq
The response includes:
FieldDescription
quoteIdReference for executing this quote
sendAmountThe amount to send
acceptedAssetThe asset the connector accepts
exchangeRateApplied FX rate
feesBreakdown of fees
destinationAmountWhat the beneficiary receives
Quotes are time-limited. Execute promptly after receiving one — an expired quote will be rejected at execution time.

Stellar path-payment quote

If your wallet holds a different asset than the connector accepts, get a Stellar path-payment quote to determine the on-chain conversion:
curl -s -X POST https://api.zeam.money/gw/v1/stellar/quote \
  -H "Authorization: Bearer $BUSINESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "fromAsset": "ZARZ:GABC...",
    "toAsset": "USDC:GABC...",
    "amount": "100.00"
  }' | jq
FieldRequiredDescription
fromAssetYesSource asset (XLM, native, or CODE:ISSUER)
toAssetYesDestination asset (must differ from fromAsset)
amountYesDecimal amount (up to 7 fractional digits)
The response includes a sendMax value — the maximum you’ll spend in the source asset to receive the exact destination amount.

Using the Go SDK

// Connect quote
quote, err := client.Connect().GetQuote(ctx, connectSession, connect.QuoteInput{
    ConnectorID: connectorID,
    Amount:      "100.00",
    Currency:    "USDC",
    Destination: destinationPayload,
})

// Stellar path-payment quote
stellarQuote, err := client.Business().StellarQuote(ctx, businessSession, business.StellarQuoteInput{
    FromAsset: "ZARZ:GABC...",
    ToAsset:   "USDC:GABC...",
    Amount:    "100.00",
})

Next steps

Once you have a quote, proceed to execute the transaction.