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.
Retrieve the latest state (snapshot) of an account. Since transactions mutate accounts, this reflects the result of all previous operations.
addresses required | Array of strings (AttoAddress) [ items^atto://[a-z2-7]{61}$ ] List of addresses. Example item shown. |
{- "addresses": [
- "atto://adwmbykpqs3mgbqogizzwm6arokkcmuxium7rbh343drwd2q5om6vj3jrfiyk"
]
}
{- "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"
}
addresses required | Array of strings (AttoAddress) [ items^atto://[a-z2-7]{61}$ ] List of addresses. Example item shown. |
{- "addresses": [
- "atto://adwmbykpqs3mgbqogizzwm6arokkcmuxium7rbh343drwd2q5om6vj3jrfiyk"
]
}
{- "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"
}
publicKey required | string <hex> = 64 characters Example: 2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D 32-byte ed25519 public key (hex) |
{- "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"
}
Returns the time difference between the server and client. Useful for clients with unreliable or skewed clocks.
Displays pending incoming funds. When someone sends a transaction, it becomes a "receivable" until the recipient explicitly receives it.
minAmount | string^[0-9]{1,20}$ Example: minAmount=1000000000000000000 Unsigned 64-bit amount in raw units (0..18000000000000000000U) |
addresses required | Array of strings (AttoAddress) [ items^atto://[a-z2-7]{61}$ ] List of addresses. Example item shown. |
{- "addresses": [
- "atto://adwmbykpqs3mgbqogizzwm6arokkcmuxium7rbh343drwd2q5om6vj3jrfiyk"
]
}
{- "hash": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
- "version": 0,
- "algorithm": "V1",
- "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "timestamp": 1759773505380,
- "receiverAlgorithm": "V1",
- "receiverPublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "amount": "1000000000000000000",
- "receiverAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}
publicKey required | string <hex> = 64 characters Example: 2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D 32-byte ed25519 public key (hex) |
minAmount | string^[0-9]{1,20}$ Example: minAmount=1000000000000000000 Unsigned 64-bit amount in raw units (0..18000000000000000000U) |
{- "hash": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
- "version": 0,
- "algorithm": "V1",
- "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "timestamp": 1759773505380,
- "receiverAlgorithm": "V1",
- "receiverPublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "amount": "1000000000000000000",
- "receiverAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}
A user-friendly view of account activity. Recommended for displaying transaction history in UIs.
{- "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"
}
required | Array of objects (AccountHeightSearch) List of account heights to be searched | ||||||
Array
|
{- "search": [
- {
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "fromHeight": "1",
- "toHeight": "1"
}
]
}
{- "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"
}
publicKey required | string <hex> = 64 characters Example: 2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D 32-byte ed25519 public key (hex) |
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) |
{- "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"
}
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.
hash required | string <hex> = 64 characters Example: 3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B 32-byte hash (hex) |
{- "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"
}
Submit or query raw transaction blocks. This endpoint handles the low-level building blocks of the ledger.
{- "block": {
- "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "version": 0,
- "height": "1",
- "balance": "1000000000000000000",
- "algorithm": "V1",
- "timestamp": 1759773505380,
- "network": "LIVE",
- "type": "UNKNOWN",
- "previous": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
- "representativeAlgorithm": "V1",
- "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}, - "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
- "work": "5C596481536696AA"
}
Publish transaction and stream
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) |
{- "block": {
- "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "version": 0,
- "height": "1",
- "balance": "1000000000000000000",
- "algorithm": "V1",
- "timestamp": 1759773505380,
- "network": "LIVE",
- "type": "UNKNOWN",
- "previous": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
- "representativeAlgorithm": "V1",
- "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}, - "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
- "work": "5C596481536696AA"
}
{- "block": {
- "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "version": 0,
- "height": "1",
- "balance": "1000000000000000000",
- "algorithm": "V1",
- "timestamp": 1759773505380,
- "network": "LIVE",
- "type": "UNKNOWN",
- "previous": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
- "representativeAlgorithm": "V1",
- "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}, - "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
- "work": "5C596481536696AA"
}
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) |
{- "block": {
- "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "version": 0,
- "height": "1",
- "balance": "1000000000000000000",
- "algorithm": "V1",
- "timestamp": 1759773505380,
- "network": "LIVE",
- "type": "UNKNOWN",
- "previous": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
- "representativeAlgorithm": "V1",
- "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}, - "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
- "work": "5C596481536696AA"
}
required | Array of objects (AccountHeightSearch) List of account heights to be searched | ||||||
Array
|
{- "search": [
- {
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "fromHeight": "1",
- "toHeight": "1"
}
]
}
{- "block": {
- "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "version": 0,
- "height": "1",
- "balance": "1000000000000000000",
- "algorithm": "V1",
- "timestamp": 1759773505380,
- "network": "LIVE",
- "type": "UNKNOWN",
- "previous": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
- "representativeAlgorithm": "V1",
- "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}, - "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
- "work": "5C596481536696AA"
}
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.
hash required | string <hex> = 64 characters Example: 3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B 32-byte hash (hex) |
{- "block": {
- "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "version": 0,
- "height": "1",
- "balance": "1000000000000000000",
- "algorithm": "V1",
- "timestamp": 1759773505380,
- "network": "LIVE",
- "type": "UNKNOWN",
- "previous": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
- "representativeAlgorithm": "V1",
- "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}, - "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
- "work": "5C596481536696AA"
}
publicKey required | string <hex> = 64 characters Example: 2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D 32-byte ed25519 public key (hex) |
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) |
{- "block": {
- "publicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "version": 0,
- "height": "1",
- "balance": "1000000000000000000",
- "algorithm": "V1",
- "timestamp": 1759773505380,
- "network": "LIVE",
- "type": "UNKNOWN",
- "previous": "3B17F776F269F60799F7D2F39C6512103FC61174C2DFF1D953701988269A905B",
- "representativeAlgorithm": "V1",
- "representativePublicKey": "2DC2C245FE2304C41CBA5C6B8C8338D96B2A1592014E8D79E9DD941237418F6D",
- "address": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm",
- "representativeAddress": "atto://aakcn4bk6juowvvpkfqjhb3fg4dasiotgir4ferstujpqj6ywp6hd6wtxdcrm"
}, - "signature": "D93D94EED721DA942B65B778D65DB513DDFE920B69D85903885155E5CC44CCA7F80D2ECFE38C1CBB44A1A5DE04D5727187FC5029420DE32D9FE6579A8D357CD1",
- "work": "5C596481536696AA"
}