Skip to main content
API docs by Redocly

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.

Integration Docs

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 any

Responses

Request samples

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

Stream all latest accounts

Responses

Response samples

Content type
application/x-ndjson
{
  • "publicKey": "45B3B58C26181580EEAFC1791046D54EEC2854BF550A211E2362761077D6590C",
  • "network": "LIVE",
  • "version": 0,
  • "algorithm": "V1",
  • "height": 1,
  • "balance": 180000000000,
  • "lastTransactionHash": "70F9406609BCB2E3E18F22BD0839C95E5540E95489DC6F24DBF6A1F7CFD83A92",
  • "lastTransactionTimestamp": 1705517157478,
  • "representativeAlgorithm": "V1",
  • "representativePublicKey": "99E439410A4DDD2A3A8D0B667C7A090286B8553378CF3C7AA806C3E60B6C4CBE"
}

Stream all accounts for the given addresses

query Parameters
required
object (AccountSearch)

List of addresses

Responses

Response samples

Content type
application/x-ndjson
{
  • "publicKey": "45B3B58C26181580EEAFC1791046D54EEC2854BF550A211E2362761077D6590C",
  • "network": "LIVE",
  • "version": 0,
  • "algorithm": "V1",
  • "height": 1,
  • "balance": 180000000000,
  • "lastTransactionHash": "70F9406609BCB2E3E18F22BD0839C95E5540E95489DC6F24DBF6A1F7CFD83A92",
  • "lastTransactionTimestamp": 1705517157478,
  • "representativeAlgorithm": "V1",
  • "representativePublicKey": "99E439410A4DDD2A3A8D0B667C7A090286B8553378CF3C7AA806C3E60B6C4CBE"
}

Get account

path Parameters
publicKey
required
string

Responses

Stream account

path Parameters
publicKey
required
string

Responses

Response samples

Content type
application/x-ndjson
{
  • "publicKey": "45B3B58C26181580EEAFC1791046D54EEC2854BF550A211E2362761077D6590C",
  • "network": "LIVE",
  • "version": 0,
  • "algorithm": "V1",
  • "height": 1,
  • "balance": 180000000000,
  • "lastTransactionHash": "70F9406609BCB2E3E18F22BD0839C95E5540E95489DC6F24DBF6A1F7CFD83A92",
  • "lastTransactionTimestamp": 1705517157478,
  • "representativeAlgorithm": "V1",
  • "representativePublicKey": "99E439410A4DDD2A3A8D0B667C7A090286B8553378CF3C7AA806C3E60B6C4CBE"
}

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
integer
Default: "raw=1"
Request Body schema: application/json
required
addresses
required
Array of any

Responses

Request samples

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

Response samples

Content type
application/x-ndjson
{
  • "hash": "0AF0F63BFE4DBC588F95FC3B154DE848AA9A5DD5604BAC99AE9E21C5EA8B4F64",
  • "version": 0,
  • "algorithm": "V1",
  • "publicKey": "53F1A85D25EDA5021C01A77A2B1BA99CEF9DD5FD912D7465B8B652FDEDB6A4F8",
  • "timestamp": {
    },
  • "receiverAlgorithm": "V1",
  • "receiverPublicKey": "0C400961629D759176F009249A33899440900ABCE275F6C5C01C6F7F37A2C59A",
  • "amount": 18000000000000000000
}

Stream all receivables

path Parameters
publicKey
required
string
query Parameters
minAmount
integer
Default: "raw=1"

Responses

Response samples

Content type
application/x-ndjson
{
  • "hash": "0AF0F63BFE4DBC588F95FC3B154DE848AA9A5DD5604BAC99AE9E21C5EA8B4F64",
  • "version": 0,
  • "algorithm": "V1",
  • "publicKey": "53F1A85D25EDA5021C01A77A2B1BA99CEF9DD5FD912D7465B8B652FDEDB6A4F8",
  • "timestamp": {
    },
  • "receiverAlgorithm": "V1",
  • "receiverPublicKey": "0C400961629D759176F009249A33899440900ABCE275F6C5C01C6F7F37A2C59A",
  • "amount": 18000000000000000000
}

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": "68BA42CDD87328380BE32D5AA6DBB86E905B50273D37AF1DE12F47B83A001154",
  • "algorithm": "V1",
  • "publicKey": "FD595851104FDDB2FEBF3739C8006C8AAE9B8A2B1BC390D5FDF07EBDD8583FA1",
  • "height": 0,
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "2EB21717813E7A0E0A7E308B8E2FD8A051F8724F5C5F0047E92E19310C582E3A",
  • "previousBalance": 0,
  • "balance": 100,
  • "timestamp": 1704616009211
}

Stream account entries by height range

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

Address of the account

fromHeight
required
integer <int64>

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

toHeight
required
integer <int64>

To height (inclusive)

Responses

Request samples

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

Response samples

Content type
application/x-ndjson
{
  • "hash": "68BA42CDD87328380BE32D5AA6DBB86E905B50273D37AF1DE12F47B83A001154",
  • "algorithm": "V1",
  • "publicKey": "FD595851104FDDB2FEBF3739C8006C8AAE9B8A2B1BC390D5FDF07EBDD8583FA1",
  • "height": 0,
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "2EB21717813E7A0E0A7E308B8E2FD8A051F8724F5C5F0047E92E19310C582E3A",
  • "previousBalance": 0,
  • "balance": 100,
  • "timestamp": 1704616009211
}

