DUIYA DEVELOPERS / API V2

에너지 서비스를
내 앱에 연결하세요

DuiYa API로 잔액 조회, 에너지 임대, 관리 주소를 운영하세요.
계정 개설부터 첫 요청까지 여기서 시작하세요.

계정 개설 문의 @wanglei OpenAPI 다운로드

duiya.org / api

GET/user_info

balance_trx TRX 잔액

balance_usdt USDT 잔액

API V2 2.1.0 API 참조 25 ENDPOINTS

01 / GET STARTED

계정 개설 후 연동 시작

먼저 Telegram에서 @wanglei 에게 관리자 계정 개설을 문의하세요.

개설 후 지원팀이 제공한 관리 페이지에 로그인하여 충전 방법, 잔액, API 권한, 현재 요금을 확인하세요.

관리 페이지 로그인 API 사용자 설정에서 계정 정보와 충전 후 사용 가능 잔액을 확인하세요.
IP 허용 목록 추가 API 호출 서버의 외부 공인 IP를 등록하세요. 서버나 외부 IP가 바뀌면 허용 목록도 갱신하세요.
API 호출 활성화 설정을 저장하고 필요한 서비스 권한이 활성화되었는지 확인하세요.
API Key와 API Secret 발급 아래 규칙으로 서버에서 요청에 서명하고 잔액 조회로 설정을 먼저 확인하세요.

충전 및 IP 허용 목록은 관리 페이지에서 설정합니다. 공개 V2에는 IP 추가나 충전 내역 조회 API가 없습니다. /user_info 는 현재 사용 가능한 잔액을 반환합니다.

02 / AUTHENTICATION

세 개의 헤더와 하나의 서명

모든 API는 키·서명 인증을 사용합니다. API Secret은 서버에서 서명 계산에만 사용하고 요청 매개변수로 보내지 마세요.

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

HMAC-SHA256(API Secret, API Key + timestamp)

API Key와 타임스탬프를 구분자 없이 연결하고 소문자 16진수로 출력하세요. 초 단위 타임스탬프는 서버 시간과 ±5분 이내여야 합니다.

Node.js: 서명 및 잔액 조회

Node.js · 서버 예제

import { createHmac } from 'node:crypto';

// 在服务端环境变量中配置，勿放入网页前端。
const apiKey = process.env.DUIYA_API_KEY;
const apiSecret = process.env.DUIYA_API_SECRET;
if (!apiKey || !apiSecret) throw new Error('请先配置 API Key 和 API Secret');

const timestamp = Math.floor(Date.now() / 1000).toString();
const signature = createHmac('sha256', apiSecret)
  .update(apiKey + timestamp)
  .digest('hex');

// 只查询余额；每次请求重新生成时间戳和签名。
const response = await fetch('https://weidubot.cc/api/v2/user_info', {
  method: 'GET',
  headers: {
    'x-api-key': apiKey,
    'x-timestamp': timestamp,
    'x-signature': signature
  }
});
const result = await response.json();
if (!response.ok || result.code !== 1) {
  throw new Error(result.msg || '余额查询失败');
}
console.log(result.data.balance_trx, result.data.balance_usdt);

키는 서버 환경 변수에 저장하세요. 헤더의 타임스탬프는 서명에 사용한 값과 같아야 합니다.

03 / ACCOUNT BALANCE

충전 후 사용 가능 잔액 조회

GEThttps://weidubot.cc/api/v2/user_info

별도 업무 매개변수 없이 인증 헤더 3개를 포함하세요. 다음을 읽습니다: data.balance_trx 및 data.balance_usdt , 두 값은 형식화된 문자열입니다.

JSON · 구조 예시, 실제 잔액 아님

{
  "code": 1,
  "msg": "操作成功",
  "time": "1711961879",
  "data": {
    "balance_trx": "100.5000",
    "balance_usdt": "500.0000"
  }
}

충전, 관리 페이지, IP 허용 목록 관련 문의는 @wanglei . 전체 응답 필드: /user_info .

04 / REQUEST FORMAT

API별 지정된 방식으로 전달

문서 주소: https://duiya.org/api/
API 기본 URL: https://weidubot.cc/api/v2
에너지 구매 경로: /buy_energy
전체 요청 URL: https://weidubot.cc/api/v2/buy_energy

GET 쿼리 매개변수는 URL에 넣습니다. POST는 정의에 따라 폼 또는 쿼리 매개변수를 사용하세요. 에너지 구매는 GET이 아닌 POST입니다. 인증 정보는 항상 헤더에 넣습니다.

참고: /query_fast_recover_price 는 POST를 사용하지만 resource_type 및 count 는 현재 정의에서 URL 쿼리 매개변수입니다.

예제: 에너지 1시간 구매

cURL · 모든 자리 표시자를 바꾼 후 사용

curl --request POST 'https://weidubot.cc/api/v2/buy_energy' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-timestamp: CURRENT_UNIX_SECONDS' \
  --header 'x-signature: HMAC_SHA256_HEX' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'count=65000' \
  --data-urlencode 'period=1h' \
  --data-urlencode 'address=YOUR_TRON_ADDRESS'

이 요청은 유료 주문을 생성합니다. 먼저 /query_price 로 가격, 주소, 수량, 기간, 잔액을 확인하세요. 비동기 주문 제출 후 /query_result 로 실행 결과를 조회하세요.

duiya.org는 문서를 제공합니다. API 요청은 위 서비스 URL로 전송합니다. 예시 가격, 잔액, 수량은 구조 설명용이며 실시간 견적이 아닙니다.

05 / ENERGY SERVICES

업무에 맞는 API 찾기

01 / FAST RECOVER

즉시 충전

충전 요금 확인 후 에너지 또는 대역폭을 구매하고 주문을 추적합니다.

/query_fast_recover_price/buy_fast_recover/query_fast_recover_order

02 / SMART DELEGATION

자동 관리

자동 관리 요금 조회, 한도 배정, 주소 및 이용 내역 관리.

/get_smart_price/delegate_energy_smart/query_energy_smart

03 / ENERGY RENTAL

기간제 임대

수량과 기간으로 견적을 조회하고 주문 후 결과를 확인합니다.

/query_price/buy_energy/query_result

횟수제 에너지, 계정 활성화, 주소 집계, Fragment도 포함됩니다. 이용 권한과 요금은 관리 페이지 및 실제 API 응답을 기준으로 합니다.

06 / ENDPOINT REFERENCE

전체 API 참조 25

API를 펼쳐 매개변수, 응답 필드, 전체 정의를 확인하세요. 유형 이름을 누르면 데이터 모델로 이동합니다.

API 검색

전체 25개 API 표시

계정 관리

사용자 정보 조회 및 계정 활성화.

POST/active_account TRON 주소 활성화

TRON 주소 활성화

주소 활성화 요청을 제출합니다. 해당 요금이 잔액에서 차감됩니다.

전체 URL: https://weidubot.cc/api/v2/active_account

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`address`	string 필수	활성화할 TRON 주소 예시: `"TNewAddressxxxxxxxxxxxxxxxxxxxxxxx"`

응답

HTTP 200 활성화 요청 제출 완료.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	ActivationData 필수로 지정되지 않음	계정 활성화 제출 후 응답 데이터.

HTTP 400 잘못된 요청(주소 형식 등)

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증: 인증 실패

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 403 접근 금지(잔액 부족 등)

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "账户管理 (Account Management)"
  ],
  "summary": "激活 TRON 地址",
  "description": "提交一个激活 TRON 地址的请求。会从账户扣除相应费用。",
  "operationId": "activeAccountV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "需要激活的 TRON 地址",
              "example": "TNewAddressxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "激活请求已提交。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ActivationData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (例如：地址格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权 (认证失败)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (例如：余额不足)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/user_info 사용자 정보 조회

사용자 정보 조회

인증된 사용자의 잔액 등 기본 정보를 조회합니다.

전체 URL: https://weidubot.cc/api/v2/user_info

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

응답

HTTP 200 사용자 정보 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	UserInfoData 필수로 지정되지 않음	사용자 정보 조회 결과.

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "账户管理 (Account Management)"
  ],
  "summary": "获取用户信息",
  "description": "获取当前认证用户的基本信息，例如余额。",
  "operationId": "getUserInfoV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取用户信息。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/UserInfoData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

리소스 주문

TRON 에너지·대역폭 기간 구매 및 주문 조회·관리.

POST/buy_energy 기간제 에너지 구매

기간제 에너지 구매

지정 주소에 선택 기간 동안 에너지를 위임하는 비동기 주문을 제출합니다.

전체 URL: https://weidubot.cc/api/v2/buy_energy

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`count`	integer 필수	위임 에너지 수량(최소 30000) 예시: `50000`
`period`	string 필수	기간(예: "15minutes", "1h", "1day", "3day") 예시: `"1day"`
`address`	string 필수	에너지를 받는 TRON 주소 예시: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

응답

HTTP 200 주문 제출 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	EnergyOrderResponseData 필수로 지정되지 않음	에너지 주문 제출 후 응답 데이터.

