Error Codes

This page provides information about the error codes that can be returned by the TronZap API.

Error Response Format

When an error occurs, the API will return a response with a non-zero error code and an error message:

{
    "code": 1,
    "error": "Error message description"
}

Error Code List

Code	Description	Resolution
0	Success	Not an error. The request was successful.
1	Authentication error	Check your API token and ensure your signature is calculated correctly.
2	Invalid service or parameters	Check that the service name and parameters are correct.
5	Wallet not found	Verify the wallet address or contact support if you believe this is an error.
6	Insufficient funds	Add funds to your account or reduce the amount of energy you're requesting.
10	Invalid TRON address	Check the TRON address format. It should be a valid 34-character TRON address.
11	Invalid energy amount	Ensure the requested energy amount is valid.
12	Invalid duration	Check that the duration parameter is valid.
20	Transaction not found	Verify the transaction ID or external ID is correct.
24	Address not activated	Activate the address first by making an address activation transaction.
25	Address already activated	The address is already activated. No action needed.
500	Internal server error	Contact support if this error persists.

Handling Errors

When consuming the API, you should implement error handling logic for all possible error codes. Here are some recommendations:

Authentication Errors (Code 1)

Authentication errors indicate issues with your API credentials or signature calculation. You should:

• Verify your API token is correct
• Check your signature calculation logic
• Ensure your API secret is not exposed in client-side code

Resource Errors (Codes 5, 6, 10, 20)

Resource errors indicate issues with the provided resources. You should:

• Validate TRON addresses before sending them to the API
• Check account balance before making transactions
• Verify transaction IDs when checking status

Business Logic Errors (Codes 24, 25)

Business logic errors indicate issues with the requested operation. You should:

• Implement address activation check before attempting energy purchase
• Skip address activation if already activated