1. Create a Quote

The first step in any transaction is to get a quote. This tells you exactly how much the recipient will get, or how much the sender needs to send.

Endpoint

POST /quote

Request

This endpoint expects a target amount in local currency. If you prefer to quote by crypto amount, use Reverse Quote.

Example: delivering 400,000 COP

{
  "amount": 400000,
  "crypto_currency": "USDC",
  "network": "STELLAR",
  "payment_method": "BREB",
  "target_currency": "COP"
}

Parameters

Parameter	Type	Description
amount	number	Target amount the recipient should receive (in target_currency).
crypto_currency	string	The source cryptocurrency (e.g., USDC).
network	string	The blockchain network (e.g., STELLAR, SOLANA).
payment_method	string	The payout method (e.g., BREB, PIX).
target_currency	string	The target fiat currency (e.g., COP, BRL).

Response

The response includes the quote_id, which you will need for the next step, and the expiration time.

{
  "expiration_time": 1732520000,
  "quote_id": "uuid-string",
  "value": 100.5
}

value is the crypto amount (USDC) you need to send before expiration_time (epoch ms).

Expiration

Quotes are valid until expiration_time (currently up to 1 hour). You must accept the transaction and fund it before the quote expires.

Troubleshooting

Quote Expired?

If you receive a 400 Bad Request when trying to accept a transaction, check if the expiration_time has passed. You will need to request a new quote.

Invalid Currency Pair?

Ensure that the target_currency is supported for the selected payment_method. See Supported Assets.