HTTP 400 잘못된 요청: 매개변수 오류, 비활성 주소 등

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 403 금지: 잔액 부족 또는 사용자 상태 이상

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "购买能量时长",
  "description": "提交一个异步订单，为指定地址在给定周期内委托能量。",
  "operationId": "buyEnergyV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "count": {
              "type": "integer",
              "description": "委托的能量点数 (最低 30000)",
              "example": 50000
            },
            "period": {
              "type": "string",
              "description": "周期名称 (例如\"15minutes\",\"1h\", \"1day\", \"3day\")",
              "example": "1day"
            },
            "address": {
              "type": "string",
              "description": "接收能量的 TRON 地址",
              "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "count",
            "period",
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "订单已成功提交。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效、地址未激活等)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (余额不足、用户状态异常)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/buy_net 기간제 대역폭 구매

기간제 대역폭 구매

지정 주소에 선택 기간 동안 대역폭을 위임하는 비동기 주문을 제출합니다.

전체 URL: https://weidubot.cc/api/v2/buy_net

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`count`	integer 필수	위임 대역폭 바이트 수(최소 100) 예시: `5000`
`period`	string 필수	기간(예: "1day", "3day") 예시: `"3day"`
`address`	string 필수	대역폭을 받는 TRON 주소 예시: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

응답

HTTP 200 주문 제출 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	NetOrderResponseData 필수로 지정되지 않음	대역폭 주문 제출 후 응답 데이터.

HTTP 400 잘못된 요청

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 403 접근 금지

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "购买带宽时长",
  "description": "提交一个异步订单，为指定地址在给定周期内委托带宽。",
  "operationId": "buyNetV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "count": {
              "type": "integer",
              "description": "委托的带宽字节数 (最低 100)",
              "example": 5000
            },
            "period": {
              "type": "string",
              "description": "周期名称 (例如 \"1day\", \"3day\")",
              "example": "3day"
            },
            "address": {
              "type": "string",
              "description": "接收带宽的 TRON 地址",
              "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "count",
            "period",
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "订单已成功提交。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/NetOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/reclaim_energy 에너지 회수

에너지 회수

완료된 주문 번호와 대상 주소로 위임 리소스 회수를 비동기로 요청합니다.

전체 URL: https://weidubot.cc/api/v2/reclaim_energy

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`order_sn`	string 필수	원래 위임 주문 번호 예시: `"EN2025040217175512345"`
`address`	string 필수	원래 리소스 수신 주소 예시: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

응답

HTTP 200 회수 요청 제출 완료.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	응답 데이터 본문. null 허용

HTTP 400 잘못된 요청: 주문 번호 또는 주소 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 주문 미존재, 소유자 불일치 또는 회수 가능 리소스 없음

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "主动回收能量",
  "description": "根据已完成的订单号和目标地址，发起回收（取消委托）对应资源的请求。这是一个异步操作。",
  "operationId": "reclaimEnergyV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "order_sn": {
              "type": "string",
              "description": "原始委托订单的序列号",
              "example": "EN2025040217175512345"
            },
            "address": {
              "type": "string",
              "description": "原始接收委托资源的地址",
              "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "order_sn",
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "回收请求已成功提交。",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/BaseResponse"
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单号或地址格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单号不存在、不属于该用户，或未找到匹配的可回收资源)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_result 주문 결과 조회

주문 결과 조회

리소스 주문의 처리 상태와 상세 정보를 조회합니다.

전체 URL: https://weidubot.cc/api/v2/query_result

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`order_sn` 필수	query string	조회할 주문의 고유 번호 예시: `"EN2025040217175512345"`

응답

HTTP 200 주문 상세 조회 성공. data 구조는 상태에 따라 성공 상세 또는 실패 정보를 담습니다.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	QueryResultDataSuccess 또는 QueryResultDataFailed 필수로 지정되지 않음

