Saltar al contenido principal
Create a Quote
curl --request POST \
  --url https://api.spherepay.co/v2/quote \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "100.00",
  "customerId": "customer_3faa484998f44cfead9668608b9ee1f5",
  "source": {
    "currency": "usdc",
    "network": "polygon"
  },
  "destination": {
    "currency": "brl",
    "network": "pix"
  },
  "quoteDurationSeconds": 60,
  "integratorBpsFeeRate": "20"
}
'
{
  "id": "quote_d243ab2b1de4447d8a046d87fefe58cf",
  "type": "off_ramp",
  "customerId": "customer_3faa484998f44cfead9668608b9ee1f5",
  "fees": {
    "integratorFee": {
      "fixedAmount": "0.00",
      "bpsRate": "20",
      "bpsAmount": "0.20",
      "totalAmount": "0.20",
      "currency": "usdc"
    },
    "platformFee": {
      "fixedAmount": "0.00",
      "bpsRate": "20",
      "bpsAmount": "0.20",
      "totalAmount": "0.20",
      "currency": "usdc"
    }
  },
  "source": {
    "currency": "usdc",
    "network": "polygon",
    "amount": "100.00"
  },
  "destination": {
    "currency": "brl",
    "network": "pix",
    "amount": "545.50",
    "exchangeRate": "5.455"
  },
  "expiresAt": "2025-01-01T00:01:00.000Z",
  "created": "2025-01-01T00:00:00.000Z"
}
Usa este endpoint para bloquear una tasa de cambio antes de crear una transferencia. Las cotizaciones (quote) le dan al cliente una tasa de conversión determinista de origen a destino que es válida por una ventana fija (30, 60 o 300 segundos). La cotización captura el monto de origen, el monto de destino, la tasa de cambio y el desglose completo de comisiones (integrador + plataforma) en el momento de su emisión. Una cotización puede ser canjeada exactamente una vez pasando su ID al llamar a Crear Transferencia.
Las cotizaciones son más útiles para trading y pagos transfronterizos donde el cliente necesita ver la tasa exacta que recibirá antes de confirmar la transferencia. Para transferencias con tasa flotante (p. ej. nómina, rebalanceo de tesorería), omite la cotización y llama a /v2/transfer directamente.

Autorizaciones

​
Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cuerpo

application/json
​
amount
string
requerido

The quote amount (denominated in source currency).

Pattern: ^\d+(\.\d{2})?$
Ejemplo:

"100.00"

​
customerId
string
requerido

The customer's ID.

Pattern: ^customer_[a-z0-9]+$
Ejemplo:

"customer_3faa484998f44cfead9668608b9ee1f5"

​
source
object
requerido

The source currency and network for the quote.

​
destination
object
requerido

The destination currency and network for the quote.

​
quoteDurationSeconds
enum<number>
predeterminado:60

The duration in seconds for which the quote rate is locked. Defaults to 60.

Opciones disponibles:
30,
60,
300
Ejemplo:

60

​
integratorBpsFeeRate
string

The integrator BPS fee rate. The BPS rate should be an integer represented as a string.

Ejemplo:

"20"

Respuesta

​
id
string
requerido

A unique identifier for the quote.

Pattern: ^quote_[a-z0-9]+$
Ejemplo:

"quote_d243ab2b1de4447d8a046d87fefe58cf"

​
type
enum<string>
requerido

The transfer type this quote is for.

Opciones disponibles:
on_ramp,
off_ramp
Ejemplo:

"off_ramp"

​
customerId
string
requerido

The customer ID.

Ejemplo:

"customer_d243ab2b1de4447d8a046d87fefe58cf"

​
fees
object
requerido
​
source
object
requerido
​
destination
object
requerido
​
expiresAt
string<date-time>
requerido

The datetime when this quote expires.

Ejemplo:

"2025-01-01T00:01:00.000Z"

​
created
string<date-time>
requerido

The datetime the quote was created.

Ejemplo:

"2025-01-01T00:00:00.000Z"

Última modificación el 18 de junio de 2026