Cotizaciones
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.
GET
/
v2
/
user
/
fiat-quote
Obtener una cotización fiat/fiat
curl --request GET \
--url https://api-test.velafi.com/v2/user/fiat-quote \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/user/fiat-quote"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/user/fiat-quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/user/fiat-quote")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"price": "<string>",
"quoteId": "<string>"
}
}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.
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
GET /v2/user/fiat-quote
Encabezados
| Encabezado | Valor | Obligatorio |
|---|---|---|
X-BH-TOKEN | Tu token de GET /v2/token/generate | ✓ |
Parámetros de consulta
string
requerido
Nombre del país de origen (por ejemplo,
"Mexico").string
requerido
Código ISO 4217 de la moneda fiat de origen (la que se envía) (por ejemplo,
"MXN").string
requerido
Nombre del país del destinatario (por ejemplo,
"Argentina").string
requerido
Código ISO 4217 de la moneda fiat del destinatario (la que se recibe) (por ejemplo,
"ARS").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
number
Código de estado de tipo HTTP.
200 indica éxito.string
Mensaje de estado legible, por ejemplo
"SUCCESS".object
Objeto que contiene el tipo de cambio cotizado y la reserva opcional de la cotización.
Mostrar data
Mostrar data
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.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
- MXN → ARS (solo precio)
- ARS → MXN (con quoteId)
Obtén el tipo de cambio actual de pesos mexicanos a pesos argentinos sin reservar un precio.
cURL
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'
Respuesta
{
"code": 200,
"msg": "SUCCESS",
"data": {
"price": "56.14266017"
}
}
Obtén el tipo de cambio de pesos argentinos a pesos mexicanos y resérvalo con un
quoteId.cURL
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'
Respuesta
{
"code": 200,
"msg": "SUCCESS",
"data": {
"price": "0.0160686",
"quoteId": "e46836d68a4a4a6f8f2f609352cffb2f"
}
}
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.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.
⌘I
Obtener una cotización fiat/fiat
curl --request GET \
--url https://api-test.velafi.com/v2/user/fiat-quote \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/user/fiat-quote"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/user/fiat-quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/user/fiat-quote")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"price": "<string>",
"quoteId": "<string>"
}
}