Stream account entries by height

path Parameters
publicKey
required
string
query Parameters
fromHeight
integer <int64>
Default: 1
toHeight
integer

Responses

Response samples

Content type
application/x-ndjson
{
  • "hash": "68BA42CDD87328380BE32D5AA6DBB86E905B50273D37AF1DE12F47B83A001154",
  • "algorithm": "V1",
  • "publicKey": "FD595851104FDDB2FEBF3739C8006C8AAE9B8A2B1BC390D5FDF07EBDD8583FA1",
  • "height": 0,
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "2EB21717813E7A0E0A7E308B8E2FD8A051F8724F5C5F0047E92E19310C582E3A",
  • "previousBalance": 0,
  • "balance": 100,
  • "timestamp": 1704616009211
}

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

Responses

Response samples

Content type
application/x-ndjson
{
  • "hash": "68BA42CDD87328380BE32D5AA6DBB86E905B50273D37AF1DE12F47B83A001154",
  • "algorithm": "V1",
  • "publicKey": "FD595851104FDDB2FEBF3739C8006C8AAE9B8A2B1BC390D5FDF07EBDD8583FA1",
  • "height": 0,
  • "blockType": "RECEIVE",
  • "subjectAlgorithm": "V1",
  • "subjectPublicKey": "2EB21717813E7A0E0A7E308B8E2FD8A051F8724F5C5F0047E92E19310C582E3A",
  • "previousBalance": 0,
  • "balance": 100,
  • "timestamp": 1704616009211
}

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": "52843B36ABDFA4125E4C0D465A3C976C269F993C7C82645B29AB49B7A5A84FC41E3391D2A41C4CB83DFA3214DA87B099F86EF10402BFB1120A5D34F70CBC2B00",
  • "work": "4300FFFFFFFFFFCF"
}

publishAndStream

Publish transaction and stream

Request Body schema: application/json
required
required
AttoChangeBlock (object) or AttoOpenBlock (object) or AttoReceiveBlock (object) or AttoSendBlock (object)

The block to be submitted (SEND, RECEIVE, OPEN, CHANGE)

signature
required
string

Ed25519 signature of the block

work
required
string

Proof-of-work for the block

Responses

Request samples

Content type
application/json
{
  • "block": {
    },
  • "signature": "52843B36ABDFA4125E4C0D465A3C976C269F993C7C82645B29AB49B7A5A84FC41E3391D2A41C4CB83DFA3214DA87B099F86EF10402BFB1120A5D34F70CBC2B00",
  • "work": "4300FFFFFFFFFFCF"
}

Response samples

Content type
application/x-ndjson
[
  • {
    }
]

Publish a transaction

Request Body schema: application/json
required
required
AttoChangeBlock (object) or AttoOpenBlock (object) or AttoReceiveBlock (object) or AttoSendBlock (object)

The block to be submitted (SEND, RECEIVE, OPEN, CHANGE)

signature
required
string

Ed25519 signature of the block

work
required
string

Proof-of-work for the block

Responses

Request samples

Content type
application/json
{
  • "block": {
    },
  • "signature": "52843B36ABDFA4125E4C0D465A3C976C269F993C7C82645B29AB49B7A5A84FC41E3391D2A41C4CB83DFA3214DA87B099F86EF10402BFB1120A5D34F70CBC2B00",
  • "work": "4300FFFFFFFFFFCF"
}

Stream transactions by account and height range

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

Address of the account

fromHeight
required
integer <int64>

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

toHeight
required
integer <int64>

To height (inclusive)

Responses

Request samples

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

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "52843B36ABDFA4125E4C0D465A3C976C269F993C7C82645B29AB49B7A5A84FC41E3391D2A41C4CB83DFA3214DA87B099F86EF10402BFB1120A5D34F70CBC2B00",
  • "work": "4300FFFFFFFFFFCF"
}

Get transaction

path Parameters
hash
required
string

Responses

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "52843B36ABDFA4125E4C0D465A3C976C269F993C7C82645B29AB49B7A5A84FC41E3391D2A41C4CB83DFA3214DA87B099F86EF10402BFB1120A5D34F70CBC2B00",
  • "work": "4300FFFFFFFFFFCF"
}

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

Responses

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "52843B36ABDFA4125E4C0D465A3C976C269F993C7C82645B29AB49B7A5A84FC41E3391D2A41C4CB83DFA3214DA87B099F86EF10402BFB1120A5D34F70CBC2B00",
  • "work": "4300FFFFFFFFFFCF"
}

Stream transactions by height

path Parameters
publicKey
required
string
query Parameters
fromHeight
integer <int64>
Default: 1
toHeight
integer

Responses

Response samples

Content type
application/x-ndjson
{
  • "block": {
    },
  • "signature": "52843B36ABDFA4125E4C0D465A3C976C269F993C7C82645B29AB49B7A5A84FC41E3391D2A41C4CB83DFA3214DA87B099F86EF10402BFB1120A5D34F70CBC2B00",
  • "work": "4300FFFFFFFFFFCF"
}
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 © 2025 Atto B.V.
X.comRedditLinkedinGithubDiscord