HTTP 400 잘못된 요청: 주문 번호 형식

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 주문 미존재 또는 다른 사용자 소유

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 또는 조회 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "查询订单结果",
  "description": "获取指定资源订单的处理状态和详细信息。",
  "operationId": "queryResultV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_sn",
      "in": "query",
      "required": true,
      "description": "要查询的订单的唯一序列号",
      "schema": {
        "type": "string",
        "example": "EN2025040217175512345"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取订单详情。data 结构根据订单状态可能是成功详情或失败信息。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "oneOf": [
                      {
                        "$ref": "#/components/schemas/QueryResultDataSuccess"
                      },
                      {
                        "$ref": "#/components/schemas/QueryResultDataFailed"
                      }
                    ]
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单号格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单号不存在或不属于该用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误或查询异常",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_price 리소스 요금 조회

리소스 요금 조회

종류(energy / net), 수량, 기간으로 예상 주문 금액을 계산합니다.

전체 URL: https://weidubot.cc/api/v2/query_price

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`type` 필수	query string	리소스 종류("energy", "net") 열거값: `"energy"` / `"net"` 예시: `"energy"`
`count` 필수	query integer	에너지 포인트 또는 대역폭 바이트 수 예시: `50000`
`period` 필수	query string	기간(예: "15minutes", "1h", "1day", "3day") 예시: `"1day"`

응답

HTTP 200 요금 계산 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	ResourcePriceData 필수로 지정되지 않음	리소스 요금 결과.

HTTP 400 잘못된 요청: 매개변수 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 요금 미설정 또는 이용 불가

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "查询资源价格",
  "description": "根据资源类型（仅支持 energy 或 net）、数量和周期，计算预估的订购价格。",
  "operationId": "queryPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "type",
      "in": "query",
      "required": true,
      "description": "资源类型 (\"energy\", \"net\")",
      "schema": {
        "type": "string",
        "enum": [
          "energy",
          "net"
        ],
        "example": "energy"
      }
    },
    {
      "name": "count",
      "in": "query",
      "required": true,
      "description": "资源数量 (能量点数或带宽字节数)",
      "schema": {
        "type": "integer",
        "example": 50000
      }
    },
    {
      "name": "period",
      "in": "query",
      "required": true,
      "description": "周期名称 (例如 \"15minutes\",\"1h\", \"1day\", \"3day\")",
      "schema": {
        "type": "string",
        "example": "1day"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功计算价格。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ResourcePriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (指定资源的价格未配置或不可用)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

즉시 충전

에너지·대역폭 빠른 충전 서비스.

POST/query_fast_recover_price 즉시 충전 요금 조회

즉시 충전 요금 조회

즉시 충전 요금 조회.

전체 URL: https://weidubot.cc/api/v2/query_fast_recover_price

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`resource_type` 필수	query string	리소스 종류("energy", "net") 열거값: `"energy"` / `"net"` 예시: `"energy"`
`count` 필수	query integer	에너지 또는 대역폭 수량 예시: `100000`

응답

HTTP 200 요금 계산 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	FastRecoverPriceData 필수로 지정되지 않음	충전 요금 결과

HTTP 400 잘못된 요청: 매개변수 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 요금 미설정 또는 이용 불가

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "能量速充 (Fast Recover)"
  ],
  "summary": "查询能量/带宽速充价格",
  "description": "查询速冲价格",
  "operationId": "queryFastRecoverPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "resource_type",
      "in": "query",
      "required": true,
      "description": "资源类型 (\"energy\", \"net\")",
      "schema": {
        "type": "string",
        "enum": [
          "energy",
          "net"
        ],
        "example": "energy"
      }
    },
    {
      "name": "count",
      "in": "query",
      "required": true,
      "description": "资源数量 (能量数或带宽数)",
      "schema": {
        "type": "integer",
        "example": 100000
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功计算价格。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/FastRecoverPriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (指定资源的价格未配置或不可用)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/buy_fast_recover 에너지·대역폭 충전

에너지·대역폭 충전

지정 주소에 에너지 또는 대역폭을 한 번 충전합니다.

전체 URL: https://weidubot.cc/api/v2/buy_fast_recover

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`address`	string 필수	리소스 수신 TRON 주소 예시: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`
`count`	integer 필수	충전할 에너지·대역폭 수량 예시: `65000`
`resource_type`	string 필수	리소스 종류 열거값: `"energy"` / `"net"` 예시: `"energy"`

응답

HTTP 200 충전 요청 제출 완료. 잠시 후 상태를 조회하세요.

application/json · 유형을 눌러 전체 필드 확인

필드 유형 / 필수 설명 및 제약

code

integer 필수

상태 코드: 1 성공, 0 실패.

열거값: 1
예시: 1

msg

string 필수

응답 메시지.

예시: "操作成功"

time

string 필수

서버 응답 타임스탬프.

예시: "1711961879"

data

object 필수로 지정되지 않음

하위 필드	유형 / 필수	설명 및 제약
`order_id`	integer 필수로 지정되지 않음	충전 주문 ID

HTTP 400 잘못된 요청: 매개변수 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 403 금지(잔액 부족 등)

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "能量速充 (Fast Recover)"
  ],
  "summary": "能量/带宽速充",
  "description": "为指定地址快速补充一次性的能量或带宽。",
  "operationId": "buyFastRecoverV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "$ref": "#/components/schemas/FastRecoverOrderRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "速充请求已提交，请稍后查询状态。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "type": "object",
                    "properties": {
                      "order_id": {
                        "type": "integer",
                        "description": "速充订单ID"
                      }
                    }
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (例如余额不足)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_fast_recover_order 충전 주문 상태 조회

충전 주문 상태 조회

충전 주문의 상태와 상세 정보를 조회합니다.

전체 URL: https://weidubot.cc/api/v2/query_fast_recover_order

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`order_id` 필수	query integer	조회할 충전 주문 ID 예시: `123`

응답

HTTP 200 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	FastRecoverOrderResponseData 필수로 지정되지 않음	충전 주문 조회 결과.

HTTP 400 잘못된 요청: 주문 ID 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 주문 미존재 또는 다른 사용자 소유

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "能量速充 (Fast Recover)"
  ],
  "summary": "查询速充订单状态",
  "description": "获取指定速充订单的处理状态和详情。",
  "operationId": "queryFastRecoverOrderV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_id",
      "in": "query",
      "required": true,
      "description": "要查询的速充订单 ID",
      "schema": {
        "type": "integer",
        "example": 123
      }
    }
  ],
  "responses": {
    "200": {
      "description": "查询成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/FastRecoverOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单 ID 无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单 ID 不存在或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

자동 관리

에너지 자동 관리 작업.

GET/get_smart_price 자동 관리 요금 조회

자동 관리 요금 조회

65K 및 131K 에너지 자동 관리의 현재 요금을 조회합니다.

전체 URL: https://weidubot.cc/api/v2/get_smart_price

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

응답

HTTP 200 요금 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	SmartPriceData 필수로 지정되지 않음	자동 관리 요금 정보.

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 일부 또는 전체 요금 조회 불가

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "获取智能托管价格",
  "description": "获取当前 65K 和 131K 智能能量委托的价格。",
  "operationId": "getSmartPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取价格。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/SmartPriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (无法获取部分或全部价格信息)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/delegate_energy_smart 자동 관리 한도 추가

자동 관리 한도 추가

지정 주소의 자동 관리 사용 가능 잔액을 추가합니다.

전체 URL: https://weidubot.cc/api/v2/delegate_energy_smart

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`address`	string 필수	잔액을 추가할 TRON 주소 예시: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`balance`	number · float 필수	추가할 양수 금액(예: TRX) 예시: `10.5`
`channel`	string 필수로 지정되지 않음	모드: normal=일반, high_frequency=고빈도, jisu_frequency=고속, guangsu_frequency=광속 열거값: `"normal"` / `"high_frequency"` / `"jisu_frequency"` / `"guangsu_frequency"` 예시: `"high_frequency"`
`hf_deposit`	number 필수로 지정되지 않음	고빈도 보증금: -1 시스템 설정, 0 보증금 없음, 그 외 해당 금액 차감 예시: `"0"`
`net_protect`	string 필수로 지정되지 않음	주소 대역폭 보호 모드 열거값: `"open"` / `"close"` 예시: `"open"`

응답

HTTP 200 위임 또는 잔액 추가 성공

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	EnergySmartDelegateResponseData 필수로 지정되지 않음	자동 관리 위임 성공 데이터.

HTTP 400 잘못된 요청: 주소 또는 금액 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 429 너무 잦은 요청(잠금 구현 시)

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "委托智能托管额度",
  "description": "为指定地址增加智能能量托管服务的可用额度（余额）。",
  "operationId": "delegateEnergySmartV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要增加额度的 TRON 地址",
              "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
            },
            "balance": {
              "type": "number",
              "format": "float",
              "description": "要增加的额度数量 (例如 TRX 数量，必须为正数)",
              "example": 10.5
            },
            "channel": {
              "type": "string",
              "description": "能量通道：normal->普通模式，high_frequency->高频模式,jisu_frequency->极速模式,guangsu_frequency->光速模式",
              "enum": [
                "normal",
                "high_frequency",
                "jisu_frequency",
                "guangsu_frequency"
              ],
              "example": "high_frequency"
            },
            "hf_deposit": {
              "type": "number",
              "description": "高频押金：-1：跟随系统押金设置   0:不扣押金     其他金额:扣除相应押金",
              "example": "0"
            },
            "net_protect": {
              "type": "string",
              "description": "地址的带宽保护模式",
              "enum": [
                "open",
                "close"
              ],
              "example": "open"
            }
          },
          "required": [
            "address",
            "balance"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "委托/额度增加成功",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergySmartDelegateResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址或额度值无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": "请求过于频繁 (如果实现了锁)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_energy_smart 자동 관리 상태 조회

자동 관리 상태 조회

주소의 남은 잔액, 서비스 상태, 페이지별 이용 내역을 조회합니다.

전체 URL: https://weidubot.cc/api/v2/query_energy_smart

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`address` 필수	query string	조회할 TRON 주소 예시: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`page` 필수	query integer	페이지 번호(1부터) 최솟값: `1` 예시: `1`

응답

HTTP 200 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	EnergySmartQueryResponseData 필수로 지정되지 않음	자동 관리 주소 조회 결과.

HTTP 400 잘못된 요청: 주소 또는 페이지 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 서비스 미개통 또는 다른 사용자 소유

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "查询智能托管状态",
  "description": "获取指定地址的智能能量托管服务的剩余额度（余额）、服务状态以及消耗记录（分页）。",
  "operationId": "queryEnergySmartV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "要查询的 TRON 地址",
      "schema": {
        "type": "string",
        "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
      }
    },
    {
      "$ref": "#/components/parameters/PageParam"
    }
  ],
  "responses": {
    "200": {
      "description": "查询成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergySmartQueryResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址格式或页码无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (该地址未开通此服务或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/update_energy_smart 자동 관리 상태 변경

자동 관리 상태 변경

주소의 자동 관리를 시작("start") 또는 일시 중지("stop")합니다.

전체 URL: https://weidubot.cc/api/v2/update_energy_smart

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`address`	string 필수	변경할 TRON 주소 예시: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`status`	string 필수	목표 상태 열거값: `"start"` / `"stop"` 예시: `"start"`
`net_protect`	string 필수로 지정되지 않음	주소 대역폭 보호 모드 열거값: `"open"` / `"close"` 예시: `"open"`

응답

HTTP 200 변경 성공. 현재 상태를 반환합니다.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	EnergySmartData 필수로 지정되지 않음	자동 관리 변경 후 주소 상태.

HTTP 400 잘못된 요청: 주소 또는 상태 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 서비스 미개통 또는 다른 사용자 소유

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 409 충돌: 이미 목표 상태임

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 429 너무 잦은 요청(잠금 구현 시)

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "更新智能托管状态",
  "description": "启用 (\"start\") 或暂停 (\"stop\") 指定地址的智能能量托管服务。",
  "operationId": "updateEnergySmartV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要更新状态的 TRON 地址",
              "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
            },
            "status": {
              "type": "string",
              "description": "目标状态",
              "enum": [
                "start",
                "stop"
              ],
              "example": "start"
            },
            "net_protect": {
              "type": "string",
              "description": "地址的带宽保护模式",
              "enum": [
                "open",
                "close"
              ],
              "example": "open"
            }
          },
          "required": [
            "address",
            "status"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "状态更新成功，返回当前状态。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergySmartData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址、状态值无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (该地址未开通此服务或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "409": {
      "description": "冲突 (已经是目标状态)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": "请求过于频繁 (如果实现了锁)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/statistics_smart_by_address 자동 관리 통계 조회

자동 관리 통계 조회

오늘, 어제, 이번 주, 이번 달, 최근 5일의 주소별 이용 통계(65k/131k 구분).

전체 URL: https://weidubot.cc/api/v2/statistics_smart_by_address

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`address` 필수	query string	통계 대상 TRON 주소 예시: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`

응답

HTTP 200 통계 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	StatisticsSmartData 필수로 지정되지 않음	주소별 자동 관리 통계.

HTTP 400 잘못된 요청: 주소 형식 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "获取智能托管地址统计",
  "description": "获取指定地址在不同时间段内（今日、昨日、本周、本月、近5天）的智能能量服务消耗统计（区分 65k/131k 类型）。",
  "operationId": "statisticsSmartByAddressV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "要获取统计的 TRON 地址",
      "schema": {
        "type": "string",
        "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取统计数据。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StatisticsSmartData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

횟수제 에너지

횟수제 에너지 API 작업.

GET/get_times_price 횟수제 에너지 요금 조회

횟수제 에너지 요금 조회

현재 거래 1회당 요금을 조회합니다.

전체 URL: https://weidubot.cc/api/v2/get_times_price

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

응답

HTTP 200 요금 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	TimesPriceData 필수로 지정되지 않음	횟수제 에너지 요금.

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 요금 조회 불가

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "获取API笔数价格",
  "description": "获取当前API笔数的单次交易价格。",
  "operationId": "getTimesPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取价格。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TimesPriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (无法获取价格信息)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/delegate_energy_times 에너지 횟수 추가

에너지 횟수 추가

주소에 에너지 이용 횟수를 추가합니다. 건별로 과금됩니다.

전체 URL: https://weidubot.cc/api/v2/delegate_energy_times

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`address`	string 필수	횟수를 추가할 TRON 주소 예시: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`times`	integer 필수	추가 횟수(양의 정수) 예시: `100`

응답

HTTP 200 위임 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	EnergyTimesDelegateResponseData 필수로 지정되지 않음	횟수 위임 성공 데이터.

HTTP 400 잘못된 요청: 주소 또는 횟수 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 429 너무 잦은 요청(잠금 구현 시)

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류(데이터베이스 등)

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "委托API笔数",
  "description": "为指定地址增加指定能量笔数（按次计费）。",
  "operationId": "delegateEnergyTimesV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要增加笔数的 TRON 地址",
              "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
            },
            "times": {
              "type": "integer",
              "description": "要增加的能量委托笔数 (必须为正整数)",
              "example": 100
            }
          },
          "required": [
            "address",
            "times"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "委托成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyTimesDelegateResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址或笔数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": "请求过于频繁 (如果实现了锁)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误 (例如数据库错误)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_energy_times 횟수제 에너지 상태 조회

횟수제 에너지 상태 조회

주소의 남은 횟수, 상태, 페이지별 사용 내역을 조회합니다.

전체 URL: https://weidubot.cc/api/v2/query_energy_times

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`address` 필수	query string	조회할 TRON 주소 예시: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`page` 필수	query integer	페이지 번호(1부터) 최솟값: `1` 예시: `1`

응답

HTTP 200 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	EnergyTimesQueryResponseData 필수로 지정되지 않음	횟수제 서비스 주소 조회 결과.

HTTP 400 잘못된 요청: 주소 또는 페이지 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 서비스 미개통 또는 다른 사용자 소유

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "查询API笔数状态",
  "description": "获取指定地址的剩余能量笔数、服务状态以及消耗记录（分页）。",
  "operationId": "queryEnergyTimesV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "要查询的 TRON 地址",
      "schema": {
        "type": "string",
        "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
      }
    },
    {
      "$ref": "#/components/parameters/PageParam"
    }
  ],
  "responses": {
    "200": {
      "description": "查询成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyTimesQueryResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址格式或页码无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (该地址未开通此服务或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/update_energy_times 주소 횟수제 서비스 상태 변경

주소 횟수제 서비스 상태 변경

주소의 횟수제 서비스를 시작("start") 또는 일시 중지("stop")합니다.

전체 URL: https://weidubot.cc/api/v2/update_energy_times

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`address`	string 필수	변경할 TRON 주소 예시: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`status`	string 필수	목표 상태 열거값: `"start"` / `"stop"` 예시: `"stop"`

응답

HTTP 200 변경 성공. 현재 상태를 반환합니다.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	EnergyTimesData 필수로 지정되지 않음	횟수제 변경 후 주소 상태.

HTTP 400 잘못된 요청: 주소 또는 상태 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 서비스 미개통 또는 다른 사용자 소유

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 409 충돌: 이미 목표 상태임

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 429 너무 잦은 요청(잠금 구현 시)

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "更新地址的API笔数状态",
  "description": "启用 (\"start\") 或暂停 (\"stop\") 指定地址的API笔数服务。",
  "operationId": "updateEnergyTimesV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要更新状态的 TRON 地址",
              "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
            },
            "status": {
              "type": "string",
              "description": "目标状态",
              "enum": [
                "start",
                "stop"
              ],
              "example": "stop"
            }
          },
          "required": [
            "address",
            "status"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "状态更新成功，返回当前状态。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyTimesData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址、状态值无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (该地址未开通此服务或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "409": {
      "description": "冲突 (已经是目标状态)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": "请求过于频繁 (如果实现了锁)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/statistics_times_by_address 에너지 횟수 통계 조회

에너지 횟수 통계 조회

오늘, 어제, 이번 주, 이번 달, 최근 5일의 주소별 에너지 사용 횟수.

전체 URL: https://weidubot.cc/api/v2/statistics_times_by_address

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`address` 필수	query string	통계 대상 TRON 주소 예시: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`

응답

HTTP 200 통계 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	StatisticsTimesData 필수로 지정되지 않음	주소별 에너지 횟수 통계.

HTTP 400 잘못된 요청: 주소 형식 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "获取 API能量笔数 地址统计",
  "description": "获取指定地址在不同时间段内（今日、昨日、本周、本月、近5天）的 API能量笔数 消耗数量统计。",
  "operationId": "statisticsTimesByAddressV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "要获取统计的 TRON 地址",
      "schema": {
        "type": "string",
        "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取统计数据。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StatisticsTimesData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

Fragment 서비스

Fragment를 통한 Telegram Premium 및 Stars 주문.

POST/buy_premium Telegram Premium 구매

Telegram Premium 구매

지정 Telegram 사용자에게 Premium을 선물하는 주문을 생성합니다.

전체 URL: https://weidubot.cc/api/v2/buy_premium

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`username`	string 필수	대상 Telegram 사용자명(@ 제외). 예시: `"telegram_user"`
`month`	integer 필수	구매 개월 수. 열거값: `3` / `6` / `12` 예시: `3`

응답

HTTP 200 주문 제출 완료.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	PremiumOrderResponseData 필수로 지정되지 않음	Premium 주문 제출 결과.

HTTP 400 잘못된 요청: 사용자명 또는 개월 수

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 403 금지: 잔액 부족

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "Fragment 服务 (Premium/Stars Service)"
  ],
  "summary": "购买 Telegram Premium 会员",
  "description": "创建一个为指定 Telegram 用户赠送 Premium 会员的订单。",
  "operationId": "buyPremiumV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "$ref": "#/components/schemas/PremiumOrderRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "订单提交成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/PremiumOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (用户名或月数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (余额不足)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_premium_order Premium 주문 조회

Premium 주문 조회

Premium 주문 상태와 상세 정보를 조회합니다.

전체 URL: https://weidubot.cc/api/v2/query_premium_order

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`order_id` 필수	query integer	조회할 내부 주문 ID 예시: `5678`

응답

HTTP 200 주문 상세 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	PremiumQueryResultData 필수로 지정되지 않음	Premium 주문 조회 결과.

HTTP 400 잘못된 요청: 주문 ID 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 주문 미존재 또는 다른 사용자 소유

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "Fragment 服务 (Premium/Stars Service)"
  ],
  "summary": "查询 Premium 会员订单状态",
  "description": "获取指定 Premium 会员订单的处理状态和详情。",
  "operationId": "queryPremiumOrderV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_id",
      "in": "query",
      "required": true,
      "description": "要查询的内部订单 ID",
      "schema": {
        "type": "integer",
        "example": 5678
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取订单详情。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/PremiumQueryResultData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单 ID 无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单 ID 不存在或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/buy_star Telegram Stars 구매

Telegram Stars 구매

지정 Telegram 사용자에게 Stars를 보내는 주문을 생성합니다.

전체 URL: https://weidubot.cc/api/v2/buy_star

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`username`	string 필수	대상 Telegram 사용자명(@ 제외). 예시: `"channel_owner"`
`count`	integer 필수	Stars 수량(50~10000). 최솟값: `50` 최댓값: `10000` 예시: `100`

응답

HTTP 200 주문 제출 완료.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	StarOrderResponseData 필수로 지정되지 않음	Stars 주문 제출 결과.

HTTP 400 잘못된 요청: 사용자명 또는 수량

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 403 금지: 잔액 부족

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "Fragment 服务 (Premium/Stars Service)"
  ],
  "summary": "购买 Telegram 星星",
  "description": "创建一个向指定 Telegram 用户发送星星的订单。",
  "operationId": "buyStarV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "$ref": "#/components/schemas/StarOrderRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "订单提交成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StarOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (用户名或数量无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (余额不足)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_star_order Stars 주문 조회

Stars 주문 조회

Stars 주문의 상태와 상세 정보를 조회합니다.

전체 URL: https://weidubot.cc/api/v2/query_star_order

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`
`order_id` 필수	query integer	조회할 내부 주문 ID 예시: `91011`

응답

HTTP 200 주문 상세 조회 성공.

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	StarQueryResultData 필수로 지정되지 않음	Stars 주문 조회 결과.

HTTP 400 잘못된 요청: 주문 ID 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 404 없음: 주문 미존재 또는 다른 사용자 소유

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "Fragment 服务 (Premium/Stars Service)"
  ],
  "summary": "查询星星订单状态",
  "description": "获取指定星星订单的处理状态和详情。",
  "operationId": "queryStarOrderV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_id",
      "in": "query",
      "required": true,
      "description": "要查询的内部订单 ID",
      "schema": {
        "type": "integer",
        "example": 91011
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取订单详情。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StarQueryResultData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单 ID 无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单 ID 不存在或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

주소 자금 집계

USDT 자동 집계 주소 관리.

POST/submit_converge_address 집계 설정 제출

집계 설정 제출

TRON 주소의 USDT 자동 집계 규칙을 설정합니다.

전체 URL: https://weidubot.cc/api/v2/submit_converge_address

헤더 및 매개변수

매개변수	위치 / 유형	설명 및 제약
`x-api-key` 필수	header string	사용자의 API Key.
`x-timestamp` 필수	header integer	현재 UNIX 타임스탬프(초). 예시: `1711961879`
`x-signature` 필수	header string	서명(HMAC-SHA256 소문자 16진수): `x-api-key` + `x-timestamp` 를 계산). 예시: `"a1b2c3d4e5f6..."`

