Preguntas y respuestas
Lo que preguntan los integradores antes del primer pedido, agrupado y respondido corto. Donde la respuesta pertenece al contrato y no a una costumbre nuestra, la documentación de la API dice lo mismo con detalle.
Energía y precio
¿Qué es la energía de TRON?
Un recurso de la red que paga la ejecución de contratos inteligentes. Con suficiente energía en la cartera de origen, una transferencia USDT casi no quema TRX.
¿Por qué es más barata que quemar?
Quemar valora la energía a la tarifa del protocolo, ~100 sun por unidad, un parámetro de la cadena que la red revisa de vez en cuando; este año lo rebajó. Nosotros conseguimos energía delegada al por mayor y la vendemos a una fracción de esa tarifa; el precio vigente ahora mismo está en la página de precios.
Ver todos los precios →
¿Y si se me pasa la ventana de envío?
En el mode A el cobro se mantiene: la energía se entregó, y lo que usted paga es la entrega. En el mode B no emitimos nada una vez cerrada la ventana, así que la posición falla y la reserva vuelve entera. La ventana viene con cada pedido; construya su flujo alrededor de ella.
¿Puedo comprar energía al por mayor para una sola cartera?
De 65,000 a 50,000,000 unidades de energía por cartera en un solo pedido, con precio por unidad a la tarifa vigente en el momento de crear el pedido. Una posición por cartera, y cuánto de ese volumen puede cubrir el mercado ahora mismo se puede consultar libremente con POST /v1/estimate antes de reservar nada.
Por encima de 131,000 unidades el alquiler debe ser de una hora o más. Si el pedido es todo o nada se decide antes de la primera compra (allow_partial); un déficit posterior a la primera compra se entrega y se factura por lo entregado.
Energía al por mayor en la página de precios →
¿Perder la ventana de envío cuesta lo mismo en los dos modos?
No. En el mode A la energía se entregó, así que el cobro se mantiene — y en el mode C también, donde no hay transferencia que esperar y la posición simplemente vence al cerrarse la ventana. En el mode B no emitimos nada una vez cerrada la ventana: una transferencia enviada tarde encontraría una cartera de la que la energía delegada ya se retiró, y quemaría su TRX. La posición se cierra como failed con broadcast_window_missed, la reserva vuelve entera y la energía que compramos para ella es pérdida nuestra.
Dinero y devoluciones
¿Cómo se paga?
Saldo de servicio prepagado, denominado en TRX: envíe TRX a su dirección personal y gástelo en servicios. Los precios se fijan al crear el pedido.
¿Qué token puedo enviar a mi dirección de depósito?
TRX, y solo TRX. El USDT enviado a una dirección de depósito no se acredita automáticamente: no asumimos riesgo de tipo de cambio ni operamos un servicio de conversión, así que queda apartado para que lo mire una persona y acreditarlo es decisión nuestra caso por caso. ¿Envió el token equivocado? Escríbanos y no envíe más.
¿Cuándo puedo gastar un depósito?
Tras 3 confirmaciones, unos diez segundos. El saldo se informa entonces en tres partes: el total, lo reservado para pedidos en curso y lo disponible. El pedido se crea desde la parte disponible, nunca desde el total.
¿Puedo cancelar un pedido?
Solo antes de que empiece la compra; después la respuesta es order_not_cancelable, porque la energía ya está comprada. Un pedido cancelado libera su reserva íntegra y no cobra nada.
¿Y las devoluciones?
Las liberaciones son automáticas y nunca hacen falta tickets. La regla es una: la energía que no entregamos no se cobra, y la reserva vuelve a su saldo en crédito de servicio — una entrega fallida, un pedido cancelado antes de que empezara la compra, la parte no gastada de un día de Auto-refill. La energía entregada se cobra, la haya usado o no. Una excepción: eliminar una regla de Auto-refill antes de que sus recargas hayan cubierto lo que pagamos por adelantado a nuestro proveedor por su cartera cobra la parte no cubierta.
Seguridad y claves
¿Qué claves necesitan?
Ninguna. El mode A nunca ve su transacción. El mode B recibe una que usted ya firmó, y no podemos alterar ni un byte de ella.
¿Aceptan un remitente con multifirma?
En el mode B, no: la transacción debe llevar exactamente una firma del propietario, con Permission_id 0. El conjunto de claves de una cuenta multifirma vive en la red y cambia sin que lo sepamos, así que no podemos prometer que la emisión sea aceptada. En el mode A nada de cómo firma usted llega hasta nosotros: la transferencia la emite usted mismo.
¿Qué guardan y durante cuánto tiempo?
En el mode B su transacción firmada se guarda cifrada y se borra 7 días después de que el pedido alcance un estado final. Los pedidos, los asientos del libro y los depósitos se quedan: eso es contabilidad, y es lo que estamos obligados a conservar. De usted no hay nada más aquí: ni claves privadas, ni frases semilla, ni custodia de sus fondos.
Integración
¿Hay límites?
120 pedidos por minuto y clave, hasta 500 transferencias por pedido en lote. Al pasarse del límite recibe Retry-After, no un descarte en silencio.
¿Qué significa completed en realidad?
Que la energía se entregó, no que su transferencia se envió. El compromiso es la entrega, y el pedido se cierra con ella: en el mode A completed puede llegar antes de que usted haya enviado nada. Vigile la aparición de send_before en el pedido y no la palabra ready: consultando cada dos segundos puede no ver ready ni una sola vez.
¿Cómo funciona la idempotencia?
Una Idempotency-Key queda ligada a los bytes crudos del cuerpo con el que llegó. La misma clave con un cuerpo idéntico byte a byte devuelve el mismo pedido; la misma clave con otro cuerpo es un conflicto; una petición rechazada por la validación no gasta la clave, así que puede repetirla con la misma clave una vez corregido el cuerpo. Serialice el cuerpo una vez y reenvíe esos mismos bytes: otro orden de claves o un espacio de más ya es otro cuerpo.
¿Puedo comprobar una dirección sin pagar nada?
Sí, y es gratis. GET /v1/address-check cuenta lo que sabemos de una cartera, y POST /v1/estimate calcula hasta 500 destinatarios con las mismas reglas que usaría un pedido, incluido cuáles de ellos están en la lista negra del contrato del token. Ninguno de los dos reserva nada ni cobra nada.
Su cuenta
¿Puede una cartera mantenerse recargada sola?
Sí: una regla de Auto-refill, una dirección más un presupuesto diario. La energía se rellena después de cada transferencia; el presupuesto es un techo diario infranqueable.
¿En cuánto conviene poner balance.low?
El número lo pone usted — balance_low_threshold_trx en PATCH /v1/settings; balance.low es el evento que salta con él. La medida útil es aproximadamente su movimiento de un día: así el aviso llega un día antes de que los pedidos empiecen a recibir insufficient_balance, en vez de llegar en lugar del primer rechazo. Bastante más bajo y el evento es un aviso a posteriori; bastante más alto y es ruido. Cero lo apaga.
¿Puede mi equipo de operaciones tener acceso de solo lectura?
Sí. Una cuenta admite tantas personas como usted invite, cada una con uno de cuatro roles — viewer, member, admin, owner — y cada rol hace todo lo que hace el anterior. Un viewer lee el saldo, el libro, los pedidos y la tarifa, y no puede gastar nada; un member crea pedidos y estimaciones; un admin gestiona claves de API, webhooks, configuración y el equipo; el owner es la cuenta. Una invitación otorga viewer, member o admin; el owner es la cuenta y no se invita. Las invitaciones y los roles viven en el panel, y solo rigen el panel: una clave de API pertenece a la cuenta, no a una persona, y tiene acceso completo sin importar quién la haya creado.
¿Hay un entorno de pruebas o un volumen mínimo?
Ni volumen mínimo, ni suscripción, ni pago por estar parado. Entorno de pruebas sí hay: https://sandbox.nrg.market/v1 es la misma API sobre dinero de prueba y una red simulada, y sandbox-app.nrg.market emite las claves nrg_test_… de ese entorno. Demuestra su lado de la integración — formatos de petición, estados, webhooks, tiempos — pero no que la energía llegue on-chain; eso se aprende en producción. En el host de producción, los endpoints de consulta, una estimación y una prueba de webhook siguen sin costar nada.
https://sandbox.nrg.market/v1
sandbox-app.nrg.market