Wallets

List All Wallets

A paginated API is provided to obtain all wallets, including empty ones.

Method: GET

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

Example response: 200

{
    "meta": {
        "totalCountIsEstimate": false,
        "count": 100,
        "pageCount": 1977,
        "totalCount": 197638,
        "next": "/wallets?page=2&limit=100",
        "previous": null,
        "self": "/wallets?page=1&limit=100",
        "first": "/wallets?page=1&limit=100",
        "last": "/wallets?page=1977&limit=100"
    },
    "data": [
        {
            "address": "AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7",
            "publicKey": "0235c1e9af516ed080740b67486460682f8fe3f226eabaf273e8b49af497213623",
            "balance": "6151142115564825",
            "nonce": "90",
            "attributes": {}
        },
        {
            "address": "ATp5q7QzEnhkXk5Ca8bb7XtYuVZQnscL55",
            "publicKey": "033509eddab42f65ac37209cc2ed0750da096c7f516b737df8e6d58ca78abd9af2",
            "balance": "5206625837385924",
            "nonce": "9026",
            "attributes": {}
        },
        {
            "address": "AdS7WvzqusoP759qRo6HDmUz2L34u4fMHz",
            "publicKey": "03e7635481b035149829ef74f972e69eca75363bc96e75be57579b0e6fb3f22192",
            "balance": "704874100000001",
            "nonce": "25",
            "attributes": {}
        },
        {
            "address": "Aakg29vVhQhJ5nrsAHysTUqkTBVfmgBSXU",
            "publicKey": "0394e9f4d4eb47e8cbfda6e0d1a4082973ae178e3a60662ac84591c39d06e059f5",
            "balance": "279322996977335",
            "nonce": "95",
            "attributes": {}
        },
        {
            "address": "AHqPc4kBSkoK7Egz5r3GzLc1KKVwrV6UG3",
            "publicKey": "03b37a961941cd307e5a969b173b4167be4defcc56447112da8518ba626c246e39",
            "balance": "204627935222317",
            "nonce": "26",
            "attributes": {}
        },
...

Retrieve a Wallet

Specific wallets can be obtained either by their publicKey or address.

Method: GET

https://ark.nownodes.io/api/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7

Example response: 200

{
    "data": {
        "address": "AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7",
        "publicKey": "0235c1e9af516ed080740b67486460682f8fe3f226eabaf273e8b49af497213623",
        "balance": "6151142115564825",
        "nonce": "90",
        "attributes": {}
    }
}

List All Transactions of a Wallet

All transactions belonging to a wallet can be obtained using this API. Equivalent to /transactions with parameter address.

Method: GET

https://ark.nownodes.io/api/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions?page=1&limit=100

Example response: 200

{
    "meta": {
        "totalCountIsEstimate": true,
        "count": 100,
        "pageCount": 60,
        "totalCount": 5935,
        "next": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions?page=2&limit=100&transform=true",
        "previous": null,
        "self": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions?page=1&limit=100&transform=true",
        "first": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions?page=1&limit=100&transform=true",
        "last": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions?page=60&limit=100&transform=true"
    },
    "data": [
        {
            "id": "14bfccd3275503361f473d6b0b43ec8e25cccfce865fb77d9eb8997a9fae2ded",
            "blockId": "e5d2093aa2a73ebb9132f900a6156268c12b387a655778e177dedd90aa79045e",
            "version": 2,
            "type": 0,
            "typeGroup": 1,
            "amount": "379692510469",
            "fee": "10000000",
            "sender": "AN3drxhwZa41zrrUWgaYKxDnKRaiZxmbek",
            "senderPublicKey": "0298a14ea5c2e2065f86e25d260b41c8208996d4ac255edff739f2aeae04036d4c",
            "recipient": "AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7",
            "signature": "c8259f027b9ce092a27e6e73aa6ce5f17a0d1a8bbd824000d684e2204b5c06d4fa8aae1602279af9fd070a53d7f36362f099ea0f5f32ef8e31617f27e9782862",
            "confirmations": 68848,
            "timestamp": {
                "epoch": 225310048,
                "unix": 1715411248,
                "human": "2024-05-11T07:07:28.000Z"
            },
            "nonce": "51"
        },
        {
            "id": "6d28db38014f413a4e69b870c7fa23a5f688a5f89692f7ac190b406314a63eac",
            "blockId": "a4cd7af7daa07f0b5fc3ff0ccaa3100e1e0361da92448cbf8e4c396e96a57e84",
            "version": 2,
            "type": 0,
            "typeGroup": 1,
            "amount": "393960000000",
            "fee": "10000000",
            "sender": "AQgrTPiFAvX7kLUhKhjnnT7G4FsuWZuruK",
            "senderPublicKey": "028f8c71695e945ef153fedec576799e55d7cc6cc0c20a6a7233dd0eb76cc8eaee",
            "recipient": "AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7",
            "signature": "679e5e932cc71ee19c6ab9c21cc0a58909a74c8b058d9f6b51d75b82d42bbf9e0c1b64b57f62b4ba4222f8559a7a85f471f6874445bfedcaca22538ad269456d",
            "confirmations": 68851,
            "timestamp": {
                "epoch": 225310024,
                "unix": 1715411224,
                "human": "2024-05-11T07:07:04.000Z"
            },
            "nonce": "3"
        },
...

List All Sent Transactions of a Wallet

Outgoing transactions can be obtained as well, Equivalent to /transactions with parameter senderId set.

Method: GET

https://ark.nownodes.io/api/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/sent?page=1&limit=100

Example response: 200

{
    "meta": {
        "totalCountIsEstimate": true,
        "count": 90,
        "pageCount": 3,
        "totalCount": 210,
        "next": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/sent?page=2&limit=100&transform=true",
        "previous": null,
        "self": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/sent?page=1&limit=100&transform=true",
        "first": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/sent?page=1&limit=100&transform=true",
        "last": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/sent?page=3&limit=100&transform=true"
    },
    "data": [
        {
            "id": "50d3f17563a5186ded4f7518b3a2fdfc39951fed5dad008b6ae373c019ff800d",
            "blockId": "3a9bc0a12690beeb760bc6fabae51824f1b4fd25cb8d359666a75b8d5efa57c6",
            "version": 2,
            "type": 0,
            "typeGroup": 1,
            "amount": "26000000000000",
            "fee": "10000000",
            "sender": "AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7",
            "senderPublicKey": "0235c1e9af516ed080740b67486460682f8fe3f226eabaf273e8b49af497213623",
            "recipient": "AHqJpVRiYfMJFwSvNEXZshiGU3VA8GF7fo",
            "signature": "ef221ee16c85466bda597450fe236988b34b29e5caf2f8417a057b2a54e5b6c7cf6b1829fe39c9b768155d787b1859fa5de51e8315d10e77ad335085ecdc6fbb",
            "confirmations": 119490,
            "timestamp": {
                "epoch": 224902968,
                "unix": 1715004168,
                "human": "2024-05-06T14:02:48.000Z"
            },
            "nonce": "90"
        },
        {
            "id": "4defe8b94cfc2f9f547423e89cbca31d747a9338098e868df7945c1b882d1c26",
            "blockId": "d6e391371632bdf7072184fbd3670a7b46e79c873f02ea3e33d8a3c2b4125e23",
            "version": 2,
            "type": 0,
            "typeGroup": 1,
            "amount": "32000000000000",
            "fee": "10000000",
            "sender": "AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7",
            "senderPublicKey": "0235c1e9af516ed080740b67486460682f8fe3f226eabaf273e8b49af497213623",
            "recipient": "AeHn7xfUeMseqEcs1sQinJNnRoZpDcRvnC",
            "signature": "fd8087e20b4ab038f39add6d73a2ff1d014bb96623d9813fc551299a2b21b85d294ec02d0ecc279adc01c0e2c96b8f5f9e08f2bdf59a0ced3b6bc8d382553105",
            "confirmations": 177348,
            "timestamp": {
                "epoch": 224438320,
                "unix": 1714539520,
                "human": "2024-05-01T04:58:40.000Z"
            },
            "nonce": "89"
        },
...

List All Received Transactions of a Wallet

Incoming transactions can be obtained as well, Equivalent to /transactions with parameter recipientId set.

Method: GET

https://ark.nownodes.io/api/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/received?page=1&limit=100

Example response: 200

{
    "meta": {
        "totalCountIsEstimate": true,
        "count": 100,
        "pageCount": 58,
        "totalCount": 5725,
        "next": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/received?page=2&limit=100&transform=true",
        "previous": null,
        "self": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/received?page=1&limit=100&transform=true",
        "first": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/received?page=1&limit=100&transform=true",
        "last": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/transactions/received?page=58&limit=100&transform=true"
    },
    "data": [
        {
            "id": "14bfccd3275503361f473d6b0b43ec8e25cccfce865fb77d9eb8997a9fae2ded",
            "blockId": "e5d2093aa2a73ebb9132f900a6156268c12b387a655778e177dedd90aa79045e",
            "version": 2,
            "type": 0,
            "typeGroup": 1,
            "amount": "379692510469",
            "fee": "10000000",
            "sender": "AN3drxhwZa41zrrUWgaYKxDnKRaiZxmbek",
            "senderPublicKey": "0298a14ea5c2e2065f86e25d260b41c8208996d4ac255edff739f2aeae04036d4c",
            "recipient": "AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7",
            "signature": "c8259f027b9ce092a27e6e73aa6ce5f17a0d1a8bbd824000d684e2204b5c06d4fa8aae1602279af9fd070a53d7f36362f099ea0f5f32ef8e31617f27e9782862",
            "confirmations": 68871,
            "timestamp": {
                "epoch": 225310048,
                "unix": 1715411248,
                "human": "2024-05-11T07:07:28.000Z"
            },
            "nonce": "51"
        },
        {
            "id": "6d28db38014f413a4e69b870c7fa23a5f688a5f89692f7ac190b406314a63eac",
            "blockId": "a4cd7af7daa07f0b5fc3ff0ccaa3100e1e0361da92448cbf8e4c396e96a57e84",
            "version": 2,
            "type": 0,
            "typeGroup": 1,
            "amount": "393960000000",
            "fee": "10000000",
            "sender": "AQgrTPiFAvX7kLUhKhjnnT7G4FsuWZuruK",
            "senderPublicKey": "028f8c71695e945ef153fedec576799e55d7cc6cc0c20a6a7233dd0eb76cc8eaee",
            "recipient": "AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7",
            "signature": "679e5e932cc71ee19c6ab9c21cc0a58909a74c8b058d9f6b51d75b82d42bbf9e0c1b64b57f62b4ba4222f8559a7a85f471f6874445bfedcaca22538ad269456d",
            "confirmations": 68874,
            "timestamp": {
                "epoch": 225310024,
                "unix": 1715411224,
                "human": "2024-05-11T07:07:04.000Z"
            },
            "nonce": "3"
        },
...

List All Votes of a Wallet

Returns all votes made by the wallet. Often users create a new wallet instead of recasting their vote, as the former was historically cheaper. Equivalent to /transactions with parameter senderId and vote type set.

Method: GET

https://ark.nownodes.io/api/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/votes?page=1&limit=100

Example response: 200

{
    "meta": {
        "totalCountIsEstimate": true,
        "count": 0,
        "pageCount": 1,
        "totalCount": 4,
        "next": null,
        "previous": null,
        "self": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/votes?page=1&limit=100&transform=true",
        "first": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/votes?page=1&limit=100&transform=true",
        "last": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/votes?page=1&limit=100&transform=true"
    },
    "data": []
}

List All Lock Transactions of a Wallet

All lock transactions belonging to a wallet can be obtained using this API. Equivalent to /locks with parameter senderPublicKey.

Method: GET

https://ark.nownodes.io/api/wallets/{walletId}/locks?page=1&limit=100

Example response: 200

{
    "meta": {
        "totalCountIsEstimate": false,
        "count": 0,
        "pageCount": 1,
        "totalCount": 0,
        "next": null,
        "previous": null,
        "self": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/locks?page=1&limit=100",
        "first": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/locks?page=1&limit=100",
        "last": "/wallets/AZiS7KXBJ8o8JgdhPo2m4t8MGpGt1Ucxe7/locks?page=1&limit=100"
    },
    "data": []
}

Last updated