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

Response

200 - application/json

Brokerage update transaction

The response is of type object.