wallet/getaccountnet | TRON API Docs

Get detailed bandwidth (net) information for a TRON account including free and staked bandwidth via Dwellir's RPC endpoint.

Get detailed bandwidth (network) resource information for an account.

Endpoint

Text

POST /wallet/getaccountnet

Request Parameters

Request

addressstring

Required parameter: Account address (base58 or hex)

visibleboolean

Optional parameter: Return base58 addresses (default: false returns hex)

Response Body

Response

resultOBJECT

`freeNetUsed` - Free bandwidth used today `freeNetLimit` - Total free bandwidth available (600 default) `NetUsed` - Staked bandwidth used `NetLimit` - Total staked bandwidth available `TotalNetLimit` - Combined total bandwidth limit `TotalNetWeight` - Total network bandwidth weight `assetNetUsed` - Map of TRC10 token bandwidth usage `assetNetLimit` - Map of TRC10 token bandwidth limits

# Get bandwidth info with base58 address    curl -X POST https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/getaccountnet \      -H "Content-Type: application/json" \      -d '{        "address": "TNPdqto8HiuMzoG7Vv9wyyYhWzCojLeHAF",        "visible": true      }'    # Get bandwidth info with hex address    curl -X POST https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/getaccountnet \      -H "Content-Type: application/json" \      -d '{        "address": "TNPdqto8HiuMzoG7Vv9wyyYhWzCojLeHAF"      }'

// Get account bandwidth information    const response = await fetch('https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/getaccountnet', {      method: 'POST',      headers: {        'Content-Type': 'application/json',      },      body: JSON.stringify({        address: 'TNPdqto8HiuMzoG7Vv9wyyYhWzCojLeHAF',        visible: true      }),    });    const data = await response.json();    // Calculate bandwidth usage    const freeUsagePercent = (data.freeNetUsed / data.freeNetLimit) * 100;    const stakedUsagePercent = data.NetLimit > 0 ? (data.NetUsed / data.NetLimit) * 100 : 0;    console.log('Bandwidth Information:');    console.log(`Free Bandwidth: ${data.freeNetUsed}/${data.freeNetLimit} (${freeUsagePercent.toFixed(1)}%)`);    console.log(`Staked Bandwidth: ${data.NetUsed}/${data.NetLimit} (${stakedUsagePercent.toFixed(1)}%)`);    // Check if needs more bandwidth    const remainingFree = data.freeNetLimit - data.freeNetUsed;    const remainingStaked = data.NetLimit - data.NetUsed;    const totalRemaining = remainingFree + remainingStaked;    if (totalRemaining < 100) {      console.log('Warning: Low bandwidth! Consider staking more TRX.');    }

import requests    url = "https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/getaccountnet"    payload = {        "address": "TNPdqto8HiuMzoG7Vv9wyyYhWzCojLeHAF",        "visible": True    }    response = requests.post(url, json=payload)    data = response.json()    # Display bandwidth information    print("=== Bandwidth Information ===")    print(f"Free Bandwidth: {data.get('freeNetUsed', 0)}/{data.get('freeNetLimit', 0)}")    print(f"Staked Bandwidth: {data.get('NetUsed', 0)}/{data.get('NetLimit', 0)}")    # Calculate usage percentages    free_limit = data.get('freeNetLimit', 1)    staked_limit = data.get('NetLimit', 0)    free_usage = (data.get('freeNetUsed', 0) / free_limit * 100) if free_limit > 0 else 0    staked_usage = (data.get('NetUsed', 0) / staked_limit * 100) if staked_limit > 0 else 0    print(f"\nUsage Rates:")    print(f"  Free: {free_usage:.1f}%")    print(f"  Staked: {staked_usage:.1f}%")    # Check TRC10 token bandwidth    asset_net = data.get('assetNetUsed', {})    if asset_net:        print("\nTRC10 Token Bandwidth:")        for token_id, used in asset_net.items():            limit = data.get('assetNetLimit', {}).get(token_id, 0)            print(f"  Token {token_id}: {used}/{limit}")

{    "freeNetLimit": 600,    "NetUsed": 10233992,    "NetLimit": 157582708,    "assetNetUsed": [        {            "key": "1004977",            "value": 0        },        ...    ],    "assetNetLimit": [        {            "key": "1004977",            "value": 1        },        {            "key": "1004920",            "value": 1        },        ...    ],    "TotalNetLimit": 43200000000,    "TotalNetWeight": 26603102669}

Implementation Examples

Bash

# Get bandwidth info with base58 address
curl -X POST https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/getaccountnet \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TNPdqto8HiuMzoG7Vv9wyyYhWzCojLeHAF",
    "visible": true
  }'

# Get bandwidth info with hex address
curl -X POST https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/getaccountnet \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TNPdqto8HiuMzoG7Vv9wyyYhWzCojLeHAF"
  }'

Bandwidth Calculation

JavaScript

// Calculate bandwidth costs for transactions
function calculateBandwidthNeeded(transactionSize) {
  // Basic transaction is ~200 bytes
  // Smart contract calls can be 300-500 bytes
  return transactionSize;
}

// Calculate TRX needed for bandwidth
function calculateTRXForBandwidth(bandwidthNeeded) {
  // 1 TRX = 1 bandwidth point when staked
  return bandwidthNeeded;
}

// Example: Check if account has enough bandwidth
async function checkBandwidth(address, transactionSize) {
  const response = await fetch(`${API_URL}/wallet/getaccountnet`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ address, visible: true })
  });
  
  const data = await response.json();
  
  const availableFree = data.freeNetLimit - data.freeNetUsed;
  const availableStaked = data.NetLimit - data.NetUsed;
  const totalAvailable = availableFree + availableStaked;
  
  return {
    hasEnough: totalAvailable >= transactionSize,
    available: totalAvailable,
    needed: transactionSize,
    deficit: Math.max(0, transactionSize - totalAvailable)
  };
}

Bandwidth Management

Daily Reset

Free bandwidth resets daily at 00:00 UTC
Staked bandwidth usage resets daily
TRC10 token bandwidth resets based on token settings

Priority Order

TRC10 Token Bandwidth: Used first for token transfers
Free Bandwidth: 600 points daily for all accounts
Staked Bandwidth: From frozen TRX
TRX Burning: If no bandwidth available, burns TRX

Bandwidth Consumption

Operation	Typical Bandwidth
TRX Transfer	~250 points
TRC10 Transfer	~300 points
Smart Contract Call	350-500 points
Account Creation	~1000 points
Multi-signature	+100 points per signature

Best Practices

1. Monitor Usage