> ## 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 fiat/fiat

> Obtén un tipo de cambio en tiempo real para un corredor de pagos globales de fiat a fiat. Opcionalmente, fija el tipo de cambio con un quoteId de un solo uso.

Usa el endpoint **GET** `/v2/user/fiat-quote` para obtener un tipo de cambio en tiempo real para convertir una moneda fiat en otra mediante los rieles de stablecoin de VelaFi. Especifica el país y la moneda de origen y de destino como parámetros de consulta. Cuando estableces `createQuoteId=true`, la API también devuelve un `quoteId` que puedes adjuntar a una orden de pago para fijar ese precio. Este endpoint está limitado a 500 solicitudes por minuto por cuenta.

> [!WARNING]
>
> Un `quoteId` es válido durante **20 segundos** en producción y **300 segundos** en el sandbox. Está vinculado a tu cuenta y al corredor (país y fiat de on-ramp, país y fiat de off-ramp) para el que se emitió; una orden para un corredor distinto, o creada después de que expire, se rechaza. Un `quoteId` es de un solo uso, y una solicitud de creación de orden puede consumirlo aunque esa solicitud se rechace después.

## Solicitud

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

### Encabezados

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

### Parámetros de consulta

**onRampCountry** `string` *required*

Nombre del país de origen (por ejemplo, `"Mexico"`).

**onRampFiat** `string` *required*

Código ISO 4217 de la moneda fiat de origen (la que se envía) (por ejemplo, `"MXN"`).

**offRampCountry** `string` *required*

Nombre del país del destinatario (por ejemplo, `"Argentina"`).

**offRampFiat** `string` *required*

Código ISO 4217 de la moneda fiat del destinatario (la que se recibe) (por ejemplo, `"ARS"`).

**createQuoteId** `boolean`

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

## Campos de la respuesta

**code** `number`

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

**msg** `string`

Mensaje de estado legible, por ejemplo `"SUCCESS"`.

**data** `object`

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

**data**

**price** `string`

Tipo de cambio actual que expresa cuántas unidades de `offRampFiat` compra una unidad de `onRampFiat` (por ejemplo, `"56.14266017"`). Este tipo de cambio es solo de referencia y no garantiza el precio final de ejecución a menos que se haya solicitado un `quoteId`.

**quoteId** `string`

Identificador único del tipo de cambio reservado (por ejemplo, `"e46836d68a4a4a6f8f2f609352cffb2f"`). Solo está presente cuando `createQuoteId=true`. Es válido durante 20 segundos en producción y 300 segundos en el sandbox; de un solo uso.

## Ejemplos

> [tab] MXN → ARS (solo precio)
>
> Obtén el tipo de cambio actual de pesos mexicanos a pesos argentinos sin reservar un precio.
>
> ```bash cURL theme={null}
> curl --request GET \
>   --url 'https://api.velafi.com/v2/user/fiat-quote?onRampCountry=Mexico&onRampFiat=MXN&offRampCountry=Argentina&offRampFiat=ARS' \
>   --header 'X-BH-TOKEN: YOUR_TOKEN'
> ```
>
> ```json Respuesta theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "price": "56.14266017"
>   }
> }
> ```

> [tab] ARS → MXN (con quoteId)
>
> Obtén el tipo de cambio de pesos argentinos a pesos mexicanos y resérvalo con un `quoteId`.
>
> ```bash cURL theme={null}
> curl --request GET \
>   --url 'https://api.velafi.com/v2/user/fiat-quote?onRampCountry=Argentina&onRampFiat=ARS&offRampCountry=Mexico&offRampFiat=MXN&createQuoteId=true' \
>   --header 'X-BH-TOKEN: YOUR_TOKEN'
> ```
>
> ```json Respuesta theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "price": "0.0160686",
>     "quoteId": "e46836d68a4a4a6f8f2f609352cffb2f"
>   }
> }
> ```

> [!NOTE]
>
> El campo `price` es un tipo de cambio de referencia. Refleja el tipo de cambio 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 de pago dentro de la ventana de reserva.

> [!TIP]
>
> Solicita una cotización nueva justo antes de enviar una orden de pago, en lugar de guardar en caché un tipo de cambio de una interacción anterior del usuario. Los tipos de cambio de los corredores fiat pueden moverse rápidamente.


## Related topics

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


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