Skip to main content
API docs by Redocly

Atto Node API (1.30-live)

Download OpenAPI specification:Download

Atto is a high-performance cryptocurrency focused on instant, feeless, and scalable digital cash; this interface is the entry point to the network, allowing clients to publish and receive blocks, query account data, and participate in the network.

Integration Docs

Vote Weights

Expose current vote weights per representative

Get voter weight

path Parameters
address
required
string^atto://[a-z2-7]{61}$
Example: atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw

Atto address URI. Format: atto:// + 61 Base32 chars (lowercase, no padding). Encodes: 1 byte algorithm code + 32-byte public key + 5-byte checksum (total 38 bytes).

Responses

Accounts

Retrieve the latest state (snapshot) of an account. Since transactions mutate accounts, this reflects the result of all previous operations.

Get accounts for given addresses

Request Body schema: application/json
required
addresses
required
Array of strings (AttoAddress) [ items^atto://[a-z2-7]{61}$ ]

List of addresses. Example item shown.

Responses

Request samples

Content type
application/json
{
  • "addresses": [
    ]
}

Stream all latest accounts

Responses

Response samples

Content type
application/x-ndjson
{
  • "publicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "network": "LIVE",
  • "version": 0,
  • "algorithm": "V1",
  • "height": "1",
  • "balance": "1000000000000000000",
  • "lastTransactionHash": "9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C",
  • "lastTransactionTimestamp": 1767390950976,
  • "representativeAlgorithm": "V1",
  • "representativePublicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "representativeAddress": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Stream all accounts for the given addresses

Request Body schema: application/json
required
addresses
required
Array of strings (AttoAddress) [ items^atto://[a-z2-7]{61}$ ]

List of addresses. Example item shown.

Responses

Request samples

Content type
application/json
{
  • "addresses": [
    ]
}

Response samples

Content type
application/x-ndjson
{
  • "publicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "network": "LIVE",
  • "version": 0,
  • "algorithm": "V1",
  • "height": "1",
  • "balance": "1000000000000000000",
  • "lastTransactionHash": "9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C",
  • "lastTransactionTimestamp": 1767390950976,
  • "representativeAlgorithm": "V1",
  • "representativePublicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "representativeAddress": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Get account

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281

32-byte ed25519 public key (hex)

Responses

Stream account

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281

32-byte ed25519 public key (hex)

Responses

Response samples

Content type
application/x-ndjson
{
  • "publicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "network": "LIVE",
  • "version": 0,
  • "algorithm": "V1",
  • "height": "1",
  • "balance": "1000000000000000000",
  • "lastTransactionHash": "9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C",
  • "lastTransactionTimestamp": 1767390950976,
  • "representativeAlgorithm": "V1",
  • "representativePublicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "representativeAddress": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Instants

Returns the time difference between the server and client. Useful for clients with unreliable or skewed clocks.

Return time adjustment to send transactions

path Parameters
clientInstant
required
string <date-time>

Responses

Receivables

Displays pending incoming funds. When someone sends a transaction, it becomes a "receivable" until the recipient explicitly receives it.

Stream all receivables for multiple addresses

query Parameters
minAmount
string^[0-9]{1,20}$
Example: minAmount=1000000000000000000

Unsigned 64-bit amount in raw units (0..18000000000000000000U)

Request Body schema: application/json
required
addresses
required
Array of strings (AttoAddress) [ items^atto://[a-z2-7]{61}$ ]

List of addresses. Example item shown.

Responses

Request samples

Content type
application/json
{
  • "addresses": [
    ]
}

Response samples

Content type
application/x-ndjson
{
  • "network": "LIVE",
  • "hash": "9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C",
  • "version": 0,
  • "algorithm": "V1",
  • "publicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "timestamp": 1767390950976,
  • "receiverAlgorithm": "V1",
  • "receiverPublicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "amount": "1000000000000000000",
  • "receiverAddress": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Stream all receivables

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281

32-byte ed25519 public key (hex)

query Parameters
minAmount
string^[0-9]{1,20}$
Example: minAmount=1000000000000000000

Unsigned 64-bit amount in raw units (0..18000000000000000000U)

Responses

Response samples

Content type
application/x-ndjson
{
  • "network": "LIVE",
  • "hash": "9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C",
  • "version": 0,
  • "algorithm": "V1",
  • "publicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "timestamp": 1767390950976,
  • "receiverAlgorithm": "V1",
  • "receiverPublicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "amount": "1000000000000000000",
  • "receiverAddress": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Account Entries

A user-friendly view of account activity. Recommended for displaying transaction history in UIs.

Stream all latest account entries

Responses

Response samples

Content type
application/x-ndjson
{
  • "hash": "9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C",
  • "algorithm": "V1",
  • "publicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "height": "1",
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "previousBalance": "1000000000000000000",
  • "balance": "1000000000000000000",
  • "timestamp": 1767390950976,
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw",
  • "subjectAddress": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Stream account entries by height range

Request Body schema: application/json
required
required
Array of objects (AccountHeightSearch)

List of account heights to be searched

Array
address
required
string (AttoAddress) ^atto://[a-z2-7]{61}$

Address of the account

fromHeight
required
string (AttoHeight) ^[0-9]{1,20}$

From height (inclusive), normally last seen height + 1

toHeight
required
string (AttoHeight) ^[0-9]{1,20}$

To height (inclusive)

Responses

Request samples

Content type
application/json
{
  • "search": [
    ]
}

Response samples

Content type
application/x-ndjson
{
  • "hash": "9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C",
  • "algorithm": "V1",
  • "publicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "height": "1",
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "previousBalance": "1000000000000000000",
  • "balance": "1000000000000000000",
  • "timestamp": 1767390950976,
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw",
  • "subjectAddress": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Stream account entries by height

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281

32-byte ed25519 public key (hex)

query Parameters
fromHeight
string^[0-9]{1,20}$
Example: fromHeight=1

Block height as unsigned 64-bit integer (1..18446744073709551615)

toHeight
string^[0-9]{1,20}$
Example: toHeight=1

Block height as unsigned 64-bit integer (1..18446744073709551615)

Responses

Response samples

Content type
application/x-ndjson
{
  • "hash": "9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C",
  • "algorithm": "V1",
  • "publicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "height": "1",
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "previousBalance": "1000000000000000000",
  • "balance": "1000000000000000000",
  • "timestamp": 1767390950976,
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw",
  • "subjectAddress": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Stream a single account entry

Allows clients to track the confirmation of a transaction in real-time by streaming a single account entry by hash. Useful when the transaction hash is shared ahead of time, like in payment protocols.

path Parameters
hash
required
string <hex> = 64 characters
Example: 9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C

32-byte hash (hex)

Responses

Response samples

Content type
application/x-ndjson
{
  • "hash": "9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C",
  • "algorithm": "V1",
  • "publicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "height": "1",
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281",
  • "previousBalance": "1000000000000000000",
  • "balance": "1000000000000000000",
  • "timestamp": 1767390950976,
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw",
  • "subjectAddress": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Transactions

Submit or query raw transaction blocks. This endpoint handles the low-level building blocks of the ledger.

Stream all latest transactions

Responses

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "5799544ACF409689705225CBF72FBFA9CD06EEA5F49E043C5C71B2EE6365977EDD3BDD2A3003D247EE39D0CA3E72E8F41DFD49C2ACDE217990A0ABE26F7E025F",
  • "work": "8E9C4A839AB702AF",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

publishAndStream

Publish transaction and stream

Request Body schema: application/json
required
required
AttoChangeBlock (object) or AttoOpenBlock (object) or AttoReceiveBlock (object) or AttoSendBlock (object)
signature
required
string <hex> (AttoSignature) = 128 characters

64-byte ed25519 signature (hex)

work
required
string <hex> (AttoWork) = 16 characters

Work nonce (hex)

address
required
string (AttoAddress) ^atto://[a-z2-7]{61}$

Atto address URI. Format: atto:// + 61 Base32 chars (lowercase, no padding). Encodes: 1 byte algorithm code + 32-byte public key + 5-byte checksum (total 38 bytes).

Responses

Request samples

Content type
application/json
{
  • "block": {
    },
  • "signature": "5799544ACF409689705225CBF72FBFA9CD06EEA5F49E043C5C71B2EE6365977EDD3BDD2A3003D247EE39D0CA3E72E8F41DFD49C2ACDE217990A0ABE26F7E025F",
  • "work": "8E9C4A839AB702AF",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "5799544ACF409689705225CBF72FBFA9CD06EEA5F49E043C5C71B2EE6365977EDD3BDD2A3003D247EE39D0CA3E72E8F41DFD49C2ACDE217990A0ABE26F7E025F",
  • "work": "8E9C4A839AB702AF",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Publish a transaction

Request Body schema: application/json
required
required
AttoChangeBlock (object) or AttoOpenBlock (object) or AttoReceiveBlock (object) or AttoSendBlock (object)
signature
required
string <hex> (AttoSignature) = 128 characters

64-byte ed25519 signature (hex)

work
required
string <hex> (AttoWork) = 16 characters

Work nonce (hex)

address
required
string (AttoAddress) ^atto://[a-z2-7]{61}$

Atto address URI. Format: atto:// + 61 Base32 chars (lowercase, no padding). Encodes: 1 byte algorithm code + 32-byte public key + 5-byte checksum (total 38 bytes).

Responses

Request samples

Content type
application/json
{
  • "block": {
    },
  • "signature": "5799544ACF409689705225CBF72FBFA9CD06EEA5F49E043C5C71B2EE6365977EDD3BDD2A3003D247EE39D0CA3E72E8F41DFD49C2ACDE217990A0ABE26F7E025F",
  • "work": "8E9C4A839AB702AF",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Stream transactions by account and height range

Request Body schema: application/json
required
required
Array of objects (AccountHeightSearch)

List of account heights to be searched

Array
address
required
string (AttoAddress) ^atto://[a-z2-7]{61}$

Address of the account

fromHeight
required
string (AttoHeight) ^[0-9]{1,20}$

From height (inclusive), normally last seen height + 1

toHeight
required
string (AttoHeight) ^[0-9]{1,20}$

To height (inclusive)

Responses

Request samples

Content type
application/json
{
  • "search": [
    ]
}

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "5799544ACF409689705225CBF72FBFA9CD06EEA5F49E043C5C71B2EE6365977EDD3BDD2A3003D247EE39D0CA3E72E8F41DFD49C2ACDE217990A0ABE26F7E025F",
  • "work": "8E9C4A839AB702AF",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Get transaction

path Parameters
hash
required
string <hex> = 64 characters
Example: 9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C

32-byte hash (hex)

Responses

Stream a single transaction

Allows clients to track the confirmation of a transaction in real-time by streaming a single transaction by hash. Useful when the transaction hash is shared ahead of time, like in payment protocols.

path Parameters
hash
required
string <hex> = 64 characters
Example: 9072A5DB95CF7866F9AF4CC4C12C01F8E1DF903A6A0660EF62986A4B6191BD0C

32-byte hash (hex)

Responses

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "5799544ACF409689705225CBF72FBFA9CD06EEA5F49E043C5C71B2EE6365977EDD3BDD2A3003D247EE39D0CA3E72E8F41DFD49C2ACDE217990A0ABE26F7E025F",
  • "work": "8E9C4A839AB702AF",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}

Stream transactions by height

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 44C8865188D6FBE1C084436FF2E08D34538BA0FB2FCB1A8FA76F8127CCF6A281

32-byte ed25519 public key (hex)

query Parameters
fromHeight
string^[0-9]{1,20}$
Example: fromHeight=1

Block height as unsigned 64-bit integer (1..18446744073709551615)

toHeight
string^[0-9]{1,20}$
Example: toHeight=1

Block height as unsigned 64-bit integer (1..18446744073709551615)

Responses

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "5799544ACF409689705225CBF72FBFA9CD06EEA5F49E043C5C71B2EE6365977EDD3BDD2A3003D247EE39D0CA3E72E8F41DFD49C2ACDE217990A0ABE26F7E025F",
  • "work": "8E9C4A839AB702AF",
  • "address": "atto://aaferyy3quqiyugpambc452bu2oqh7hrcazz4vnvem2meaa6thwf4vkiuiwyw"
}
Footer background
Ready to Experience Atto?Enjoy instant, feeless, and eco-friendly transactions with just a tap.
Access the WalletApp Store
Useful Links
Faucet
Mining
Explorer
Whitepaper
Distribution
Reward for Contributions
Copyright © 2026 Atto B.V.
X.comRedditLinkedinGithubDiscord