> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener una cotización cripto/fiat

> Obtén una cotización en tiempo real de cripto a fiat o de fiat a cripto. Opcionalmente, reserva el tipo de cambio con un quoteId para crear la orden.

Usa el endpoint **GET** `/v2/user/crypto-quote` para obtener un tipo de cambio en tiempo real entre una criptomoneda y una moneda fiat. El `price` siempre se expresa en unidades de fiat por 1 unidad de cripto. Usa `from` y `to` para elegir el lado: cuando `from` es una moneda fiat del `country` indicado, obtienes el tipo de compra que se usa en órdenes de on-ramp (`fiat_to_crypto`); en caso contrario, `from` se trata como la cripto y obtienes el tipo de venta que se usa en órdenes de off-ramp (`crypto_to_fiat`). Cuando envías `createQuoteId=true`, la API también devuelve un `quoteId` que puedes adjuntar a una orden para fijar ese precio. De forma predeterminada, este endpoint está limitado a 500 solicitudes por minuto por cuenta.

> [!WARNING]
>
> De forma predeterminada, un `quoteId` es válido por **10 segundos** en producción y **300 segundos** en el sandbox, y es de un solo uso. Está vinculado a tu cuenta y al `country`, la cripto y el fiat para los que se emitió; una orden que lo use con una combinación distinta, o después de que expire, se rechaza. Una solicitud de creación de orden puede consumir un `quoteId` aunque esa solicitud se rechace después.

## Solicitud

```text theme={null}
GET /v2/user/crypto-quote
```

### Encabezados

| Encabezado | Valor | Obligatorio |
| - | - | - |
| `X-BH-TOKEN` | Tu token de `GET /v2/token/generate` | ✓ |

### Parámetros de consulta

**country** `string` *required*

Nombre del país para el que se solicita la cotización (p. ej., `"Mexico"`).

**from** `string` *required*

Símbolo de la moneda de origen. Usa el símbolo de una cripto para una cotización de cripto a fiat (p. ej., `"USDT"`) o un código fiat para una cotización de fiat a cripto (p. ej., `"MXN"`).

**to** `string` *required*

Símbolo de la moneda de destino. Usa un código fiat para una cotización de cripto a fiat (p. ej., `"MXN"`) o el símbolo de una cripto para una cotización de fiat a cripto (p. ej., `"USDT"`).

**createQuoteId** `boolean`

Cuando es `true`, reserva el tipo de cambio cotizado y devuelve un `quoteId`. Envía este `quoteId` al crear tu orden para fijar el precio. El valor predeterminado es `false`.

## Campos de la respuesta

**code** `number`

Código de estado tipo HTTP. `200` indica éxito.

**msg** `string`

Mensaje de estado legible, p. ej. `"SUCCESS"`.

**data** `object`

Objeto que contiene el tipo de cambio cotizado y la reserva de cotización opcional.

**data**

**price** `string`

Tipo de cambio en unidades de fiat por 1 unidad de cripto (p. ej., `"21.3707"` MXN por USDT), sin importar cómo se configuren `from` y `to`. Cuando `from` es la moneda fiat, es el tipo de compra; cuando `from` es la cripto, es el tipo de venta. Sin un `quoteId`, el tipo de cambio es solo de referencia y la orden se cotiza al momento de crearla.

**quoteId** `string`

Identificador único del tipo de cambio reservado (p. ej., `"e46836d68a4a4a6f8f2f609352cffb2f"`). Solo está presente cuando `createQuoteId=true`. Válido por 10 segundos en producción y 300 segundos en el sandbox; de un solo uso de forma predeterminada.

## Ejemplos

> [tab] Cripto → fiat (solo precio)
>
> Obtén el tipo de cambio actual de USDT a pesos mexicanos sin reservar un precio.
>
> ```bash cURL theme={null}
> curl --request GET \
>   --url 'https://api.velafi.com/v2/user/crypto-quote?country=Mexico&from=USDT&to=MXN' \
>   --header 'X-BH-TOKEN: YOUR_TOKEN'
> ```
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "price": "21.3707"
>   }
> }
> ```

> [tab] Fiat → cripto (con quoteId)
>
> Obtén el tipo de compra de USDT pagado en pesos mexicanos y resérvalo con un `quoteId`. El precio sigue siendo MXN por USDT.
>
> ```bash cURL theme={null}
> curl --request GET \
>   --url 'https://api.velafi.com/v2/user/crypto-quote?country=Mexico&from=MXN&to=USDT&createQuoteId=true' \
>   --header 'X-BH-TOKEN: YOUR_TOKEN'
> ```
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "price": "21.4104",
>     "quoteId": "e46836d68a4a4a6f8f2f609352cffb2f"
>   }
> }
> ```

> [!NOTE]
>
> El campo `price` es un tipo de cambio de referencia. Refleja el precio de mercado actual, pero no garantiza la ejecución a ese tipo de cambio a menos que tengas un `quoteId` válido y envíes tu orden dentro de la ventana de reserva.

> [!TIP]
>
> Para aumentar la probabilidad de usar un `quoteId` antes de que expire, solicita la cotización justo antes de enviar la orden, no durante los flujos en los que el usuario captura datos.


## Related topics

- [Obtener una cotización fiat/fiat](https://docs.velafi.com/es/api-reference/quote/get-user-quote-for-fiat-fiat.md)
- [Off-ramp (cripto a fiat)](https://docs.velafi.com/es/docs/guides/off-ramp.md)
- [Listar pares cripto→fiat](https://docs.velafi.com/es/api-reference/basic-configuration/get-crypto-fiat-pairs.md)
- [Listar pares fiat→cripto](https://docs.velafi.com/es/api-reference/basic-configuration/get-fiat-crypto-pairs.md)
- [Obtener una orden](https://docs.velafi.com/es/api-reference/order/retrieve-a-specific-order.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.