POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
votewitnessaccount
wallet/votewitnessaccount
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/votewitnessaccount \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "41b487cdb2d8dc7b2a8e5e7e7b4e3e8b8b8b8b8b",
  "votes": [
    {
      "vote_address": "41928c9af0651632157ef27a2cf17ca72c575a4d21",
      "vote_count": 1000000
    },
    {
      "vote_address": "4154ca0d507e9e54dc60f9c02aea441ffb2b4f82cd",
      "vote_count": 500000
    }
  ]
}'
{
  "visible": true,
  "txID": "<string>",
  "raw_data": {
    "contract": [
      "<any>"
    ],
    "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 you own node endpoint todayStart 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 in hexadecimal format
  • votes — array of vote allocations, each containing:
    • vote_address — hexadecimal address of the witness to vote for
    • vote_count — number of votes to allocate to this witness

​
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.

Body

application/json
​
owner_address
string
required

Voting account address in hex format

​
votes
object[]
required

Array of vote allocations

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
​
raw_data_hex
string

Raw transaction data in hex format