Votes

A vote is a specific type of transaction (type 3). A wallet votes on a different wallet, which has registered itself eligible to become a Delegate. Wallets may vote for themselves.

Users are often confused by the voting mechanism and the fee associated with a vote. A Delegate does not receive ARK from their voters, nor is the number of blocks they produce proportional to their voting weight.

List All Votes

All voting transactions may be obtained through this API. This is the equivalent of transactions/search with the body parameter type: 3.

Endpoint

GET /api/votes

Query Parameters

Name

Type

Description

Required

page

int

The number of the page that will be returned.

No

limit

int

The number of resources per page.

No

Response

{
"meta": {
"count": 2,
"pageCount": 658,
"totalCount": 1315,
"next": "/v2/votes?page=2",
"previous": null,
"self": "/v2/votes?page=1",
"first": "/v2/votes?page=1",
"last": "/v2/votes?page=658"
},
"data": [
{
"id": "560959e435cbf8eec60691890f3dd55d141e76077e1fe803f65d137c91099240",
"blockId": "12872155462883631430",
"version": 1,
"type": 3,
"amount": 0,
"fee": 100000000,
"sender": "DAp7JjULVgqzd4jLofkUyLRovHRPUTQwiZ",
"recipient": "DAp7JjULVgqzd4jLofkUyLRovHRPUTQwiZ",
"signature": "30440220522eadff84b5b4b2fc6a3ef611bf093dbd0a06963c32c767ee28729898d0a1d302203f851594e5b2271a987e98daa4fc8b5f384fac65c41eb1c43739af2d4b5dc902",
"asset": {
"votes": [
"-032fe001dff675a6edfe3d0e51201b2900d3b5050a46d770306aefaa574c022672"
]
},
"confirmations": 39989,
"timestamp": {
"epoch": 32414926,
"unix": 1522516126,
"human": "2018-03-31T17:08:46Z"
}
}
]
}

Retrieve a Vote

Votes may be retrieved using their transaction ID. Note the asset field, which contains the votes object. The first character of each item in the array indicates if it was a vote: +, or unvote: -, followed by the public key of the Delegate.

Endpoint

GET /api/votes/{id}

Query Parameters

Name

Type

Description

Required

id

string

The identifier of the vote to be retrieved.

Yes

Response

{
"data": {
"id": "beb8dd43c640f562704090159154b2742afba7eacada9e8edee447e34e7675c6",
"blockId": "13661015019049808045",
"version": 1,
"type": 3,
"amount": 0,
"fee": 100000000,
"sender": "DAp7JjULVgqzd4jLofkUyLRovHRPUTQwiZ",
"recipient": "DAp7JjULVgqzd4jLofkUyLRovHRPUTQwiZ",
"signature": "3045022100e9a743c5aa0df427f49af61d35fe617182479f7e8d368ce23b7ec43ab6d269c80220193aafd4ccb3eedbd76ded7ea99f31629013dc3af60540029fe98b274d42d284",
"asset": {
"votes": [
"+032fe001dff675a6edfe3d0e51201b2900d3b5050a46d770306aefaa574c022672"
]
},
"confirmations": 48189,
"timestamp": {
"epoch": 32338609,
"unix": 1522439809,
"human": "2018-03-30T19:56:49Z"
}
}
}