Voting & SRs

listwitnesses

GET https://services.tokenview.io/vipapi/nodeservice/trx/wallet/listwitnesses?apikey={apikey}

List all Super Representatives.

Request

curl --location https://services.tokenview.io/vipapi/nodeservice/trx/wallet/listwitnesses?apikey={apikey}

Response

createwitness

POST https://services.tokenview.io/vipapi/nodeservice/trx/wallet/createwitness?apikey={apikey}

Apply to become a witness.

Parameters:

• owner_address: string. Owner address, default hexString
• url: string. Website url, default hexString
• permission_id: int32. Optional, for multi-signature use
• visible: boolean. Optional, Whether the address is in base58 format.

Request

curl --location -g 'https://services.tokenview.io/vipapi/nodeservice/trx/wallet/createwitness?apikey={apikey}' \
--data '{
  "owner_address": "41d1e7a6bc354106cb410e65ff8b181c600ff14292",
  "url": "007570646174654e616d6531353330363038383733343633",
  "permission_id": 0,
  "visible": true
}'

Response

updatewitness

POST https://services.tokenview.io/vipapi/nodeservice/trx/wallet/updatewitness?apikey={apikey}

Edit the URL of the witness's official website.

Arguments:

Argument	Description	Type
owner_address	The creator's address	string (hex)
update_url	Updated URL	string (hex)

Parameters:

• owner_address: string. Owner address, default hexString
• update_url: string. Website url, default hexString
• permission_id: int32. Optional, for multi-signature use
• visible: boolean. Optional, Whether the address is in base58 format.

Request

curl --location -g 'https://services.tokenview.io/vipapi/nodeservice/trx/wallet/updatewitness?apikey={apikey}' \
--data '{
  "owner_address": "41d1e7a6bc354106cb410e65ff8b181c600ff14292",
  "update_url": "string",
  "permission_id": 0,
  "visible": true
}'

Response

getBrokerage

POST https://services.tokenview.io/vipapi/nodeservice/trx/wallet/getBrokerage?apikey={apikey}

Get SR brokerage ratio. Parameters:

• address: string. Super representative's account address
• visible: boolean. Optional, Whether the address is in base58 format.

Request

curl --location -g 'https://services.tokenview.io/vipapi/nodeservice/trx/wallet/getBrokerage?apikey={apikey}' \
--data '{
  "address": "TGj1Ej1qRzL9feLTLhjwgxXF4Ct6GTWg2U",
  "visible": true
}'

Response

{
    "brokerage": 20
}

updateBrokerage

POST https://services.tokenview.io/vipapi/nodeservice/trx/wallet/updateBrokerage?apikey={apikey}

Update the witness's brokerage setting.

Parameters:

• owner_address: string. Super representative's account address
• brokerage: int32. The brokerage ratio of the super representative, for example: 20 means 20%, 100 means 100%
• visible: boolean. Optional, Whether the address is in base58 format.

Request

curl --location -g 'https://services.tokenview.io/vipapi/nodeservice/trx/wallet/updateBrokerage?apikey={apikey}' \
--data '{
  "owner_address": "414A193C92CD631C1911B99CA964DA8FD342F4CDDD",
  "brokerage": 20,
  "visible": true
}'

Response

votewitnessaccount

POST https://services.tokenview.io/vipapi/nodeservice/trx/wallet/votewitnessaccount?apikey={apikey}

Vote for witnesses

Parameters:

• owner_address: string. Owner address, default hexString
• votes: array of objects. 'vote_address' stands for the address of the witness you want to vote, default hexString, 'vote_count' stands for the number of votes you want to vote
• permission_id: int32. Optional, for multi-signature use
• visible: boolean. Optional, Whether the address is in base58 format.

Request

curl --location -g 'https://services.tokenview.io/vipapi/nodeservice/trx/wallet/votewitnessaccount?apikey={apikey}' \
--data '{
  "owner_address": "41d1e7a6bc354106cb410e65ff8b181c600ff14292",
  "votes": [
    {
      "vote_address": "41e552f6487585c2b58bc2c9bb4492bc1f17132cd0",
      "vote_count": 0
    }
  ],
  "permission_id": 0,
  "visible": true
}'

Response

getReward

POST https://services.tokenview.io/vipapi/nodeservice/trx/wallet/getReward?apikey={apikey}

Get the rewards that a witness or a user has not yet withdrawn.

Parameters:

• address: string. User's address
• visible: boolean. Optional, Whether the address is in base58 format.

Request

curl --location -g 'https://services.tokenview.io/vipapi/nodeservice/trx/wallet/getReward?apikey={apikey}' \
--data '{
  "address": "TGj1Ej1qRzL9feLTLhjwgxXF4Ct6GTWg2U",
  "visible": true
}'

Response

{
    "reward": 14369299546
}

withdrawbalance

POST https://services.tokenview.io/vipapi/nodeservice/trx/wallet/withdrawbalance?apikey={apikey}

Super Representative or user withdraw rewards, usable every 24 hours.

Super representatives can withdraw the balance from the account allowance into the account balance,

Users can claim the voting reward from the SRs and deposit into his account balance.

Parameters:

• owner_address: string. Super representative or user address
• visible: boolean. Optional, Whether the address is in base58 format.

Request

curl --location -g 'https://services.tokenview.io/vipapi/nodeservice/trx/wallet/withdrawbalance?apikey={apikey}' \
--data '{
  "owner_address": "TGj1Ej1qRzL9feLTLhjwgxXF4Ct6GTWg2U",
  "visible": true
}'

Response

getnextmaintenancetime

GET https://services.tokenview.io/vipapi/nodeservice/trx/wallet/getnextmaintenancetime?apikey={apikey}

Returns the timestamp of the next voting time in milliseconds.

Request

curl --location https://services.tokenview.io/vipapi/nodeservice/trx/wallet/getnextmaintenancetime?apikey={apikey}

Response