Recarga automática
La Recarga automática vigila una dirección TRON y la recarga cada vez que su energía o su ancho de banda cae por debajo del nivel que fijes. Tú eliges el umbral, cuánto añadir cada vez y la duración del alquiler. Cada recarga es una orden normal pagada con tu saldo.Cómo funciona
- Crea una regla para una dirección con un umbral, un
add_volumey unaduration. - Comprobamos cuánta energía (o ancho de banda) tiene disponible la dirección una vez por minuto y justo después de cada transferencia USDT saliente desde esa dirección.
- Si el nivel está por debajo del umbral, compramos
add_volumepara la dirección y lo cobramos de tu saldo a tu precio. - El alquiler termina al cumplirse su duración. Cuando el nivel vuelve a caer por debajo del umbral, la regla compra de nuevo. Así es como la regla mantiene abastecida la dirección: no hay un paso de renovación aparte.
last_read_error_at, y la siguiente comprobación lo vuelve a intentar.
Crear una regla no compra nada en el acto. La primera recarga ocurre en la siguiente comprobación, normalmente en menos de un minuto. La respuesta de creación indica si va a ocurrir (will_refill_now) y cuánto tiene la dirección en este momento.
La Recarga automática reacciona después de que el nivel baja; no se adelanta a una transferencia. Fija el umbral en al menos lo que necesita tu próxima transacción, para que la transacción ya esté cubierta cuando se envíe.
Energía y ancho de banda
Los dos recursos tienen sus propios endpoints y sus propias reglas. Una dirección puede tener a la vez una regla de energía y una regla de ancho de banda; cada una se compara con su propio umbral.
La energía se alquila por una hora. Cuando se agota o vence, el nivel baja y la regla compra la hora siguiente.
El ancho de banda cuenta todo aquello con lo que la dirección puede pagar una transacción: los 600 de ancho de banda gratuitos que cada cuenta recibe al día, más cualquier ancho de banda obtenido por stake o recibido por delegación. Por eso un umbral de 600 o menos se cumple solo con la asignación gratuita hasta que la dirección la gasta.
Cómo elegir los valores
Una transferencia USDT consume unos 65,000 de energía cuando el destinatario ya tiene USDT y unos 131,000 cuando no, más aproximadamente 345 de ancho de banda. Por ejemplo,threshold_energy: 65000 con add_volume: 131000 compra energía para dos transferencias cada vez que queda menos de la necesaria para una.
Coste
Cada recarga es una orden normal: el alquiler a tu tarifa más la comisión fija, que se cobra en cada recarga.estimated_cost_per_refill_trx en las respuestas de listado y de creación es el precio completo de una recarga para tu cuenta, comisión fija incluida. Para ver ese precio antes de crear una regla, usa el endpoint de cotización: energía, ancho de banda. Un add_volume pequeño que se recarga a menudo paga la comisión fija muchas veces; uno más grande la paga con menos frecuencia.
Una regla creada con una clave API tiene el precio de una compra hecha con esa clave API; una regla creada en el sitio web tiene el precio de una compra en el sitio web. estimated_cost_per_refill_trx ya lo tiene en cuenta.
Si la dirección todavía no existe on-chain, la primera recarga también la activa, igual que una compra normal. La activación se cobra aparte y no forma parte de estimated_cost_per_refill_trx; la orden la muestra en activation_cost_trx.
No hay un tope de gasto diario: una regla compra siempre que el nivel esté por debajo de su umbral y tu saldo cubra una recarga.
Órdenes y webhooks
Cada recarga aparece en tu historial de órdenes (Listar órdenes) consource: "autorefill". Para listar solo las órdenes de recarga, llama a GET /orders?source=autorefill; para exportarlas como archivo, usa el informe autorefill.
Las reglas creadas con una clave API envían webhooks order.updated por sus órdenes de recarga, igual que las órdenes que creas a través de la API. Las reglas creadas sin clave API no los envían.
Estado de la regla
Pausada tras fallos. Una recarga fallida se reembolsa como cualquier orden fallida. Tras 5 recargas fallidas seguidas la regla se pausa y
stopped_reason indica el motivo del último fallo. consecutive_failures muestra cuán cerca está una regla de ese límite; vuelve a 0 tras una recarga exitosa y cuando reanudas la regla. Una regla pausada nunca se reanuda sola: corrige la causa y luego establece status: "active".
Detenida por saldo. Cuando tu saldo no alcanza para una recarga, la regla se detiene con stopped_insufficient_balance. En cuanto un depósito eleva el saldo hasta el precio de una recarga, la regla vuelve a active automáticamente. También puedes establecer status: "active" tú mismo; si el saldo sigue sin alcanzar, la regla se detiene de nuevo en la siguiente comprobación.
Si tu cuenta de Telegram está vinculada, recibes un mensaje en la primera recarga de una regla y cuando una regla se pausa, se detiene por saldo o se reanuda.
Límites
- Una regla por dirección y recurso en cada cuenta. Crear una segunda regla de energía (o una segunda regla de ancho de banda) para la misma dirección devuelve
409 AUTOREFILL_ADDRESS_TAKEN— edita la regla existente en su lugar. - 20 reglas de energía y 20 reglas de ancho de banda por cuenta. Las reglas eliminadas no cuentan. Por encima del límite:
409 AUTOREFILL_LIMIT_REACHED. - Sin direcciones de contrato, como el contrato del token USDT: TRON no permite delegarles recursos.
- La creación de reglas está limitada a 10 solicitudes por minuto por cuenta, para cada recurso. Ver Límites de tasa.
Edición y eliminación
Los cambios se aplican desde la siguiente comprobación. Mientras se compra una recarga para la regla,PATCH y DELETE devuelven 409 AUTOREFILL_IN_PROGRESS — reintenta en un minuto. Eliminar una regla no recupera la energía ni el ancho de banda ya comprados; esos alquileres siguen hasta el final de su plazo.