본문 · application/x-www-form-urlencoded

요청 본문 필수

폼 필드	유형 / 필수	설명 및 제약
`address`	string 필수	집계를 설정할 TRON 주소 예시: `"TConvergeAddressxxxxxxxxxxxxxxxxxx"`
`mode`	string 필수	집계 모드 열거값: `"once"` / `"keep"` 예시: `"keep"`
`transfer_threshold`	number · float 필수	집계 시작 최소 잔액 기준 예시: `100`
`balance_min`	number · float 필수	집계 후 최소 유지 잔액 예시: `10`
`balance_max`	number · float 필수	최대 유지 잔액(min 이상) 예시: `20`
`energy_count`	integer 필수	집계에 제공할 에너지 수량 예시: `65000`
`type`	string 필수	주소에 제공할 서비스 종류 열거값: `"energy"` / `"all"` 예시: `"all"`
`notify_callback`	string · url 필수로 지정되지 않음	선택: 집계 알림 콜백 URL null 허용 예시: `"https://yourcallback.com/notify"`

응답

HTTP 200 설정 제출 완료

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	응답 데이터 본문. null 허용

HTTP 400 잘못된 요청: 매개변수 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 401 미인증

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 409 충돌: 주소에 활성 설정이 이미 존재

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

HTTP 500 서버 내부 오류

application/json · 유형을 눌러 전체 필드 확인

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

전체 OpenAPI 정의 보기

OpenAPI · JSON

