빠른 시작
10분 안에 첫 API 호출을 완료하세요
1. API 키 생성
콘솔에서 첫 번째 API 키를 생성합니다
- 계정 설정 → API 키로 이동합니다
- "API 키 생성" 버튼을 클릭합니다
- 키 이름을 입력합니다 (예: Production)
- 생성된 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="/ko/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"
}
}