Voting & SRs

tokenview大约 2 分钟

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.

请求参数说明:

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)

请求参数说明:

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. 请求参数说明:

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.

请求参数说明:

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

请求参数说明:

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.

请求参数说明:

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.

请求参数说明:

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}