快速開始
10 分鐘內完成第一次 API 呼叫
1. 建立 API Key
在控制台建立您的第一個 API Key
- 前往 帳戶設定 → API 金鑰
- 點選「建立 API 金鑰」按鈕
- 輸入金鑰名稱（例如：正式環境）
- 複製並儲存產生的 API Key（僅顯示一次）
⚠️ API Key 僅在建立時顯示一次，請妥善儲存
2. 發送第一個請求
使用 curl 測試 API 連線
取得錢包餘額
BASE_URL=... # 實際正式環境網域
API_KEY=ak_live_...
curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/wallet/balance"響應範例
{
"data": {
"balanceSun": 1000000,
"frozenSun": 0,
"totalSun": 1000000
}
}
// 單位與類型說明見 <a href="/zh-TW/docs/endpoints" class="text-blue-600 hover:underline">介面一覽</a>3. 建立能量訂單
為指定位址租賃能量
建立訂單
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 字元，T 開頭
// durationHours: 1, 24, 72, 168, 336, 720（小時）響應範例
{
"data": {
"id": 1234567890,
"status": "processing",
"priceSun": 3000000,
"createdAt": "2025-01-15T10:30:00Z"
}
}4. 查詢訂單狀態
檢查訂單是否已完成
查詢訂單
curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/energy/orders/1234567890"響應範例
{
"data": {
"id": 1234567890,
"status": "completed",
"txid": "abc123...",
"completedAt": "2025-01-15T10:30:05Z"
}
}