Billetera cripto
Listar depósitos cripto
Lista los depósitos de cripto on-chain recibidos en las billeteras de tus comercios en VelaFi, del más reciente al más antiguo, con filtros por token, hash de transacción, comercio y rango de tiempo.
GET
/
v2
/
assets
/
depositOrders
Listar depósitos cripto
curl --request GET \
--url https://api-test.velafi.com/v2/assets/depositOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/depositOrders"
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/depositOrders', 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/depositOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"orderId": 123,
"merchantId": 123,
"time": 123,
"crypto": "<string>",
"cryptoName": "<string>",
"cryptoAmount": "<string>",
"address": "<string>",
"addressTag": "<string>",
"fromAddress": "<string>",
"fromAddressTag": "<string>",
"status": 123,
"txId": "<string>",
"txIdUrl": "<string>"
}
]
}Usa este endpoint para listar los depósitos de cripto recibidos en las billeteras de tus comercios. Los resultados se ordenan del más reciente al más antiguo, y una sola llamada devuelve hasta
pageSize registros. Para consultar más atrás, acota la ventana con startTime y endTime.
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/depositOrders
Parámetros de consulta
number
Filtra por ID del comercio.
string
Filtra por símbolo del token, por ejemplo
USDT.string
Filtra por hash de la transacción on-chain.
number
Devuelve solo los depósitos creados en este momento o después (marca de tiempo Unix en milisegundos).
number
Devuelve solo los depósitos 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 predeterminado es 10.Campos de la respuesta
number
200 indica éxito.string
SUCCESS cuando la solicitud es exitosa.array
Mostrar campos de cada elemento de data
Mostrar campos de cada elemento de data
number
ID del registro de depósito.
number
Comercio que recibió el depósito.
number
Momento en que se creó el registro de depósito (marca de tiempo Unix en milisegundos).
string
Símbolo del token.
string
Nombre del token. Actualmente es igual a
crypto.string
Monto depositado.
string
Actualmente devuelve el mismo valor que
fromAddress (la dirección de envío), no tu dirección de depósito de VelaFi.string
Actualmente siempre es una cadena vacía.
string
Dirección de envío.
string
Actualmente siempre es una cadena vacía.
number
Estado del depósito:
1— en proceso2— exitoso3— fallido o cancelado4— cualquier otro estado
string
Hash de la transacción on-chain.
string
Enlace al explorador de bloques de la transacción.
Ejemplo
cURL
curl -G https://api.velafi.com/v2/assets/depositOrders \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "merchantId=151209" \
--data-urlencode "crypto=USDT" \
--data-urlencode "pageSize=50"
⌘I
Listar depósitos cripto
curl --request GET \
--url https://api-test.velafi.com/v2/assets/depositOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/depositOrders"
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/depositOrders', 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/depositOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"orderId": 123,
"merchantId": 123,
"time": 123,
"crypto": "<string>",
"cryptoName": "<string>",
"cryptoAmount": "<string>",
"address": "<string>",
"addressTag": "<string>",
"fromAddress": "<string>",
"fromAddressTag": "<string>",
"status": 123,
"txId": "<string>",
"txIdUrl": "<string>"
}
]
}