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.

Docs

Accounts

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

Get account

path Parameters
publicKey
required
string <byte>

Responses

Stream account

path Parameters
publicKey
required
string <byte>

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 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"
}

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

path Parameters
publicKey
required
string <byte>
query Parameters
minAmount
string
Default: "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 account entries by height

path Parameters
publicKey
required
string <byte>
query Parameters
fromHeight
string
Default: "1"
toHeight
string
Default: "18446744073709551615"

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

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
}

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
}

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"
}

Get transaction

path Parameters
hash
required
string

Responses

Response samples

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

Stream a single transaction

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 <byte>
query Parameters
fromHeight
string
Default: "1"
toHeight
string
Default: "18446744073709551615"

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
Whitepaper
Distribution
Reward for Contributions
Copyright © 2025 Atto B.V.
X.comRedidtLinkedinGithubDiscord