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:
| Field | Description |
|---|
quoteId | Reference for executing this quote |
sendAmount | The amount to send |
acceptedAsset | The asset the connector accepts |
exchangeRate | Applied FX rate |
fees | Breakdown of fees |
destinationAmount | What 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
| Field | Required | Description |
|---|
fromAsset | Yes | Source asset (XLM, native, or CODE:ISSUER) |
toAsset | Yes | Destination asset (must differ from fromAsset) |
amount | Yes | Decimal 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.