Tus tickets de prefondeo

GET/prefondeosProbar

ServidorURL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)

Parámetros de consultaestadolimitinteger

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

GET

/prefondeos

const url = 'http://localhost:3000/v1/prefondeos?estado=cotizado&limit=50';
const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'http://localhost:3000/v1/prefondeos?estado=cotizado&limit=50' \
  --header 'x-api-key: <x-api-key>'

Scope treasury:read. Del más reciente al más antiguo.

Authorizations

ApiKeyAuth

Parameters

Query Parameters

estado

cotizado → enviado (avisaste) → recibido (nuestro equipo lo vio en la red) → cargado (otra persona aprobó: tienes los Bs) → consumido (saldo en 0; vuelve a cargado si se revierte un pago). vencido si no avisaste a tiempo; rechazado si lo cancelaste o no llegó.

string

Allowed values: cotizado enviado recibido cargado consumido vencido rechazado

limit

integer

default: 50 >= 1 <= 200

Responses

200

Tickets

application/json

object

data

Array<object>

Un ticket de prefondeo. Montos en minor units como texto: micro-USDT (6 decimales) y céntimos de Bs. Tasas en Bs por 1 USDT con 8 decimales.

object

string format: uuid

estado

string

Allowed values: cotizado enviado recibido cargado consumido vencido rechazado

origen

pruebas: tu prefondeo de pruebas, ya cargado con Bs simulados (sin wallet)

string

Allowed values: cotizado manual excedente pruebas

red

Red donde se reciben los USDT

string

direccion

Wallet de recepción (la fija nuestro equipo). null en tu cuenta de pruebas o con una sk_test_

string

nullable

activo

string

Allowed values: USDT

usdtCotizado

string

bsCotizado

string

tasa

Tasa amarrada (con spread)

string

tasaMercado

string

nullable

spreadBps

integer

venceEn

string format: date-time

nullable

referencia

string

nullable

usdtEnviado

string

nullable

enviadoEn

string format: date-time

nullable

usdtRecibido

string

nullable

recibidoEn

string format: date-time

nullable

recibidoTarde

Llegó en la red después de venceEn; se cargó a la tasa de ese momento

boolean

tasaAplicada

La tasa con la que se cargaron los Bs

string

nullable

usdtCargado

string

nullable

bsCargado

string

nullable

usdtExcedente

USDT que llegaron de más (no se cargan en este ticket)

string

excedenteDestino

string

nullable

Allowed values: ticket_nuevo devuelto_fuera

saldoBs

Bs que le quedan al ticket

string

usdtConsumido

Costo en USDT de lo ya gastado

string

cargadoEn

string format: date-time

nullable

motivoRechazo

string

nullable

simulado

Cargado desde la cuenta de pruebas: no es dinero real

boolean

direccionOrigen

El from de la transferencia que anotó nuestro equipo (una de tus wallets de origen)

string

nullable

walletOrigenId

Tu wallet de origen registrada

string format: uuid

nullable

esperaWalletHasta

El USDT llegó desde una wallet sin registrar: el ticket espera hasta aquí (72 h, con su tasa) a que la registres y la aprobemos

string format: date-time

nullable

caducaEn

Sólo tu prefondeo de pruebas: a esta hora se cierra su saldo simulado (te llega prefondeo.vencido)

string format: date-time

nullable

creadoEn

string format: date-time

actualizadoEn

string format: date-time

Example

{
  "data": [
    {
      "estado": "cotizado",
      "origen": "cotizado",
      "activo": "USDT",
      "excedenteDestino": "ticket_nuevo"
    }
  ]
}