{
  "tags": [
    "地址归集 (Converge Address)"
  ],
  "summary": "提交地址归集配置",
  "description": "为一个 TRON 地址配置自动 USDT 归集的规则。",
  "operationId": "submitConvergeAddressV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要配置归集的 TRON 地址",
              "example": "TConvergeAddressxxxxxxxxxxxxxxxxxx"
            },
            "mode": {
              "type": "string",
              "description": "归集模式",
              "enum": [
                "once",
                "keep"
              ],
              "example": "keep"
            },
            "transfer_threshold": {
              "type": "number",
              "format": "float",
              "description": "触发归集的最低余额阈值",
              "example": 100
            },
            "balance_min": {
              "type": "number",
              "format": "float",
              "description": "归集后地址保留的最低余额",
              "example": 10
            },
            "balance_max": {
              "type": "number",
              "format": "float",
              "description": "归集后地址允许保留的最高余额 (需 >= min)",
              "example": 20
            },
            "energy_count": {
              "type": "integer",
              "description": "为归集操作提供的能量数量",
              "example": 65000
            },
            "type": {
              "type": "string",
              "description": "为地址提供的服务类型",
              "enum": [
                "energy",
                "all"
              ],
              "example": "all"
            },
            "notify_callback": {
              "type": "string",
              "format": "url",
              "nullable": true,
              "description": "可选，接收归集通知的回调 URL",
              "example": "https://yourcallback.com/notify"
            }
          },
          "required": [
            "address",
            "mode",
            "transfer_threshold",
            "balance_min",
            "balance_max",
            "energy_count",
            "type"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "配置提交成功",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/BaseResponse"
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "409": {
      "description": "冲突 (该地址已存在启用中的配置)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

07 / DATA MODELS

전체 데이터 모델

필드는 현재 V2 정의와 일치합니다. 성공 응답은 보통 code , msg , time , data 로 구성됩니다. 업무별 필드는 해당 모델을 확인하세요.

BaseResponse 필드 정의

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 1 성공, 0 실패. 열거값: `1` 예시: `1`
`msg`	string 필수	응답 메시지. 예시: `"操作成功"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	응답 데이터 본문. null 허용

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer",
      "description": "状态码，1 表示成功，0 表示失败。",
      "enum": [
        1
      ],
      "example": 1
    },
    "msg": {
      "type": "string",
      "description": "响应消息文本。",
      "example": "操作成功"
    },
    "time": {
      "type": "string",
      "description": "服务器响应时间戳。",
      "example": "1711961879"
    },
    "data": {
      "type": "object",
      "nullable": true,
      "description": "具体的响应数据负载。"
    }
  },
  "required": [
    "code",
    "msg",
    "time"
  ]
}

ErrorResponse 필드 정의

필드	유형 / 필수	설명 및 제약
`code`	integer 필수	상태 코드: 0 실패. 열거값: `0` 예시: `0`
`msg`	string 필수	오류 메시지 설명. 예시: `"参数错误"`
`time`	string 필수	서버 응답 타임스탬프. 예시: `"1711961879"`
`data`	object 필수로 지정되지 않음	null 허용 예시: `null`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer",
      "description": "状态码，0 表示失败。",
      "enum": [
        0
      ],
      "example": 0
    },
    "msg": {
      "type": "string",
      "description": "错误消息描述。",
      "example": "参数错误"
    },
    "time": {
      "type": "string",
      "description": "服务器响应时间戳。",
      "example": "1711961879"
    },
    "data": {
      "type": "object",
      "nullable": true,
      "example": null
    }
  },
  "required": [
    "code",
    "msg",
    "time"
  ]
}

ActivationData 계정 활성화 제출 후 응답 데이터.

계정 활성화 제출 후 응답 데이터.

필드	유형 / 필수	설명 및 제약
`tx_id`	string 필수	거래 해시. 보통 백그라운드 작업 완료 후 설정되며 처음에는 비어 있습니다. 예시: `""`
`order_id`	integer 필수	활성화를 추적하는 내부 주문 ID. 예시: `12345`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "账户激活请求提交后的响应数据。",
  "properties": {
    "tx_id": {
      "type": "string",
      "description": "交易哈希 (通常在后台任务完成后才有，初始为空)。",
      "example": ""
    },
    "order_id": {
      "type": "integer",
      "description": "用于追踪激活请求的内部订单 ID。",
      "example": 12345
    }
  },
  "required": [
    "tx_id",
    "order_id"
  ]
}

EnergyOrderResponseData 에너지 주문 제출 후 응답 데이터.

에너지 주문 제출 후 응답 데이터.

필드	유형 / 필수	설명 및 제약
`order_sn`	string 필수	고유 주문 번호. 예시: `"EN2025040217175512345"`
`price`	number · float 필수로 지정되지 않음	계산된 에너지 단가(SUN). null 허용 예시: `35000000`
`fee`	number · float 필수로 지정되지 않음	추가 수수료(TRX). null 허용 예시: `0.56`
`amount`	number · float 필수로 지정되지 않음	주문 총비용(TRX). null 허용 예시: `5.65`
`balance`	number · float 필수로 지정되지 않음	작업 후 잔액. 부정확하거나 제공되지 않을 수 있습니다. null 허용 예시: `94.35`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "能量订单提交成功后的响应数据。",
  "properties": {
    "order_sn": {
      "type": "string",
      "description": "唯一的订单序列号。",
      "example": "EN2025040217175512345"
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "计算出的单位能量价格 (SUN)。",
      "example": 35000000
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "额外手续费 (TRX)。",
      "example": 0.56
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单总费用 (TRX)。",
      "example": 5.65
    },
    "balance": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "操作后账户余额 (可能不准确或不提供)。",
      "example": 94.35
    }
  },
  "required": [
    "order_sn"
  ]
}

NetOrderResponseData 대역폭 주문 제출 후 응답 데이터.

대역폭 주문 제출 후 응답 데이터.

필드	유형 / 필수	설명 및 제약
`order_sn`	string 필수	고유 주문 번호. 예시: `"NET2025040217180012345"`
`amount`	number · float 필수로 지정되지 않음	주문 총비용(TRX). null 허용 예시: `2.1`
`price`	number · float 필수로 지정되지 않음	계산된 대역폭 단가. 원문 단위 표기는 SUN?입니다. null 허용 예시: `420000`
`fee`	number · float 필수로 지정되지 않음	추가 수수료(TRX). null 허용 예시: `0`
`balance`	number · float 필수로 지정되지 않음	작업 후 잔액. 부정확하거나 제공되지 않을 수 있습니다. null 허용 예시: `97.9`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "带宽订单提交成功后的响应数据。",
  "properties": {
    "order_sn": {
      "type": "string",
      "description": "唯一的订单序列号。",
      "example": "NET2025040217180012345"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单总费用 (TRX)。",
      "example": 2.1
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "计算出的单位带宽价格 (SUN?)。",
      "example": 420000
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "额外手续费 (TRX)。",
      "example": 0
    },
    "balance": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "操作后账户余额 (可能不准确或不提供)。",
      "example": 97.9
    }
  },
  "required": [
    "order_sn"
  ]
}

QueryResultDataSuccess 조회 성공한 주문 상세.

조회 성공한 주문 상세.

필드	유형 / 필수	설명 및 제약
`order_sn`	string 필수
`amount`	number · float 필수로 지정되지 않음	주문 금액(TRX) null 허용
`price`	number · float 필수로 지정되지 않음	주문 단가(SUN) null 허용
`fee`	number · float 필수로 지정되지 않음	주문 수수료(TRX) null 허용
`period`	string 필수	기간명
`status`	string 필수	주문 상태 코드
`orders`	array<object> 필수	하위 위임 주문 목록

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "查询成功的订单详情。",
  "properties": {
    "order_sn": {
      "type": "string"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单单价 (SUN)"
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单手续费 (TRX)"
    },
    "period": {
      "type": "string",
      "description": "周期名称"
    },
    "status": {
      "type": "string",
      "description": "订单状态码"
    },
    "orders": {
      "type": "array",
      "description": "子订单（委托）列表",
      "items": {
        "type": "object",
        "properties": {
          "from_address": {
            "type": "string",
            "description": "该笔委托的来源地址"
          },
          "tx_id": {
            "type": "string",
            "nullable": true,
            "description": "该笔委托的交易哈希"
          },
          "count": {
            "type": "integer",
            "description": "该笔委托的资源数量"
          }
        },
        "required": [
          "from_address",
          "count"
        ]
      }
    }
  },
  "required": [
    "order_sn",
    "period",
    "status",
    "orders"
  ]
}

QueryResultDataFailed 실패 또는 미완료 주문 기본 정보.

실패 또는 미완료 주문 기본 정보.

필드	유형 / 필수	설명 및 제약
`order_sn`	string 필수
`amount`	number · float 필수로 지정되지 않음	null 허용
`price`	number · float 필수로 지정되지 않음	null 허용
`fee`	number · float 필수로 지정되지 않음	null 허용
`period`	string 필수로 지정되지 않음	null 허용
`status`	string 필수	주문 상태 코드
`orders`	array<object> 필수	빈 배열

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "查询失败或未完成的订单基本信息。",
  "properties": {
    "order_sn": {
      "type": "string"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true
    },
    "period": {
      "type": "string",
      "nullable": true
    },
    "status": {
      "type": "string",
      "description": "订单状态码"
    },
    "orders": {
      "type": "array",
      "items": {},
      "description": "空数组"
    }
  },
  "required": [
    "order_sn",
    "status",
    "orders"
  ]
}

UserInfoData 사용자 정보 조회 결과.

사용자 정보 조회 결과.

필드	유형 / 필수	설명 및 제약
`balance_trx`	string 필수	사용 가능 TRX 잔액(형식화된 문자열). 예시: `"100.5000"`
`balance_usdt`	string 필수	사용 가능 USDT 잔액(형식화된 문자열). 예시: `"500.0000"`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "用户信息查询结果。",
  "properties": {
    "balance_trx": {
      "type": "string",
      "description": "用户可用 TRX 余额 (格式化字符串)。",
      "example": "100.5000"
    },
    "balance_usdt": {
      "type": "string",
      "description": "用户可用 USDT 余额 (格式化字符串)。",
      "example": "500.0000"
    }
  },
  "required": [
    "balance_trx",
    "balance_usdt"
  ]
}

ResourcePriceData 리소스 요금 결과.

리소스 요금 결과.

필드	유형 / 필수	설명 및 제약
`price`	integer 필수	기간당 단가(SUN). 예시: `35`
`amount`	string 필수	요청 수량의 예상 총비용(TRX), 적용 수수료 포함. 예시: `"5.6500"`
`fee`	string 필수	추가 수수료(TRX), 예: 소액 주문 수수료. 예시: `"0.5600"`
`remark`	string 필수	요금 계산 추가 설명(수수료 상세 등). 예시: `"包含 0.56 TRX 带宽手续费"`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "资源价格查询结果。",
  "properties": {
    "price": {
      "type": "integer",
      "description": "单位价格 (SUN / 每周期)。",
      "example": 35
    },
    "amount": {
      "type": "string",
      "description": "请求数量的总预估费用 (单位：TRX)，包含可能的手续费。",
      "example": "5.6500"
    },
    "fee": {
      "type": "string",
      "description": "额外的手续费 (单位：TRX)，例如小额订单费用。",
      "example": "0.5600"
    },
    "remark": {
      "type": "string",
      "description": "关于价格计算的附加说明 (例如手续费详情)。",
      "example": "包含 0.56 TRX 带宽手续费"
    }
  },
  "required": [
    "price",
    "amount",
    "fee",
    "remark"
  ]
}

FastRecoverPriceData 충전 요금 결과

충전 요금 결과

필드	유형 / 필수	설명 및 제약
`price`	integer 필수	단가(SUN). 예시: `100`
`amount`	string 필수	요청 수량의 예상 총비용(TRX), 적용 수수료 포함. 예시: `"5.6500"`
`fee`	string 필수	추가 수수료(TRX), 예: 소액 주문 수수료. 예시: `"0.5600"`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "速冲价格查询结果",
  "properties": {
    "price": {
      "type": "integer",
      "description": "单位价格 (SUN)。",
      "example": 100
    },
    "amount": {
      "type": "string",
      "description": "请求数量的总预估费用 (单位：TRX)，包含可能的手续费。",
      "example": "5.6500"
    },
    "fee": {
      "type": "string",
      "description": "额外的手续费 (单位：TRX)，例如小额订单费用。",
      "example": "0.5600"
    }
  },
  "required": [
    "price",
    "amount",
    "fee",
    "remark"
  ]
}

SmartPriceData 자동 관리 요금 정보.

자동 관리 요금 정보.

필드 유형 / 필수 설명 및 제약

65K_price

string 필수

65K 에너지 위임 1회 요금(TRX).

예시: "0.5000"

131K_price

string 필수

131K 에너지 위임 1회 요금(TRX).

예시: "0.9500"

remark

string 필수로 지정되지 않음

null 허용
예시: "价格单位：TRX/次"

high_frequency

object 필수로 지정되지 않음

고빈도 요금, 보증금, 통계 기간.

하위 필드	유형 / 필수	설명 및 제약
`65k_price`	string 필수로 지정되지 않음	고빈도 65K 요금. null 허용 예시: `"0.8000"`
`131k_price`	string 필수로 지정되지 않음	고빈도 131K 요금. null 허용 예시: `"1.5000"`
`deposit_period`	string 필수로 지정되지 않음	고빈도 통계 기간(시간) null 허용 예시: `"72"`
`deposit_amount`	string 필수로 지정되지 않음	고빈도 보증금(TRX) null 허용 예시: `1000`
`min_energy_count`	string 필수로 지정되지 않음	고빈도 모드 최소 에너지 사용량 null 허용 예시: `200000`

jisu_frequency

object 필수로 지정되지 않음

고속 모드 요금, 보증금, 통계 기간.

하위 필드	유형 / 필수	설명 및 제약
`65k_price`	string 필수로 지정되지 않음	고속 65K 요금. null 허용 예시: `"0.8000"`
`131k_price`	string 필수로 지정되지 않음	고속 131K 요금. null 허용 예시: `"1.5000"`
`deposit_period`	string 필수로 지정되지 않음	고속 통계 기간(시간) null 허용 예시: `"72"`
`deposit_amount`	string 필수로 지정되지 않음	고속 보증금(TRX) null 허용 예시: `1000`
`min_energy_count`	string 필수로 지정되지 않음	고속 모드 최소 에너지 사용량 null 허용 예시: `200000`

guangsu_frequency

object 필수로 지정되지 않음

광속 모드 요금, 보증금, 통계 기간.

하위 필드	유형 / 필수	설명 및 제약
`65k_price`	string 필수로 지정되지 않음	광속 65K 요금. null 허용 예시: `"0.8000"`
`131k_price`	string 필수로 지정되지 않음	광속 131K 요금. null 허용 예시: `"1.5000"`
`deposit_period`	string 필수로 지정되지 않음	광속 통계 기간(시간) null 허용 예시: `"72"`
`deposit_amount`	string 필수로 지정되지 않음	광속 보증금(TRX) null 허용 예시: `1000`
`min_energy_count`	string 필수로 지정되지 않음	광속 모드 최소 에너지 사용량 null 허용 예시: `200000`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管服务的价格信息。",
  "properties": {
    "65K_price": {
      "type": "string",
      "description": "每次 65K 能量委托的价格 (TRX)。",
      "example": "0.5000"
    },
    "131K_price": {
      "type": "string",
      "description": "每次 131K 能量委托的价格 (TRX)。",
      "example": "0.9500"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "example": "价格单位：TRX/次"
    },
    "high_frequency": {
      "type": "object",
      "description": "高频价格信息，包含能量价格、押金和统计周期等。",
      "properties": {
        "65k_price": {
          "type": "string",
          "nullable": true,
          "description": "高频模式65K能量的价格。",
          "example": "0.8000"
        },
        "131k_price": {
          "type": "string",
          "nullable": true,
          "description": "高频模式131K能量的价格。",
          "example": "1.5000"
        },
        "deposit_period": {
          "type": "string",
          "nullable": true,
          "description": "高频模式统计周期，单位：小时",
          "example": "72"
        },
        "deposit_amount": {
          "type": "string",
          "nullable": true,
          "description": "高频模式押金，单位: TRX",
          "example": 1000
        },
        "min_energy_count": {
          "type": "string",
          "nullable": true,
          "description": "高频模式最少使用能量数",
          "example": 200000
        }
      }
    },
    "jisu_frequency": {
      "type": "object",
      "description": "极速模式价格信息，包含能量价格、押金和统计周期等。",
      "properties": {
        "65k_price": {
          "type": "string",
          "nullable": true,
          "description": "极速模式65K能量的价格。",
          "example": "0.8000"
        },
        "131k_price": {
          "type": "string",
          "nullable": true,
          "description": "极速模式131K能量的价格。",
          "example": "1.5000"
        },
        "deposit_period": {
          "type": "string",
          "nullable": true,
          "description": "极速模式统计周期，单位：小时",
          "example": "72"
        },
        "deposit_amount": {
          "type": "string",
          "nullable": true,
          "description": "极速模式押金，单位: TRX",
          "example": 1000
        },
        "min_energy_count": {
          "type": "string",
          "nullable": true,
          "description": "极速模式最少使用能量数",
          "example": 200000
        }
      }
    },
    "guangsu_frequency": {
      "type": "object",
      "description": "光速模式价格信息，包含能量价格、押金和统计周期等。",
      "properties": {
        "65k_price": {
          "type": "string",
          "nullable": true,
          "description": "光速模式65K能量的价格。",
          "example": "0.8000"
        },
        "131k_price": {
          "type": "string",
          "nullable": true,
          "description": "光速模式131K能量的价格。",
          "example": "1.5000"
        },
        "deposit_period": {
          "type": "string",
          "nullable": true,
          "description": "光速模式统计周期，单位：小时",
          "example": "72"
        },
        "deposit_amount": {
          "type": "string",
          "nullable": true,
          "description": "光速模式押金，单位: TRX",
          "example": 1000
        },
        "min_energy_count": {
          "type": "string",
          "nullable": true,
          "description": "光速模式最少使用能量数",
          "example": 200000
        }
      }
    }
  },
  "required": [
    "65K_price",
    "131K_price"
  ]
}

TimesPriceData 횟수제 에너지 요금.

횟수제 에너지 요금.

필드	유형 / 필수	설명 및 제약
`price`	string 필수	에너지 위임 1회 요금(TRX). 예시: `"0.6000"`
`remark`	string 필수로 지정되지 않음	null 허용 예시: `"价格单位：TRX/笔"`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数的价格信息。",
  "properties": {
    "price": {
      "type": "string",
      "description": "每次能量委托的价格 (TRX)。",
      "example": "0.6000"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "example": "价格单位：TRX/笔"
    }
  },
  "required": [
    "price"
  ]
}

EnergyTimesDelegateResponseData 횟수 위임 성공 데이터.

횟수 위임 성공 데이터.

필드	유형 / 필수	설명 및 제약
`address`	string 필수	위임 대상 주소
`remain_times`	integer 필수	작업 후 남은 횟수
`status`	string 필수	현재 서비스 상태 열거값: `"start"` / `"stop"`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数委托成功后的响应数据。",
  "properties": {
    "address": {
      "type": "string",
      "description": "委托的目标地址"
    },
    "remain_times": {
      "type": "integer",
      "description": "操作后剩余笔数"
    },
    "status": {
      "type": "string",
      "description": "当前服务状态",
      "enum": [
        "start",
        "stop"
      ]
    }
  },
  "required": [
    "address",
    "remain_times",
    "status"
  ]
}

EnergyTimesOrderItem 에너지 횟수 사용 기록

에너지 횟수 사용 기록

필드	유형 / 필수	설명 및 제약
`remain_times`	integer 필수로 지정되지 않음	이번 사용 후 남은 횟수 null 허용
`status`	string 필수로 지정되지 않음	에너지 상태 null 허용 열거값: `"init"` / `"waiting_delegate"` / `"delegate_success"` / `"delegate_failed"` / `"waiting_un_delegate"` / `"un_delegate_success"` / `"un_delegate_failed"`
`speed_mode`	string 필수로 지정되지 않음	에너지 모드 null 허용 열거값: `"normal"` / `"low_speed"`
`used_tx_id`	string 필수로 지정되지 않음	에너지를 사용한 거래 해시 null 허용
`used_energy`	integer 필수로 지정되지 않음	소비 에너지 수량 null 허용
`delegate_tx_id`	string 필수로 지정되지 않음	에너지 위임 거래 해시 null 허용
`delegate_time`	integer 필수로 지정되지 않음	위임 타임스탬프 null 허용
`un_delegate_tx_id`	string 필수로 지정되지 않음	에너지 회수 거래 해시 null 허용
`un_delegate_time`	integer 필수로 지정되지 않음	회수 타임스탬프 null 허용
`createtime`	integer 필수로 지정되지 않음	기록 생성 타임스탬프 null 허용

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "能量笔数消耗记录项",
  "properties": {
    "remain_times": {
      "type": "integer",
      "nullable": true,
      "description": "此次消耗后的剩余笔数"
    },
    "status": {
      "type": "string",
      "nullable": true,
      "description": "能量状态",
      "enum": [
        "init",
        "waiting_delegate",
        "delegate_success",
        "delegate_failed",
        "waiting_un_delegate",
        "un_delegate_success",
        "un_delegate_failed"
      ]
    },
    "speed_mode": {
      "type": "string",
      "nullable": true,
      "description": "能量模式",
      "enum": [
        "normal",
        "low_speed"
      ]
    },
    "used_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "消耗能量的交易哈希"
    },
    "used_energy": {
      "type": "integer",
      "nullable": true,
      "description": "消耗的能量值"
    },
    "delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "委托能量的交易哈希"
    },
    "delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": "委托时间戳"
    },
    "un_delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "回收能量的交易哈希"
    },
    "un_delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": "回收时间戳"
    },
    "createtime": {
      "type": "integer",
      "nullable": true,
      "description": "记录创建时间戳"
    }
  }
}

EnergyTimesQueryResponseData 횟수제 서비스 주소 조회 결과.

횟수제 서비스 주소 조회 결과.

필드	유형 / 필수	설명 및 제약
`address`	string 필수	TRON 주소
`remain_times`	integer 필수	남은 사용 가능 횟수
`status`	string 필수	서비스 상태: 활성 / 일시 중지 열거값: `"start"` / `"stop"`
`order_count`	integer 필수	총 사용 기록 수
`page_size`	integer 필수	페이지당 기록 수
`page`	integer 필수	현재 페이지 번호
`orders`	array<EnergyTimesOrderItem> 필수	현재 페이지의 사용 기록

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数的地址查询结果。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON 地址"
    },
    "remain_times": {
      "type": "integer",
      "description": "剩余可用笔数"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": "服务状态 (启用/暂停)"
    },
    "order_count": {
      "type": "integer",
      "description": "总消耗记录数"
    },
    "page_size": {
      "type": "integer",
      "description": "每页记录数"
    },
    "page": {
      "type": "integer",
      "description": "当前页码"
    },
    "orders": {
      "type": "array",
      "description": "当前页的消耗记录列表",
      "items": {
        "$ref": "#/components/schemas/EnergyTimesOrderItem"
      }
    }
  },
  "required": [
    "address",
    "remain_times",
    "status",
    "order_count",
    "page_size",
    "page",
    "orders"
  ]
}

EnergyTimesData 횟수제 변경 후 주소 상태.

횟수제 변경 후 주소 상태.

필드	유형 / 필수	설명 및 제약
`address`	string 필수	TRON 주소
`remain_times`	integer 필수	남은 사용 가능 횟수
`status`	string 필수	서비스 상태: 활성 / 일시 중지 열거값: `"start"` / `"stop"`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数的地址状态信息（用于更新响应）。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON 地址"
    },
    "remain_times": {
      "type": "integer",
      "description": "剩余可用笔数"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": "服务状态 (启用/暂停)"
    }
  },
  "required": [
    "address",
    "remain_times",
    "status"
  ]
}

EnergySmartDelegateResponseData 자동 관리 위임 성공 데이터.

자동 관리 위임 성공 데이터.

필드	유형 / 필수	설명 및 제약
`address`	string 필수	위임 대상 주소
`balance`	string 필수	작업 후 총잔액(형식화된 문자열)
`status`	string 필수	현재 서비스 상태 열거값: `"start"` / `"stop"`
`net_protect`	string 필수로 지정되지 않음	대역폭 모드 열거값: `"open"` / `"close"`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管委托成功后的响应数据。",
  "properties": {
    "address": {
      "type": "string",
      "description": "委托的目标地址"
    },
    "balance": {
      "type": "string",
      "description": "操作后的总余额 (格式化字符串)"
    },
    "status": {
      "type": "string",
      "description": "当前服务状态",
      "enum": [
        "start",
        "stop"
      ]
    },
    "net_protect": {
      "type": "string",
      "description": "带宽模式",
      "enum": [
        "open",
        "close"
      ]
    }
  },
  "required": [
    "address",
    "balance",
    "status"
  ]
}

EnergySmartOrderItem 자동 관리 사용 기록

자동 관리 사용 기록

필드	유형 / 필수	설명 및 제약
`energy_type`	string 필수로 지정되지 않음	에너지 유형: 65k=65K, 131k=131K null 허용
`amount`	number · float 필수로 지정되지 않음	사용 금액 null 허용
`balance`	number · float 필수로 지정되지 않음	사용 후 잔액 null 허용
`currency`	string 필수로 지정되지 않음	통화 null 허용 열거값: `"trx"` / `"usdt"`
`status`	string 필수로 지정되지 않음	에너지 상태 null 허용 열거값: `"init"` / `"waiting_delegate"` / `"delegate_success"` / `"delegate_failed"` / `"waiting_un_delegate"` / `"un_delegate_success"` / `"un_delegate_failed"`
`used_tx_id`	string 필수로 지정되지 않음	에너지를 사용한 거래 해시 null 허용
`speed_mode`	string 필수로 지정되지 않음	에너지 모드 null 허용 열거값: `"normal"` / `"low_speed"`
`used_energy`	integer 필수로 지정되지 않음	소비 에너지 수량 null 허용
`used_times`	integer 필수로 지정되지 않음	사용 횟수 null 허용
`remain_times`	integer 필수로 지정되지 않음	주소의 총 남은 횟수 null 허용
`delegate_count`	integer 필수로 지정되지 않음	위임 에너지 수량 null 허용
`delegate_tx_id`	string 필수로 지정되지 않음	에너지 위임 거래 해시 null 허용
`delegate_time`	integer 필수로 지정되지 않음	위임 타임스탬프 null 허용
`un_delegate_tx_id`	string 필수로 지정되지 않음	에너지 회수 거래 해시 null 허용
`un_delegate_time`	integer 필수로 지정되지 않음	회수 타임스탬프 null 허용
`createtime`	integer 필수로 지정되지 않음	기록 생성 타임스탬프 null 허용

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管消耗记录项",
  "properties": {
    "energy_type": {
      "type": "string",
      "nullable": true,
      "description": "能量类型: 65k=65K能量, 131k=131K能量"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "消耗金额"
    },
    "balance": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "消耗后余额"
    },
    "currency": {
      "type": "string",
      "nullable": true,
      "description": "币种",
      "enum": [
        "trx",
        "usdt"
      ]
    },
    "status": {
      "type": "string",
      "nullable": true,
      "description": "能量状态",
      "enum": [
        "init",
        "waiting_delegate",
        "delegate_success",
        "delegate_failed",
        "waiting_un_delegate",
        "un_delegate_success",
        "un_delegate_failed"
      ]
    },
    "used_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "消耗能量的交易哈希"
    },
    "speed_mode": {
      "type": "string",
      "nullable": true,
      "description": "能量模式",
      "enum": [
        "normal",
        "low_speed"
      ]
    },
    "used_energy": {
      "type": "integer",
      "nullable": true,
      "description": "消耗的能量值"
    },
    "used_times": {
      "type": "integer",
      "nullable": true,
      "description": "使用笔数"
    },
    "remain_times": {
      "type": "integer",
      "nullable": true,
      "description": "地址剩余总笔数"
    },
    "delegate_count": {
      "type": "integer",
      "nullable": true,
      "description": "委托的能量数量"
    },
    "delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "委托能量的交易哈希"
    },
    "delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": "委托时间戳"
    },
    "un_delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "回收能量的交易哈希"
    },
    "un_delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": "回收时间戳"
    },
    "createtime": {
      "type": "integer",
      "nullable": true,
      "description": "记录创建时间戳"
    }
  }
}

EnergySmartQueryResponseData 자동 관리 주소 조회 결과.

자동 관리 주소 조회 결과.

필드	유형 / 필수	설명 및 제약
`address`	string 필수	TRON 주소
`balance`	string 필수	남은 사용 가능 잔액(형식화된 문자열)
`status`	string 필수	서비스 상태: 활성 / 일시 중지 열거값: `"start"` / `"stop"`
`order_count`	integer 필수	총 사용 기록 수
`page_size`	integer 필수	페이지당 기록 수
`page`	integer 필수	현재 페이지 번호
`orders`	array<EnergySmartOrderItem> 필수	현재 페이지의 사용 기록

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管服务的地址查询结果。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON 地址"
    },
    "balance": {
      "type": "string",
      "description": "剩余可用额度 (格式化字符串)"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": "服务状态 (启用/暂停)"
    },
    "order_count": {
      "type": "integer",
      "description": "总消耗记录数"
    },
    "page_size": {
      "type": "integer",
      "description": "每页记录数"
    },
    "page": {
      "type": "integer",
      "description": "当前页码"
    },
    "orders": {
      "type": "array",
      "description": "当前页的消耗记录列表",
      "items": {
        "$ref": "#/components/schemas/EnergySmartOrderItem"
      }
    }
  },
  "required": [
    "address",
    "balance",
    "status",
    "order_count",
    "page_size",
    "page",
    "orders"
  ]
}

EnergySmartData 자동 관리 변경 후 주소 상태.

자동 관리 변경 후 주소 상태.

필드	유형 / 필수	설명 및 제약
`address`	string 필수	TRON 주소
`balance`	string 필수	남은 사용 가능 잔액(형식화된 문자열)
`status`	string 필수	서비스 상태: 활성 / 일시 중지 열거값: `"start"` / `"stop"`
`net_protect`	string 필수로 지정되지 않음	대역폭 모드 열거값: `"open"` / `"close"`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管服务的地址状态信息（用于更新响应）。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON 地址"
    },
    "balance": {
      "type": "string",
      "description": "剩余可用额度 (格式化字符串)"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": "服务状态 (启用/暂停)"
    },
    "net_protect": {
      "type": "string",
      "description": "带宽模式",
      "enum": [
        "open",
        "close"
      ]
    }
  },
  "required": [
    "address",
    "balance",
    "status"
  ]
}

StatisticsDetail 단일 기간의 자동 관리 통계.

단일 기간의 자동 관리 통계.

필드	유형 / 필수	설명 및 제약
`65k`	integer 필수	65k 작업 횟수 예시: `8`
`131k`	integer 필수	131k 작업 횟수 예시: `15`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "单个时间段的智能托管统计详情。",
  "properties": {
    "65k": {
      "type": "integer",
      "description": "65k 类型操作笔数",
      "example": 8
    },
    "131k": {
      "type": "integer",
      "description": "131k 类型操作笔数",
      "example": 15
    }
  },
  "required": [
    "65k",
    "131k"
  ]
}

StatisticsSmartData 주소별 자동 관리 통계.

주소별 자동 관리 통계.

필드	유형 / 필수	설명 및 제약
`days`	object 필수	최근 5일 통계, 키는 YYYY-MM-DD. 동적 키 값: StatisticsDetail
`today`	StatisticsDetail 필수	오늘 통계
`yesterday`	StatisticsDetail 필수	어제 통계
`this_week`	StatisticsDetail 필수	이번 주(월요일부터 현재)
`this_month`	StatisticsDetail 필수	이번 달(1일부터 현재)

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管服务按地址统计结果。",
  "properties": {
    "days": {
      "type": "object",
      "description": "最近 5 天的统计 (键为 YYYY-MM-DD)。",
      "additionalProperties": {
        "$ref": "#/components/schemas/StatisticsDetail"
      }
    },
    "today": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": "今日统计"
    },
    "yesterday": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": "昨日统计"
    },
    "this_week": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": "本周统计 (周一至今)"
    },
    "this_month": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": "本月统计 (1号至今)"
    }
  },
  "required": [
    "days",
    "today",
    "yesterday",
    "this_week",
    "this_month"
  ]
}

StatisticsTimesData 주소별 에너지 횟수 통계.

주소별 에너지 횟수 통계.

필드	유형 / 필수	설명 및 제약
`days`	object 필수	최근 5일 통계, 키는 YYYY-MM-DD. 동적 키 값: integer
`today`	integer 필수	오늘 총횟수 예시: `5`
`yesterday`	integer 필수	어제 총횟수 예시: `8`
`this_week`	integer 필수	이번 주 총횟수(월요일부터) 예시: `30`
`this_month`	integer 필수	이번 달 총횟수(1일부터) 예시: `150`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数 按地址统计结果。",
  "properties": {
    "days": {
      "type": "object",
      "description": "最近 5 天的统计 (键为 YYYY-MM-DD)。",
      "additionalProperties": {
        "type": "integer",
        "example": 25,
        "description": "每日总笔数"
      }
    },
    "today": {
      "type": "integer",
      "example": 5,
      "description": "今日总笔数"
    },
    "yesterday": {
      "type": "integer",
      "example": 8,
      "description": "昨日总笔数"
    },
    "this_week": {
      "type": "integer",
      "example": 30,
      "description": "本周总笔数 (周一至今)"
    },
    "this_month": {
      "type": "integer",
      "example": 150,
      "description": "本月总笔数 (1号至今)"
    }
  },
  "required": [
    "days",
    "today",
    "yesterday",
    "this_week",
    "this_month"
  ]
}

PremiumOrderRequest 필드 정의

필드	유형 / 필수	설명 및 제약
`username`	string 필수	대상 Telegram 사용자명(@ 제외). 예시: `"telegram_user"`
`month`	integer 필수	구매 개월 수. 열거값: `3` / `6` / `12` 예시: `3`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "目标 Telegram 用户名 (不含 @)。",
      "example": "telegram_user"
    },
    "month": {
      "type": "integer",
      "description": "购买月数。",
      "enum": [
        3,
        6,
        12
      ],
      "example": 3
    }
  },
  "required": [
    "username",
    "month"
  ]
}

StarOrderRequest 필드 정의

필드	유형 / 필수	설명 및 제약
`username`	string 필수	대상 Telegram 사용자명(@ 제외). 예시: `"channel_owner"`
`count`	integer 필수	Stars 수량(50~10000). 최솟값: `50` 최댓값: `10000` 예시: `100`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "目标 Telegram 用户名 (不含 @)。",
      "example": "channel_owner"
    },
    "count": {
      "type": "integer",
      "description": "购买的星星数量 (50-10000)。",
      "minimum": 50,
      "maximum": 10000,
      "example": 100
    }
  },
  "required": [
    "username",
    "count"
  ]
}

PremiumOrderResponseData Premium 주문 제출 결과.

Premium 주문 제출 결과.

필드	유형 / 필수	설명 및 제약
`username`	string 필수	대상 사용자명
`period`	string 필수	구매 기간(예: "3month")
`order_id`	integer 필수	내부 주문 ID
`amount`	number · float 필수	주문 금액(TRX)
`price`	number · float 필수	요금 정보
`pay_status`	string 필수	결제 상태
`status`	string 필수	주문 처리 상태

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "Premium 会员下单成功响应数据。",
  "properties": {
    "username": {
      "type": "string",
      "description": "目标用户名"
    },
    "period": {
      "type": "string",
      "description": "购买周期 (例如 \"3month\")"
    },
    "order_id": {
      "type": "integer",
      "description": "内部订单 ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": "价格信息"
    },
    "pay_status": {
      "type": "string",
      "description": "支付状态"
    },
    "status": {
      "type": "string",
      "description": "订单处理状态"
    }
  },
  "required": [
    "username",
    "period",
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}

StarOrderResponseData Stars 주문 제출 결과.

Stars 주문 제출 결과.

필드	유형 / 필수	설명 및 제약
`username`	string 필수	대상 사용자명
`count`	integer 필수	구매 Stars 수량
`order_id`	integer 필수	내부 주문 ID
`amount`	number · float 필수	주문 금액(TRX)
`price`	number · float 필수	요금 정보
`pay_status`	string 필수	결제 상태
`status`	string 필수	주문 처리 상태

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "星星下单成功响应数据。",
  "properties": {
    "username": {
      "type": "string",
      "description": "目标用户名"
    },
    "count": {
      "type": "integer",
      "description": "购买的星星数量"
    },
    "order_id": {
      "type": "integer",
      "description": "内部订单 ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": "价格信息"
    },
    "pay_status": {
      "type": "string",
      "description": "支付状态"
    },
    "status": {
      "type": "string",
      "description": "订单处理状态"
    }
  },
  "required": [
    "username",
    "count",
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}

PremiumQueryResultData Premium 주문 조회 결과.

Premium 주문 조회 결과.

필드	유형 / 필수	설명 및 제약
`username`	string 필수로 지정되지 않음	대상 사용자명 null 허용
`nickname`	string 필수로 지정되지 않음	대상 사용자 표시 이름 null 허용
`period`	string 필수로 지정되지 않음	구매 기간 null 허용
`order_id`	integer 필수	주문 ID
`amount`	number · float 필수	주문 금액(TRX)
`price`	number · float 필수	요금 정보
`pay_status`	string 필수	결제 상태
`status`	string 필수	주문 처리 상태
`remark`	string 필수로 지정되지 않음	비고 또는 실패 사유(잘림) null 허용
`create_time`	string · date-time 필수로 지정되지 않음	주문 생성 시각 null 허용

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "Premium 订单查询结果数据。",
  "properties": {
    "username": {
      "type": "string",
      "nullable": true,
      "description": "目标用户名"
    },
    "nickname": {
      "type": "string",
      "nullable": true,
      "description": "目标用户昵称"
    },
    "period": {
      "type": "string",
      "nullable": true,
      "description": "购买周期"
    },
    "order_id": {
      "type": "integer",
      "description": "订单 ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": "价格信息"
    },
    "pay_status": {
      "type": "string",
      "description": "支付状态"
    },
    "status": {
      "type": "string",
      "description": "订单处理状态"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "description": "备注/失败原因 (截断后)"
    },
    "create_time": {
      "type": "string",
      "format": "date-time",
      "nullable": true,
      "description": "订单创建时间"
    }
  },
  "required": [
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}

StarQueryResultData Stars 주문 조회 결과.

Stars 주문 조회 결과.

필드	유형 / 필수	설명 및 제약
`username`	string 필수로 지정되지 않음	대상 사용자명 null 허용
`nickname`	string 필수로 지정되지 않음	대상 사용자 표시 이름 null 허용
`count`	integer 필수로 지정되지 않음	구매 Stars 수량 null 허용
`order_id`	integer 필수	주문 ID
`amount`	number · float 필수	주문 금액(TRX)
`price`	number · float 필수	요금 정보
`pay_status`	string 필수	결제 상태
`status`	string 필수	주문 처리 상태
`remark`	string 필수로 지정되지 않음	비고 또는 실패 사유(잘림) null 허용
`create_time`	string · date-time 필수로 지정되지 않음	주문 생성 시각 null 허용

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "星星订单查询结果数据。",
  "properties": {
    "username": {
      "type": "string",
      "nullable": true,
      "description": "目标用户名"
    },
    "nickname": {
      "type": "string",
      "nullable": true,
      "description": "目标用户昵称"
    },
    "count": {
      "type": "integer",
      "nullable": true,
      "description": "购买的星星数量"
    },
    "order_id": {
      "type": "integer",
      "description": "订单 ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": "价格信息"
    },
    "pay_status": {
      "type": "string",
      "description": "支付状态"
    },
    "status": {
      "type": "string",
      "description": "订单处理状态"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "description": "备注/失败原因 (截断后)"
    },
    "create_time": {
      "type": "string",
      "format": "date-time",
      "nullable": true,
      "description": "订单创建时间"
    }
  },
  "required": [
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}

FastRecoverOrderRequest 필드 정의

필드	유형 / 필수	설명 및 제약
`address`	string 필수	리소스 수신 TRON 주소 예시: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`
`count`	integer 필수	충전할 에너지·대역폭 수량 예시: `65000`
`resource_type`	string 필수	리소스 종류 열거값: `"energy"` / `"net"` 예시: `"energy"`

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "接收资源的 TRON 地址",
      "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "count": {
      "type": "integer",
      "description": "需要补充的能量或带宽数量",
      "example": 65000
    },
    "resource_type": {
      "type": "string",
      "description": "资源类型",
      "enum": [
        "energy",
        "net"
      ],
      "example": "energy"
    }
  },
  "required": [
    "address",
    "count",
    "resource_type"
  ]
}

