wallet/delegateresource - Delegate TRX Resources

Delegate staked bandwidth or energy resources to another TRON account.

EndpointCopy Anchor Link

POST /wallet/delegateresource

# Basic energy delegation
    curl -X POST https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/delegateresource \
      -H "Content-Type: application/json" \
      -d '{
        "owner_address": "TOwnerAddress...",
        "receiver_address": "TReceiverAddress...",
        "balance": 1000000000,
        "resource": "ENERGY",
        "visible": true
      }'

    # Delegate bandwidth with 3-day lock
    curl -X POST https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/delegateresource \
      -H "Content-Type: application/json" \
      -d '{
        "owner_address": "TOwnerAddress...",
        "receiver_address": "TReceiverAddress...",
        "balance": 500000000,
        "resource": "BANDWIDTH",
        "lock": true,
        "lock_period": 86400,
        "visible": true
      }'

    # Check delegation index
    curl -X POST https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/getdelegatedresourceaccountindex \
      -H "Content-Type: application/json" \
      -d '{
        "value": "TOwnerAddress...",
        "visible": true
      }'

    # Get delegation details between accounts
    curl -X POST https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/wallet/getdelegatedresource \
      -H "Content-Type: application/json" \
      -d '{
        "fromAddress": "TOwnerAddress...",
        "toAddress": "TReceiverAddress...",
        "visible": true
      }'

Important NotesCopy Anchor Link

Delegation RulesCopy Anchor Link

1. Must Stake First: Resources must be staked before delegation
2. Immediate Effect: Delegation takes effect immediately after transaction confirmation
3. Lock Period: Optional lock prevents reclaim until it ends. lock_period counts blocks of 3 seconds (28,800 blocks is 1 day). With lock: true and no period, java-tron locks for 3 days (86,400 blocks). The maximum is getMaxDelegateLockPeriod, 864,000 blocks (30 days)
4. Resource Ownership: Delegated resources remain owned by delegator
5. Reclaim Process: Use undelegateresource to reclaim delegated resources

Resource CalculationsCopy Anchor Link

• Energy delegation helps with smart contract execution
• Bandwidth delegation helps with transactions and transfers
• Receiver pays no TRX but can use delegated resources

Implementation ExamplesCopy Anchor Link

Delegation FlowCopy Anchor Link

graph LR
    A[Owner Stakes TRX] --> B[Resources Available]
    B --> C[Delegate to Receiver]
    C --> D[Receiver Uses Resources]
    D --> E[Resources Consumed]
    E --> F[Owner Can Reclaim]
    
    style A fill:#4CAF50
    style C fill:#2196F3
    style D fill:#FF9800

Best PracticesCopy Anchor Link

1. Calculate Before DelegatingCopy Anchor Link

// Always analyze needs first
const needs = await analyzeNeeds(receiverAddress);
const delegateAmount = Math.ceil(needs.energy.deficit / 9.7383); // energy per staked TRX per day, 3 Nov 2026

2. Use Locks StrategicallyCopy Anchor Link

• Lock for stable, long-term delegations
• Keep unlocked for flexible, short-term needs
• Consider 3-day default lock period

3. Monitor Resource UsageCopy Anchor Link

• Track receiver's consumption patterns
• Adjust delegations based on actual usage
• Implement alerts for high usage

4. Batch OperationsCopy Anchor Link

• Group multiple delegations together
• Reduces transaction overhead
• Easier management and tracking

Common ErrorsCopy Anchor Link

Use CasesCopy Anchor Link

• DApp Support: Provide resources for users to interact with your DApp
• Gaming: Enable free gameplay by covering resource costs
• DeFi Trading: Support traders with energy for smart contract calls
• Onboarding: Help new users get started without staking
• Resource Rental: Commercial resource delegation services

Related MethodsCopy Anchor Link

• wallet/undelegateresource - Reclaim delegated resources
• wallet/freezebalancev2 - Stake TRX for resources
• wallet/getaccountresource - View resource limits