Skip to main content

Atto Node API (v1.0.0)

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.

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": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "network": "LIVE",
  • "version": 0,
  • "algorithm": "V1",
  • "height": "1",
  • "balance": "1000000000000000000",
  • "lastTransactionHash": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
  • "lastTransactionTimestamp": 1759773505380,
  • "representativeAlgorithm": "V1",
  • "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
  • "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}

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": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "network": "LIVE",
  • "version": 0,
  • "algorithm": "V1",
  • "height": "1",
  • "balance": "1000000000000000000",
  • "lastTransactionHash": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
  • "lastTransactionTimestamp": 1759773505380,
  • "representativeAlgorithm": "V1",
  • "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
  • "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}

Get account

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D

32-byte ed25519 public key (hex)

Responses

Stream account

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D

32-byte ed25519 public key (hex)

Responses

Response samples

Content type
application/x-ndjson
{
  • "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "network": "LIVE",
  • "version": 0,
  • "algorithm": "V1",
  • "height": "1",
  • "balance": "1000000000000000000",
  • "lastTransactionHash": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
  • "lastTransactionTimestamp": 1759773505380,
  • "representativeAlgorithm": "V1",
  • "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
  • "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}

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
{
  • "hash": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
  • "version": 0,
  • "algorithm": "V1",
  • "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "timestamp": 1759773505380,
  • "receiverAlgorithm": "V1",
  • "receiverPublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "amount": "1000000000000000000",
  • "receiverAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
  • "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}

Stream all receivables

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D

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
{
  • "hash": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
  • "version": 0,
  • "algorithm": "V1",
  • "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "timestamp": 1759773505380,
  • "receiverAlgorithm": "V1",
  • "receiverPublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "amount": "1000000000000000000",
  • "receiverAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
  • "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}

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": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
  • "algorithm": "V1",
  • "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "height": "1",
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "previousBalance": "1000000000000000000",
  • "balance": "1000000000000000000",
  • "timestamp": 1759773505380,
  • "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
  • "subjectAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}

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": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
  • "algorithm": "V1",
  • "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "height": "1",
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "previousBalance": "1000000000000000000",
  • "balance": "1000000000000000000",
  • "timestamp": 1759773505380,
  • "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
  • "subjectAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}

Stream account entries by height

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D

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": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
  • "algorithm": "V1",
  • "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "height": "1",
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "previousBalance": "1000000000000000000",
  • "balance": "1000000000000000000",
  • "timestamp": 1759773505380,
  • "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
  • "subjectAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}

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: 3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B

32-byte hash (hex)

Responses

Response samples

Content type
application/x-ndjson
{
  • "hash": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
  • "algorithm": "V1",
  • "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "height": "1",
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
  • "previousBalance": "1000000000000000000",
  • "balance": "1000000000000000000",
  • "timestamp": 1759773505380,
  • "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
  • "subjectAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}

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": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
  • "work": "5C596481536696AA"
}

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)

Responses

Request samples

Content type
application/json
{
  • "block": {
    },
  • "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
  • "work": "5C596481536696AA"
}

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
  • "work": "5C596481536696AA"
}

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)

Responses

Request samples

Content type
application/json
{
  • "block": {
    },
  • "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
  • "work": "5C596481536696AA"
}

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": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
  • "work": "5C596481536696AA"
}

Get transaction

path Parameters
hash
required
string <hex> = 64 characters
Example: 3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B

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: 3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B

32-byte hash (hex)

Responses

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
  • "work": "5C596481536696AA"
}

Stream transactions by height

path Parameters
publicKey
required
string <hex> = 64 characters
Example: 2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D

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": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
  • "work": "5C596481536696AA"
}
Footer background
Ready to Experience Atto?Enjoy instant, feeless, and eco-friendly transactions with just a tap.
Copyright © 2025 Atto B.V.
X.comRedditLinkedinGithubDiscord