Quote previews and signed quotes

Choose the Gate quote surface that matches your integration.

Quote preview

POST /quotes/preview returns indicative choices for applicable payment or payout methods. It does not create a rail and the returned market result can expire or change.

curl -X POST https://gate-api-sandbox.0bit.app/quotes/preview \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"currency":"BRL","asset":"USDC","amount":"100.00","side":"on_ramp"}'

When the response contains quote_preview_id, pass it to POST /gate_sessions with matching partner, amount, currency, asset, and side. An expired, consumed, cross-partner, or mismatched preview is rejected.

Signed quote

POST /quotes is for partners with the rails_api entitlement. It locks one payment method for a short period, returns an HMAC signature, and can be consumed once by a pay-in or pay-out.

curl -X POST https://gate-api-sandbox.0bit.app/quotes \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"currency":"BRL","asset":"USDC","amount":"100.00","side":"on_ramp","payment_method":"PIX"}'

Retrieve it with GET /quotes/{id}. Do not derive settlement values from a preview when executing a rail; the locked quote is authoritative.