Billetera cripto
Listar retiros cripto
Lista los retiros de cripto de la billetera de un comercio de VelaFi, del más reciente al más antiguo, filtrados por token, clientId y rango de tiempo.
GET
/
v2
/
assets
/
withdrawalOrders
Listar retiros cripto
curl --request GET \
--url https://api-test.velafi.com/v2/assets/withdrawalOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/withdrawalOrders"
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/assets/withdrawalOrders', 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/assets/withdrawalOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"orderId": 123,
"merchantId": 123,
"time": 123,
"crypto": "<string>",
"cryptoName": "<string>",
"address": "<string>",
"addressTag": "<string>",
"cryptoAmount": "<string>",
"fee": "<string>",
"feeCrypto": "<string>",
"arriveCryptoAmount": "<string>",
"status": 123,
"txId": "<string>",
"txIdUrl": "<string>",
"remark": "<string>"
}
]
}Usa este endpoint para dar seguimiento a los retiros de cripto desde la billetera de un comercio hacia direcciones externas, incluidos los creados con Crear retiro de cripto. Para recibir una notificación cuando un retiro llegue a su estado final, suscríbete al Evento de retiro de cripto. También puedes consultar periódicamente este endpoint por
clientId hasta que status sea 6, 7 o 9, por ejemplo para conciliar retiros cuyo webhook no recibiste. Los reembolsos de pagos con stablecoin de esta lista no disparan el webhook. La lista también puede incluir otros registros de tipo retiro, como pagos masivos. Los retiros a una dirección de billetera de VelaFi se registran como transferencias internas y aparecen en el Historial de transferencias de cripto. Los resultados se ordenan del más reciente al más antiguo, y una sola llamada devuelve hasta pageSize registros. Para encontrar un retiro específico, filtra por clientId.
Todas las solicitudes deben incluir el header
X-BH-TOKEN con un token de negocio obtenido de GET /v2/token/generate.Endpoint
GET https://api.velafi.com/v2/assets/withdrawalOrders
Parámetros de consulta
number
requerido
ID del comercio.
string
Filtra por símbolo del token, por ejemplo
USDT.string
Filtra por el
clientId que enviaste al crear el retiro.number
Solo devuelve retiros creados en este momento o después (marca de tiempo Unix en milisegundos).
number
Solo devuelve retiros creados en este momento o antes (marca de tiempo Unix en milisegundos).
number
predeterminado:"10"
Número máximo de registros que se devuelven, de
1 a 1000. El valor por defecto es 10.Campos de la respuesta
number
200 indica éxito.string
SUCCESS si la solicitud fue exitosa.array
Mostrar Campos de cada elemento de data
Mostrar Campos de cada elemento de data
number
ID del registro de retiro. Coincide con el
orderId devuelto por Crear retiro de cripto.number
Comercio cuya billetera se debitó.
number
Momento en que se creó el registro de retiro (marca de tiempo Unix en milisegundos).
string
Símbolo del token.
string
Nombre del token. Actualmente es igual a
crypto.string
Dirección de destino.
string
Memo o tag de destino, si existe.
string
Monto del retiro.
string
Comisión de red.
string
Token en el que se expresa la comisión. Siempre es igual a
crypto.string
cryptoAmount menos fee.number
Estado del retiro:
5: en proceso, incluidos los retiros retenidos para la auditoría interna de VelaFi6: exitoso7: fallido9: cancelado0: cualquier otro estado, por ejemplo mientras el retiro espera la aprobación de una subcuenta o está retenido por una solicitud de información de riesgo (RFI)
string
Hash de la transacción on-chain, cuando esté disponible.
string
Link al explorador de bloques de la transacción.
string
El
remark que enviaste al crear el retiro.Ejemplo
cURL
curl -G https://api.velafi.com/v2/assets/withdrawalOrders \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "merchantId=151209" \
--data-urlencode "clientId=withdraw-0001"
⌘I
Listar retiros cripto
curl --request GET \
--url https://api-test.velafi.com/v2/assets/withdrawalOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/withdrawalOrders"
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/assets/withdrawalOrders', 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/assets/withdrawalOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"orderId": 123,
"merchantId": 123,
"time": 123,
"crypto": "<string>",
"cryptoName": "<string>",
"address": "<string>",
"addressTag": "<string>",
"cryptoAmount": "<string>",
"fee": "<string>",
"feeCrypto": "<string>",
"arriveCryptoAmount": "<string>",
"status": 123,
"txId": "<string>",
"txIdUrl": "<string>",
"remark": "<string>"
}
]
}