Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

• Auto
• Light
• Dark

Algorand Specifications

The main daemon running in an Algorand Node is called algod.

It is responsible for providing access to core blockchain data and functionality. This includes transaction details, account balances, smart contract state, and other node-level information.

The algod REST API is used to GET:

• Node info (e.g., /genesis, /health, /ready, /status, etc.),
• Account info (e.g., /accounts/{address}, etc.),
• App info (e.g., /applications/{application-id}, etc.),
• ASA info (e.g., /assets/{asset-id}, etc.),
• Blocks info (e.g., /blocks/{round}, etc.),
• Other ancillary information about the Ledger and pending transactions in the Transaction Pool.

The algod REST API is used to POST:

• Synchronization commands (e.g., /ledger/sync/{round}, /catchup/{catchpoint}, etc.),
• Transactions (e.g., /transactions, /transactions/simulate, etc.),
• Consensus commands (e.g., /participation, /participation/generate/{address}, etc.),
• AVM Compiler commands (e.g., /teal/compile, /teal/disassemble, etc.),
• Other ancillary dev commands.

Tasks involving the management and the usage of private keys are handled by a separate daemon, called Key Management Daemon (kmd).

Some algod endpoints perform sensitive actions that require authorization.

The X-Algo-API-Token header is used to authenticate requests to the private algod endpoints.

By default, the API can be configured with two separate X-Algo-API-Token values:

• The algod.token is used to access public algod endpoints.
• The admin.algod.token is used to access private algod endpoints.

Each algod endpoint path has two tags to separate endpoints into groups:

• Tag 1: public (use the algod.token) or private (use algod.admin.token),
• Tag 2: participating, nonparticipating, data, or experimental.

Important

IMPLEMENTATION:

Each endpoint implements a Handler and a Client.

The following constants define key limits and default behaviors for various algod API endpoints.

These values serve as practical defaults for most use cases. Developers implementing their own tooling or integrations can use these as general guidelines.