Início Rápido
Complete sua primeira chamada de API em 10 minutos
1. Criar API Key
Crie sua primeira API Key no painel de controle
- Acesse Configurações da Conta → API Keys
- Clique no botão "Criar API Key"
- Insira um nome para a chave (exemplo: Produção)
- Copie e salve a API Key gerada (exibida apenas uma vez)
⚠️ A API Key é exibida apenas uma vez durante a criação. Por favor, guarde-a com segurança.
2. Enviar Primeira Requisição
Teste a conexão da API usando curl
Obter saldo da carteira
BASE_URL=... # Domínio real do ambiente de produção
API_KEY=ak_live_...
curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/wallet/balance"Exemplo de resposta
{
"data": {
"balanceSun": 1000000,
"frozenSun": 0,
"totalSun": 1000000
}
}
// Para explicações sobre unidades e tipos de dados, consulte <a href="/pt/docs/endpoints" class="text-blue-600 hover:underline">Endpoints da API</a>3. Criar Pedido de Energia
Alugue energia para um endereço especificado
Criar 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, começa com T
// durationHours: 1, 24, 72, 168, 336, 720 (horas)Exemplo de resposta
{
"data": {
"id": 1234567890,
"status": "processing",
"priceSun": 3000000,
"createdAt": "2025-01-15T10:30:00Z"
}
}4. Verificar Status do Pedido
Verifique se o pedido foi concluído
Consultar pedido
curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/energy/orders/1234567890"Exemplo de resposta
{
"data": {
"id": 1234567890,
"status": "completed",
"txid": "abc123...",
"completedAt": "2025-01-15T10:30:05Z"
}
}