Algorand Algod REST API
★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey56 EndpointsREST
For Agents
Read on-chain state and submit transactions on the Algorand blockchain - accounts, applications (smart contracts), assets, blocks, ledger deltas, and TEAL execution.
Use for: I need to look up the balance of an Algorand address, Retrieve the assets held by a specific account, Get the latest block on the Algorand mainnet, Find the application state for a smart contract by ID
Not supported: Does not handle historical indexed queries, off-chain pricing, or wallet key management - use the Algorand Indexer, exchange APIs, or local wallet libraries for those. Use this API for direct node-level reads and transaction submission only.
Jentic publishes the only available OpenAPI specification for the Algod REST API, keeping it validated and agent-ready. The Algod API is the primary interface to an Algorand node, exposing 56 endpoints for reading account state, application and asset data, blocks, and ledger deltas, plus submitting transactions and running TEAL programs. It is the lowest-level on-chain interface for Algorand and is what wallets, dApps, and indexers call to interact with the network. Public infrastructure like AlgoNode hosts mainnet and testnet endpoints under the same spec.
Install Jentic One Beta
Connect the Algod REST API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Algod REST API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Algod REST API.
Look up account balances, assets, and applications via /v2/accounts/{address}
Inspect Algorand smart contracts (applications) including their boxes via /v2/applications/{application-id} and /v2/applications/{application-id}/boxes
Retrieve any block by round number along with its transactions and state proofs via /v2/blocks/{round}
Look up Algorand Standard Asset (ASA) metadata by asset ID via /v2/assets/{asset-id}
Submit signed transactions to the network and inspect pending transactions via /v2/transactions and /v2/accounts/{address}/transactions/pending
Compile and execute TEAL programs in dryrun mode for smart contract development
Read ledger state deltas to track exact state changes per round via /v2/deltas/{round}
Use Cases
Patterns agents use Algod REST API for, with concrete tasks.
★ Wallet balance and asset lookup
Query /v2/accounts/{address} to fetch ALGO balance, opted-in assets with quantities, and any applications the account participates in. The same endpoint returns minimum balance requirements and reward state, so wallets can show a complete portfolio view in a single call.
GET /v2/accounts/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA to fetch ALGO balance and asset list
Smart contract state and box reads
Inspect Algorand applications by calling /v2/applications/{application-id} for global state and /v2/applications/{application-id}/boxes plus /v2/applications/{application-id}/box for box storage. Useful for dApp dashboards that need to render live smart contract state without running an indexer.
GET /v2/applications/123456 and GET /v2/applications/123456/boxes to enumerate the contract's global state and box keys
Transaction submission and confirmation
After signing a transaction client-side, post the binary blob to the transactions endpoint and poll /v2/accounts/{address}/transactions/pending to track confirmation. Combined with /v2/blocks/{round} an agent can wait for a specific round and verify inclusion before reporting success.
POST the signed transaction blob to the transactions endpoint, then poll /v2/accounts/{sender}/transactions/pending until the txid disappears or appears confirmed in /v2/blocks/{round}
Agent-driven on-chain reads in chat assistants
An AI assistant connecting through Jentic can answer questions like 'what assets does this address hold' or 'is my transaction confirmed yet' by hitting the Algod API. Jentic resolves intents to AccountInformation or pending-transactions endpoints and injects the API token from the vault.
Search Jentic for 'look up Algorand account', load AccountInformation, and execute with the user's address
Key Endpoints
56 endpoints — jentic publishes the only available openapi specification for the algod rest api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/v2/accounts/{address}
Get account information including balance and assets
GET
/v2/accounts/{address}/assets
List assets held by an account
GET
/v2/applications/{application-id}
Get application (smart contract) state
GET
/v2/applications/{application-id}/boxes
List boxes for an application
GET
/v2/assets/{asset-id}
Get an Algorand Standard Asset by ID
GET
/v2/blocks/{round}
Get a block by round number
GET
/v2/accounts/{address}/transactions/pending
List pending transactions for an account
GET
/v2/accounts/{address}
Get account information including balance and assets
GET
/v2/accounts/{address}/assets
List assets held by an account
GET
/v2/applications/{application-id}
Get application (smart contract) state
GET
/v2/applications/{application-id}/boxes
List boxes for an application
GET
/v2/assets/{asset-id}
Get an Algorand Standard Asset by ID
GET
/v2/blocks/{round}
Get a block by round number
GET
/v2/accounts/{address}/transactions/pending
List pending transactions for an account
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
X-Algo-API-Token is stored encrypted in the Jentic vault. Agents receive scoped tokens at request time; the raw API token never enters agent context, so a leaked agent log cannot expose node access.
Intent-based discovery
Agents search Jentic by intent (e.g. 'look up Algorand account' or 'submit Algorand transaction') and Jentic returns the matching Algod operation with its input schema.
Time to first call
Direct integration: 1-2 days to wire account reads, transaction submission, and confirmation polling. Through Jentic: under 30 minutes - search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Algod REST API through Jentic.
Why is there no official OpenAPI spec for the Algod REST API?
Algorand publishes API documentation but does not host a packaged OpenAPI 3.0 specification suitable for agent tooling. Jentic generates and maintains this spec so that AI agents and developers can call the Algod REST API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Algorand Algod REST API use?
An API key passed in the X-Algo-API-Token header. Public providers like AlgoNode (mainnet-api.algonode.cloud) accept an empty token for anonymous read access; private nodes and paid providers issue per-account tokens. Through Jentic, the token is stored in the vault and injected at request time.
Can I submit transactions through this API?
Yes. After signing a transaction client-side with an Algorand SDK, submit the binary blob to the transactions endpoint. Use /v2/accounts/{address}/transactions/pending to track confirmation, and /v2/blocks/{round} to verify inclusion in a specific round.
What are the rate limits for the Algod REST API?
Limits depend on the node operator. AlgoNode publishes free-tier limits per IP and offers higher tiers via subscription. Private nodes have no shared limits. Plan for 429 responses and back off using the Retry-After header where present.
How do I query an Algorand account through Jentic?
Search Jentic for 'look up Algorand account', load AccountInformation, and execute with the address. Jentic injects X-Algo-API-Token from the vault and calls /v2/accounts/{address} - no manual auth wiring needed.
Does the Algod API include indexer-style queries?
No. Algod serves current and recent state directly from a node; for historical queries (transactions older than the node's catchup window, or filtered by sender, asset, etc.) use the separate Algorand Indexer API.
GET STARTED