Entornos
Aeses ofrece dos entornos completamente aislados: modo de prueba y modo live. No comparten nada — claves separadas, libros mayores separados, endpoints de webhook separados y redes blockchain separadas.
Chains soportadas
Aeses soporta actualmente tres familias de chain. Cada familia se selecciona vía el parámetro chain en los endpoints de creación y acepta los activos listados abajo.
| Valor de chain | Familia | Redes live | Redes de prueba | Activos soportados |
| ---------------- | ------- | ---------------- | --------------- | ------------------ |
| ethereum | EVM | Ethereum mainnet | Sepolia | ETH, USDT |
| bitcoin | Bitcoin | Bitcoin mainnet | Bitcoin testnet | BTC |
| tron | Tron | Tron mainnet | Tron Nile | TRX, USDT |
Para obtener la lista viva y legible por máquina, llama a GET /v1/assets.
Cuándo usar cada modo
| Entorno | URL base de la API | Fondos |
| ----------- | ------------------ | ---------------------------- |
| Modo prueba | https://api.aeses.io | Tokens de prueba sin valor |
| Modo live | https://api.aeses.io | Valor real, liquidación real |
La URL base es idéntica — Aeses enruta la solicitud según el prefijo de la clave (sk_test_… vs. sk_live_…). No existe un host api.test.aeses.io.
Qué está aislado
- Claves. Una clave de prueba no puede leer datos de live, ni viceversa. Las solicitudes cruzadas devuelven
401 key_environment_mismatch. - Recursos. Prueba y live tienen cada uno sus propios deposits, withdrawals, balances, webhook deliveries y endpoints de webhook.
- Webhooks. Los endpoints de prueba reciben únicamente eventos de prueba.
- Rate limits. Prueba y live tienen buckets de rate limit independientes.
Obtener fondos de testnet
Usa los faucets recomendados en la documentación de tu red:
- Sepolia ETH — sepoliafaucet.com
- Bitcoin testnet — coinfaucet.eu/en/btc-testnet
- Tron Nile — nileex.io/join/getJoinPage
Los fondos de testnet no tienen valor de mercado. Existen solo para validar integraciones.
Pasar a producción
Cuando estés listo para aceptar pagos reales:
- Completa el perfil de negocio en el panel.
- Crea una API key
sk_live_. - Actualiza el secreto en tu entorno de producción.
- Configura tu endpoint de webhook de live y pruébalo desde Developers → Webhooks → Enviar evento de prueba.
- Ejecuta una transacción end-to-end pequeña para validar el flujo completo.