FastRecoverOrderResponseData 충전 주문 조회 결과.

충전 주문 조회 결과.

필드	유형 / 필수	설명 및 제약
`order_id`	integer 필수	내부 주문 ID
`address`	string 필수	대상 주소
`energy_count`	integer 필수	요청한 에너지·대역폭 수량
`price`	number · float 필수로 지정되지 않음	단가(SUN) null 허용
`fee`	number · float 필수로 지정되지 않음	수수료(TRX) null 허용
`resource_type`	string 필수	리소스 종류 열거값: `"energy"` / `"net"`
`amount`	number · float 필수로 지정되지 않음	총액(TRX) null 허용
`status`	string 필수	주문 상태 열거값: `"waiting"` / `"success"` / `"failed"`
`delegate_txid`	string 필수로 지정되지 않음	위임 거래 해시 null 허용
`reclaim_txid`	string 필수로 지정되지 않음	회수 거래 해시 null 허용
`actual_recover_count`	integer 필수로 지정되지 않음	실제 충전 수량 null 허용

원본 모델 정의

OpenAPI · JSON

{
  "type": "object",
  "description": "速充订单查询结果数据。",
  "properties": {
    "order_id": {
      "type": "integer",
      "description": "内部订单 ID"
    },
    "address": {
      "type": "string",
      "description": "目标地址"
    },
    "energy_count": {
      "type": "integer",
      "description": "请求的能量/带宽数量"
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "单价 (SUN)"
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "手续费 (TRX)"
    },
    "resource_type": {
      "type": "string",
      "description": "资源类型",
      "enum": [
        "energy",
        "net"
      ]
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "总金额 (TRX)"
    },
    "status": {
      "type": "string",
      "description": "订单状态",
      "enum": [
        "waiting",
        "success",
        "failed"
      ]
    },
    "delegate_txid": {
      "type": "string",
      "nullable": true,
      "description": "委托交易哈希"
    },
    "reclaim_txid": {
      "type": "string",
      "nullable": true,
      "description": "回收交易哈希"
    },
    "actual_recover_count": {
      "type": "integer",
      "nullable": true,
      "description": "实际补充数量"
    }
  },
  "required": [
    "order_id",
    "address",
    "energy_count",
    "resource_type",
    "status"
  ]
}

