POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
updatebrokerage
wallet/updatebrokerage
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/updatebrokerage \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "41928c9af0651632157ef27a2cf17ca72c575a4d21",
  "brokerage": 15
}'
{
  "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 update the brokerage rate for witness rewards. Only witnesses can call this method to adjust how they share block production rewards with their voters.
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 — hexadecimal address of the witness account updating the brokerage rate
  • brokerage — new brokerage percentage (0-100) where lower values mean more rewards shared with voters

​
Response

  • visible — boolean indicating whether addresses are in visible format
  • txID — unique transaction ID for the brokerage update transaction
  • raw_data — raw transaction data containing:
    • contract — array with brokerage update 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/updatebrokerage method is used for:
  • Adjusting witness reward sharing policies to attract more voters.
  • Setting competitive brokerage rates compared to other witnesses.
  • Implementing dynamic reward sharing strategies based on market conditions.
  • Managing witness economics to balance profitability and voter incentives.
Only registered witnesses can update their brokerage rate. The brokerage rate determines what percentage of block rewards the witness keeps (0-100%). A rate of 20% means the witness keeps 20% and shares 80% with voters. Changes may take effect after the next maintenance period.

Body

application/json
​
owner_address
string
required

Witness account address in hex format

​
brokerage
number
required

New brokerage percentage (0-100)

Response

200 - application/json

Brokerage update transaction

​
visible
boolean

Whether addresses are in visible format

​
txID
string

Transaction ID for the brokerage update

​
raw_data
object
​
raw_data_hex
string

Raw transaction data in hex format