快速开始
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-CN/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"
}
}