Preview 0Gate quotes

0Gate is the primary public integration path for hosted payment, ramp, and swap experiences. Keep secret-key operations on your server and hand only browser-safe values to the widget.

Endpoint

Use it for

Return indicative quote options across every applicable payment or payout method in one call, without moving funds. This is the quote/all analog: it prices a conversion so you can render an option list, but it does not lock a rate. To lock an executable rate for a server-side rail flow, use POST /quotes.

Use this endpoint only for the partner-scoped resource it describes. Store your own reference id, the returned 0Bit object id, the request id, timestamps, and the current status so support and reconciliation do not depend on browser callbacks alone.

Production rules

• Keep secret keys on your server. This endpoint requires a sk_* key. Publishable pk_* keys are browser-only (embed bootstrap) and cannot call it.
• Validate environment, mode, entitlement, asset, network, and amount before the call.
• Treat the preview as indicative only. Quotes here are not locked or signed and must not be redeemed in a rail flow.
• Branch on machine-readable status, error code, object id, and request id.
• Treat examples and placeholder ids as fake data only.

Request body

Response

200 returns a QuotePreview (object: quote_preview_list). The top-level object echoes the priced conversion and carries the per-method options in quotes.

Examples

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

{
  "object": "quote_preview_list",
  "currency": "EUR",
  "asset": "USDC",
  "side": "on_ramp",
  "amount": "100.00",
  "market_rate": "1.0731",
  "margin_bps": 55,
  "expires_at": "2026-01-01T00:00:30Z",
  "quote_preview_id": "5f3c0000000000000000a1b2",
  "unavailable_reason": null,
  "quotes": [
    {
      "payment_method": "sepa_credit_transfer",
      "fiat_amount": "100.00",
      "crypto_amount": "106.74",
      "exchange_rate": "1.0674"
    },
    {
      "payment_method": "card",
      "fiat_amount": "100.00",
      "crypto_amount": "104.10",
      "exchange_rate": "1.0410"
    }
  ]
}

{
  "object": "quote_preview_list",
  "currency": "EUR",
  "asset": "USDC",
  "side": "on_ramp",
  "amount": "100.00",
  "market_rate": "1.0731",
  "margin_bps": 55,
  "expires_at": "2026-01-01T00:00:30Z",
  "quote_preview_id": null,
  "unavailable_reason": "country_not_supported",
  "quotes": []
}

Errors

All errors use the unified envelope and carry an X-Request-Id response header. Branch on code/type/statusCode, not on the free-form message.

{
  "type": "invalid_request",
  "code": "invalid_request",
  "message": "Example validation error using fake data.",
  "request_id": "req_test_000000000123",
  "doc_url": null,
  "statusCode": 400
}

Public boundary

This reference covers partner-scoped endpoint behavior, authentication, idempotency, webhook verification, and support-safe records. Internal operations, settlement venues, provider details, administrative routes, and unsupported availability claims are outside the public API contract.

Related pages