Delegates

List All Delegates

You can obtain all Delegates through this paginated API. Note that all registered Delegates are returned in this response, not just the top 51 forging Delegates. If a Delegate Node is offline, it is still returned through this API; as the delegate resource is not concerned with the actual nodes, only with the on-chain registrations and wallets.

Method: GET

https://ark.nownodes.io/api/delegates?page=1&limit=100

Example response: 200

{
    "meta": {
        "totalCountIsEstimate": false,
        "count": 100,
        "pageCount": 14,
        "totalCount": 1316,
        "next": "/delegates?page=2&limit=100",
        "previous": null,
        "self": "/delegates?page=1&limit=100",
        "first": "/delegates?page=1&limit=100",
        "last": "/delegates?page=14&limit=100"
    },
    "data": [
        {
            "username": "biz_classic",
            "address": "AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj",
            "publicKey": "020431436cf94f3c6a6ba566fe9e42678db8486590c732ca6c3803a10a86f50b92",
            "votes": "160429417428723",
            "rank": 1,
            "isResigned": false,
            "blocks": {
                "produced": 530874,
                "last": {
                    "id": "caae186685491c9d6275d29f508c147d6168df85148a67e96a64b8ace1eb0c0c",
                    "height": 28012372,
                    "timestamp": {
                        "epoch": 225857256,
                        "unix": 1715958456,
                        "human": "2024-05-17T15:07:36.000Z"
                    }
                }
            },
            "production": {
                "approval": 0.89
            },
            "forged": {
                "fees": "1287319987960",
                "rewards": "106174800000000",
                "total": "107462119987960"
            }
        },
...

Retrieve a Delegate

You can query for a specific delegate by username, address, and public key; thus the following queries will result in an identical response. Note that public keys are always known for delegates, as they have previously transmitted a registration transaction. This is not the case for regular wallets.

Method: GET

https://ark.nownodes.io/api/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj

Example response: 200

{
    "data": {
        "username": "biz_classic",
        "address": "AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj",
        "publicKey": "020431436cf94f3c6a6ba566fe9e42678db8486590c732ca6c3803a10a86f50b92",
        "votes": "160429417428723",
        "rank": 1,
        "isResigned": false,
        "blocks": {
            "produced": 530876,
            "last": {
                "id": "a7192c4fb1f5eec67441e3d8beadbb1b38019bc0bca73ae42125312343ab1ee6",
                "height": 28012490,
                "timestamp": {
                    "epoch": 225858200,
                    "unix": 1715959400,
                    "human": "2024-05-17T15:23:20.000Z"
                }
            }
        },
        "production": {
            "approval": 0.89
        },
        "forged": {
            "fees": "1287319987960",
            "rewards": "106175200000000",
            "total": "107462519987960"
        }
    }
}

List All Voters of a Delegate

Obtaining the voters of a Delegate is trivial as well. This endpoint returns active voters. To acquire historical voters, it is better to query the database directly.

Method: GET

https://ark.nownodes.io/api/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/voters?page=1

Example response: 200

{
    "meta": {
        "totalCountIsEstimate": false,
        "count": 100,
        "pageCount": 68,
        "totalCount": 6744,
        "next": "/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/voters?page=2&limit=100",
        "previous": null,
        "self": "/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/voters?page=1&limit=100",
        "first": "/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/voters?page=1&limit=100",
        "last": "/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/voters?page=68&limit=100"
    },
    "data": [
        {
            "address": "AaU8sdkH1eL5QAKHybFZAE8C9Y9QH4cxaK",
            "publicKey": "02cece0b45fa007c1dbcb846c34a16791494761fc27870b2f6615c2c8e4a49bd33",
            "balance": "4808382461309",
            "nonce": "1",
            "attributes": {
                "vote": "020431436cf94f3c6a6ba566fe9e42678db8486590c732ca6c3803a10a86f50b92"
            }
        },
        {
            "address": "AHPSUiWiS9QUhhxzM6feUxge8ohkNmxjQp",
            "publicKey": "03769dd6051d02b65ec9343f4296089213a73478254cca19434d608fc1cfd1f656",
            "balance": "4728173809253",
            "nonce": "7",
            "attributes": {
                "vote": "020431436cf94f3c6a6ba566fe9e42678db8486590c732ca6c3803a10a86f50b92"
            }
        },
        {
            "address": "ARbyCKDFJBKPFfK5T1cbXv9wWDTv3pJXyq",
            "publicKey": "026658cba848391cc8e6450e8c67f74687119487bae44444b5e2ef7664b9270bb1",
            "balance": "1870986207569",
            "nonce": "1",
            "attributes": {
                "vote": "020431436cf94f3c6a6ba566fe9e42678db8486590c732ca6c3803a10a86f50b92"
            }
        },
        {
            "address": "AMLavx4vDjy1nM5rK5PnUCqSFXxJu3v69E",
            "publicKey": "03b1e777c6aa61a1e0d87fd2811aaebcc712a7e1bf2b85a1c4edbed29cd7a90ac9",
            "balance": "1804054426661",
            "nonce": "1",
            "attributes": {
                "vote": "020431436cf94f3c6a6ba566fe9e42678db8486590c732ca6c3803a10a86f50b92"
            }
        },
...

List All Blocks of a Delegate

The delegate resource allows you to obtain blocks from a specific Delegate. This is the equivalent of searching for blocks using the generatorPublicKey.

Method: GET

https://ark.nownodes.io/api/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/blocks?page=1&limit=100

Example response: 200

{
    "meta": {
        "totalCountIsEstimate": true,
        "count": 100,
        "pageCount": 5530,
        "totalCount": 552906,
        "next": "/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/blocks?page=2&limit=100&transform=true",
        "previous": null,
        "self": "/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/blocks?page=1&limit=100&transform=true",
        "first": "/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/blocks?page=1&limit=100&transform=true",
        "last": "/delegates/AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj/blocks?page=5530&limit=100&transform=true"
    },
    "data": [
        {
            "id": "a7192c4fb1f5eec67441e3d8beadbb1b38019bc0bca73ae42125312343ab1ee6",
            "version": 0,
            "height": 28012490,
            "previous": "895420f7bd783e00327ff1301f1baeed0f6b22b564e6cf6477d3f9b8526183b8",
            "forged": {
                "reward": "200000000",
                "fee": "0",
                "amount": "0",
                "total": "200000000"
            },
            "payload": {
                "hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
                "length": 0
            },
            "generator": {
                "username": "biz_classic",
                "address": "AKdr5d9AMEnsKYxpDcoHdyyjSCKVx3r9Nj",
                "publicKey": "020431436cf94f3c6a6ba566fe9e42678db8486590c732ca6c3803a10a86f50b92"
            },
            "signature": "3045022100ae0eb02404339ee311dab5b7ced5d2ce50bd37024de219d3c450a64d90db220602205130fb2a7c9aade86ca3964498f97ee92ad5aa60f3d63fa486d1d793ddfae6f8",
            "confirmations": 28,
            "transactions": 0,
            "timestamp": {
                "epoch": 225858200,
                "unix": 1715959400,
                "human": "2024-05-17T15:23:20.000Z"
            }
        },
        {
            "id": "e99e1c8df0eb900c51b30015f59a6336bca976528d9132534b202883f6d45e60",
            "version": 0,
            "height": 28012461,
            "previous": "a125e915d62e399d6164c17a283e7af6418c60cb085224c2db40658937c02a2f",
            "forged": {
                "reward": "200000000",
                "fee": "0",
                "amount": "0",
                "total": "200000000"
            },
...