wallet/votewitnessaccount | TRON

POST /95e61622bf6a8af293978377718e3b77/wallet/votewitnessaccount

wallet/votewitnessaccount

cURL

curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/votewitnessaccount \
  --header 'Content-Type: application/json' \
  --data '
{
  "owner_address": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
  "votes": [
    {
      "vote_address": "TDdeM7G4HSxhn2MfovsiMWwXZkiFaHhjMB",
      "vote_count": 1000000
    },
    {
      "vote_address": "TAybtvPZCSj5kumiU4myD28xBy6WFtkgCu",
      "vote_count": 500000
    }
  ],
  "visible": true
}
'

200

{
  "visible": true,
  "txID": "<string>",
  "raw_data": {
    "contract": "<array>",
    "ref_block_bytes": "<string>",
    "ref_block_hash": "<string>",
    "expiration": 123,
    "timestamp": 123
  },
  "raw_data_hex": "<string>"
}

TRON API method that creates a transaction to vote for witnesses (validators) using frozen TRX balance. Voting is essential for TRON’s Delegated Proof of Stake (DPoS) governance system and helps determine which witnesses become Super Representatives.

Get your own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

• owner_address — address of the account casting votes. Use base58 with visible: true, or hex with visible: false.
• votes — array of vote allocations, each containing:
  • vote_address — witness address to vote for (base58 with visible: true, or a 21‑byte hex address starting with 41 when visible: false).
  • vote_count — number of votes to allocate to this witness.
• visible — optional boolean. When true, addresses are base58; when false, hex. Default is true.

Response

• visible — boolean indicating whether addresses are in visible format
• txID — unique transaction ID for the voting transaction
• raw_data — raw transaction data containing:
  • contract — array with witness voting contract details
  • ref_block_bytes — reference block bytes for transaction validation
  • ref_block_hash — hash of the reference block
  • expiration — transaction expiration timestamp
  • timestamp — transaction creation timestamp
• raw_data_hex — complete transaction data encoded in hexadecimal format

Use case

The wallet/votewitnessaccount method is used for:

• Participating in TRON network governance by voting for preferred witnesses.
• Supporting witnesses that align with your vision for network development.
• Earning voting rewards from witnesses who share profits with their voters.
• Influencing which witnesses become the top 27 Super Representatives.
• Distributing voting power across multiple witnesses for diversification.
• Contributing to network decentralization through democratic participation.

You can only vote using frozen TRX balance. You must have TRX frozen for Energy or Bandwidth to be eligible for voting. The total number of votes cannot exceed your frozen TRX balance, and votes can be distributed among multiple witnesses.

curl example

Shell

curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/votewitnessaccount' \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
  "votes": [
    { "vote_address": "TDdeM7G4HSxhn2MfovsiMWwXZkiFaHhjMB", "vote_count": 1000000 },
    { "vote_address": "TAybtvPZCSj5kumiU4myD28xBy6WFtkgCu", "vote_count": 500000 }
  ],
  "visible": true
}'

avoid Invalid address by matching address format with visible:

• base58 addresses → set visible: true (recommended for humans)
• hex addresses → set visible: false and use 21‑byte hex (42 hex chars) starting with 41

to get valid witness addresses, call wallet/listwitnesses and copy candidate addresses from the response.

Body

application/json

owner_address · string · required

Voting account address. Use base58 with visible: true, or hex with visible: false.

votes · object[] · required

Array of vote allocations

Show child attributes

visible · boolean · default: true

When true, addresses are base58; when false, hex.

Response

200 - application/json

Vote transaction for witnesses

visible · boolean

Whether addresses are in visible format

txID · string

Transaction ID for the vote

raw_data · object

Show child attributes

raw_data_hex · string

Raw transaction data in hex format