Quotes

Public quotes help payers understand a conversion. They are not settlement promises and do not automatically include provider fees.

Fetch

GET /v1/quotes?asset=USDT
{
  "data": {
    "asset": "USDT",
    "priceBrl": "5.48000000",
    "source": "Coinbase",
    "asOf": "2026-11-04T12:00:00.000Z",
    "expiresAt": "2026-11-04T12:00:30.000Z",
    "indicative": true
  }
}

This response is illustrative. The endpoint retrieves real data when called.

Fallback and validity

The service tries Coinbase, Binance, then CoinGecko. Each source has a timeout; failures move to the next. Quotes are cached for 30 seconds and concurrent requests share a fetch. Expired cached prices are not silently returned.

If every source fails, the API returns 503 QUOTE_UNAVAILABLE. Checkout shows unavailability and supports refresh. Cache validity does not imply the source publishes a new trade every 30 seconds.

Financial decisions

priceBrl is a decimal string. Use decimal arithmetic on your backend. Displaying a quote never authorizes a balance credit; settled value must come from verified provider confirmation when live operation is enabled.

Future provider-quote reference: 4P Finance — Quote.

Magnum integration documentationAPI v1

Search documentation