Cotizaciones
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.
GET
/
v2
/
user
/
crypto-quote
Obtener una cotización cripto/fiat
curl --request GET \
--url https://api-test.velafi.com/v2/user/crypto-quote \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/user/crypto-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/crypto-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/crypto-quote")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"price": "<string>",
"quoteId": "<string>"
}
}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.
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
GET /v2/user/crypto-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 para el que se solicita la cotización (p. ej.,
"Mexico").string
requerido
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").string
requerido
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").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
number
Código de estado tipo HTTP.
200 indica éxito.string
Mensaje de estado legible, p. ej.
"SUCCESS".object
Objeto que contiene el tipo de cambio cotizado y la reserva de cotización opcional.
Mostrar data
Mostrar data
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.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
- Cripto → fiat (solo precio)
- Fiat → cripto (con quoteId)
Obtén el tipo de cambio actual de USDT a pesos mexicanos sin reservar un precio.
cURL
curl --request GET \
--url 'https://api.velafi.com/v2/user/crypto-quote?country=Mexico&from=USDT&to=MXN' \
--header 'X-BH-TOKEN: YOUR_TOKEN'
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"price": "21.3707"
}
}
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.cURL
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'
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"price": "21.4104",
"quoteId": "e46836d68a4a4a6f8f2f609352cffb2f"
}
}
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.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.⌘I
Obtener una cotización cripto/fiat
curl --request GET \
--url https://api-test.velafi.com/v2/user/crypto-quote \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/user/crypto-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/crypto-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/crypto-quote")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"price": "<string>",
"quoteId": "<string>"
}
}