API 버전 2.1.0 · 확인일 2026-09-30

API 정의 출처: API V2 개발 문서 . 이 사이트는 연동 안내와 전체 정의를 제공합니다. 원본 서비스가 업데이트되면 다시 확인하세요.

전체 OpenAPI 파일 다운로드

에너지 서비스를 내 앱에 연결하세요

계정 개설 후 연동 시작

세 개의 헤더와 하나의 서명

Node.js: 서명 및 잔액 조회

충전 후 사용 가능 잔액 조회

API별 지정된 방식으로 전달

예제: 에너지 1시간 구매

업무에 맞는 API 찾기

즉시 충전

자동 관리

기간제 임대

전체 API 참조 25

계정 관리

TRON 주소 활성화

헤더 및 매개변수

본문 · application/x-www-form-urlencoded

응답

사용자 정보 조회

헤더 및 매개변수

응답

리소스 주문

기간제 에너지 구매

헤더 및 매개변수

본문 · application/x-www-form-urlencoded

응답

기간제 대역폭 구매

헤더 및 매개변수

본문 · application/x-www-form-urlencoded

응답

에너지 회수

헤더 및 매개변수

본문 · application/x-www-form-urlencoded

응답

주문 결과 조회

헤더 및 매개변수

응답

리소스 요금 조회

헤더 및 매개변수

응답

즉시 충전

즉시 충전 요금 조회

헤더 및 매개변수

응답

에너지·대역폭 충전

헤더 및 매개변수

본문 · application/x-www-form-urlencoded

응답

충전 주문 상태 조회

헤더 및 매개변수

응답

자동 관리

자동 관리 요금 조회

헤더 및 매개변수

응답

자동 관리 한도 추가

헤더 및 매개변수

본문 · application/x-www-form-urlencoded

응답

자동 관리 상태 조회

헤더 및 매개변수

응답

자동 관리 상태 변경

헤더 및 매개변수

본문 · application/x-www-form-urlencoded

응답

자동 관리 통계 조회

헤더 및 매개변수

응답

횟수제 에너지

횟수제 에너지 요금 조회

헤더 및 매개변수

응답

에너지 횟수 추가

헤더 및 매개변수

본문 · application/x-www-form-urlencoded

응답

횟수제 에너지 상태 조회

헤더 및 매개변수

응답

주소 횟수제 서비스 상태 변경

에너지 서비스를
내 앱에 연결하세요