クイックスタート

10分で最初のAPI呼び出しを完了

1. APIキーを作成

ダッシュボードで最初のAPIキーを作成

アカウント設定 → APIキーに移動
「APIキーを作成」ボタンをクリック
キー名を入力(例:本番環境)
生成されたAPIキーをコピーして保存(一度のみ表示)

⚠️ APIキーは作成時に一度のみ表示されます。安全に保存してください。

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="/ja/docs/endpoints" class="text-blue-600 hover:underline">APIエンドポイント</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"
  }
}

次のステップ

認証について学ぶ →

完全なエンドポイントリストを表示 →

エラー処理を学ぶ →