Inicio Rápido
Complete su primera llamada a la API en 10 minutos
1. Crear una Clave API
Cree su primera clave API en el panel de control
- Vaya a Configuración de Cuenta → Claves API
- Haga clic en el botón "Crear Clave API"
- Ingrese un nombre para la clave (por ejemplo, Producción)
- Copie y guarde la clave API generada (se muestra solo una vez)
⚠️ Las claves API se muestran solo una vez durante su creación. Por favor, guárdela de forma segura.
2. Enviar su Primera Solicitud
Pruebe la conexión a la API usando curl
Obtener Saldo de Billetera
BASE_URL=... # Dominio de producción real
API_KEY=ak_live_...
curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/wallet/balance"Ejemplo de Respuesta
{
"data": {
"balanceSun": 1000000,
"frozenSun": 0,
"totalSun": 1000000
}
}
// Para explicaciones de unidades y tipos, consulte <a href="/es/docs/endpoints" class="text-blue-600 hover:underline">Endpoints de API</a>3. Crear un Pedido de Energía
Alquile energía para una dirección específica
Crear Pedido
curl -X POST "$BASE_URL/v1/energy/orders" \
-H "Authorization: ApiKey $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "manual",
"data": {
"tronAddress": "TYour1Address2Here3...",
"energyValue": 65000,
"durationHours": 1
}
}'
// tronAddress: 34 caracteres, comienza con T
// durationHours: 1, 24, 72, 168, 336, 720 (horas)Ejemplo de Respuesta
{
"data": {
"id": 1234567890,
"status": "processing",
"priceSun": 3000000,
"createdAt": "2025-01-15T10:30:00Z"
}
}4. Verificar Estado del Pedido
Verifique si el pedido se ha completado
Consultar Pedido
curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/energy/orders/1234567890"Ejemplo de Respuesta
{
"data": {
"id": 1234567890,
"status": "completed",
"txid": "abc123...",
"completedAt": "2025-01-15T10:30:05Z"
}
}