How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Algorand public API

The public API from Algorand — 43 operation(s) for public.

Algorand public API is one of 15 APIs that Algorand publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Public. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 44 operations across 43 paths, and defines 56 schemas. It is described by OpenAPI 3.2.0, at version 0.0.1.

Requests are made against 2 base URLs: http://localhost/, https://localhost/.

44 operations 43 paths 56 schemas 1 DELETE35 GET8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.0.1
Base URL
https://mainnet-api.4160.nodely.dev
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

Algorand public API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Algo-API-Token (api_key). By default, every request must be authenticated.

  • api_key — Generated header parameter. This token can be generated using the Goal command line tool. Example value ='b7e384d0317b8050ce45900a94a1931e28540e1f69b2d242b4246…

Paths & Operations 44

Across 43 paths, the API surfaces 44 operations — 1 DELETE, 35 GET, 8 POST. Each is listed below with its method, path, parameters, and response codes.

public 44
GET
/genesis
Gets the genesis information.
GetGenesis → 200default
GET
/health
Returns OK if healthy.
HealthCheck → 200default
GET
/metrics
Return metrics about algod functioning.
Metrics → 200404
GET
/ready
Returns OK if healthy and fully caught up.
GetReady → 200500503default
GET
/swagger.json
Gets the current swagger spec.
SwaggerJSON → 200default
GET
/v2/accounts/{address}
Get account information.
AccountInformation 3 params → 200400401500default
GET
/v2/accounts/{address}/applications
Get a list of applications held by an account.
AccountApplicationsInformation 4 params → 200400401500default
GET
/v2/accounts/{address}/applications/{application-id}
Get account information about a given app.
AccountApplicationInformation 3 params → 200400401500default
GET
/v2/accounts/{address}/assets
Get a list of assets held by an account, inclusive of asset params.
AccountAssetsInformation 3 params → 200400401500default
GET
/v2/accounts/{address}/assets/{asset-id}
Get account information about a given asset.
AccountAssetInformation 3 params → 200400401500default
GET
/v2/accounts/{address}/transactions/pending
Get a list of unconfirmed transactions currently in the transaction pool by address.
GetPendingTransactionsByAddress 3 params → 200400401500503default
GET
/v2/applications/{application-id}
Get application information.
GetApplicationByID 1 param → 200400401404500default
GET
/v2/applications/{application-id}/box
Get box information for a given application.
GetApplicationBoxByName 2 params → 200400401404500default
GET
/v2/applications/{application-id}/boxes
Get all box names for a given application.
GetApplicationBoxes 7 params → 200400401500default
GET
/v2/assets/{asset-id}
Get asset information.
GetAssetByID 1 param → 200400401404500default
GET
/v2/blocks/{round}
Get the block for the given round.
GetBlock 3 params → 200400401404500default
GET
/v2/blocks/{round}/hash
Get the block hash for the block on the given round.
GetBlockHash 1 param → 200400401404500default
GET
/v2/blocks/{round}/lightheader/proof
Gets a proof for a given light block header inside a state proof commitment
GetLightBlockHeaderProof 1 param → 200401404408500503default
GET
/v2/blocks/{round}/logs
Get all of the logs from outer and inner app calls in the given round
GetBlockLogs 1 param → 200400401404500
GET
/v2/blocks/{round}/transactions/{txid}/proof
Get a proof for a transaction in a block.
GetTransactionProof 4 params → 200400401404500default
GET
/v2/blocks/{round}/txids
Get the top level transaction IDs for the block on the given round.
GetBlockTxids 1 param → 200400401404500default
GET
/v2/deltas/txn/group/{id}
Get a LedgerStateDelta object for a given transaction group
GetLedgerStateDeltaForTransactionGroup 2 params → 200401404408500501default
GET
/v2/deltas/{round}
Get a LedgerStateDelta object for a given round
GetLedgerStateDelta 2 params → 200401404408500503default
GET
/v2/deltas/{round}/txn/group
Get LedgerStateDelta objects for all transaction groups in a given round
GetTransactionGroupLedgerStateDeltasForRound 2 params → 200401404408500501default
GET
/v2/devmode/blocks/offset
Returns the timestamp offset. Timestamp offsets can only be set in dev mode.
GetBlockTimeStampOffset → 200400default
POST
/v2/devmode/blocks/offset/{offset}
Given a timestamp offset in seconds, adds the offset to every subsequent block header's timestamp.
SetBlockTimeStampOffset 1 param → 200400401500default
GET
/v2/experimental
Returns OK if experimental API is enabled.
ExperimentalCheck → 200404default
GET
/v2/ledger/supply
Get the current supply reported by the ledger.
GetSupply → 200401default
DELETE
/v2/ledger/sync
Removes minimum sync round restriction from the ledger.
UnsetSyncRound → 200400401500503default
GET
/v2/ledger/sync
Returns the minimum sync round the ledger is keeping in cache.
GetSyncRound → 200400401500503default
POST
/v2/ledger/sync/{round}
Given a round, tells the ledger to keep that round in its cache.
SetSyncRound 1 param → 200400401500503default
GET
/v2/stateproofs/{round}
Get a state proof that covers a given round
GetStateProof 1 param → 200401404408500503default
GET
/v2/status
Gets the current node status.
GetStatus → 200401500default
GET
/v2/status/wait-for-block-after/{round}
Gets the node status after waiting for a round after the given round.
WaitForBlock 1 param → 200400401500503default
POST
/v2/teal/compile
Compile TEAL source code to binary, produce its hash
TealCompile 1 param body → 200400401404500default
POST
/v2/teal/disassemble
Disassemble program bytes into the TEAL source code.
TealDisassemble body → 200400401404500default
POST
/v2/teal/dryrun
Provide debugging information for a transaction (or group).
TealDryrun body → 200400401404500default
POST
/v2/transactions
Broadcasts a raw transaction or transaction group to the network.
RawTransaction body → 200400401500503default
POST
/v2/transactions/async
Fast track for broadcasting a raw transaction or transaction group to the network through the tx handler without performing most of the checks and reporting detailed errors. Should be only used for d…
RawTransactionAsync body → 200400401404500503default
GET
/v2/transactions/params
Get parameters for constructing a new transaction
TransactionParams → 200401500503default
GET
/v2/transactions/pending
Get a list of unconfirmed transactions currently in the transaction pool.
GetPendingTransactions 2 params → 200401500503default
GET
/v2/transactions/pending/{txid}
Get a specific pending transaction.
PendingTransactionInformation 2 params → 200400401404default
POST
/v2/transactions/simulate
Simulates a raw transaction or transaction group as it would be evaluated on the network. The simulation will use blockchain state from the latest committed round.
SimulateTransaction 1 param body → 200400401500503default
GET
/versions
Retrieves the supported API versions, binary build versions, and genesis information.
GetVersion → 200

Schemas 56

The contract defines 56 schemas that model the data the API accepts and returns. The most detailed are Account (27 properties), AssetParams (15 properties), PendingTransactionResponse (14 properties), DryrunTxnResult (11 properties). Each schema is shown below with its type and property counts.

BuildVersion
object
6 properties 6 required
TealKeyValue
object
Represents a key-value pair in an application store.
2 properties 2 required
GenesisAllocation
object
3 properties 3 required
AccountParticipation
object
AccountParticipation describes the parameters used by this account in consensus protocol.
6 properties 5 required
AccountApplicationResource
object
AccountApplicationResource describes the account's application resource (local state and params if the account is the creator) for a specific application ID.
5 properties 1 required
AppCallLogs
object
The logged messages from an app call along with the app ID and outer transaction ID. Logs appear in the same order that they were emitted.
3 properties 3 required
TealKeyValueStore
array
Represents a key-value store for use in an application.
SimulateTraceConfig
object
An object that configures simulation execution trace.
4 properties
SimulationOpcodeTraceUnit
object
The set of trace information and effect from evaluating a single opcode.
6 properties 1 required
LightBlockHeaderProof
object
Proof of membership and position of a light block header.
3 properties 3 required
SimulateTransactionResult
object
Simulation result for an individual transaction
6 properties 1 required
AvmValue
object
Represents an AVM value.
3 properties 1 required
StateDelta
array
Application state delta.
SimulateRequest
object
Request type for simulation endpoint.
8 properties 1 required
ApplicationLocalReference
object
References an account's local state for an application.
2 properties 2 required
ApplicationParams
object
Stores the global information associated with an application.
9 properties 3 required
ApplicationKVStorage
object
An application's global/local/box state.
2 properties 1 required
StateProof
object
Represents a state proof and its corresponding message
2 properties 2 required
ApplicationLocalState
object
Stores local state associated with an application.
3 properties 2 required
ScratchChange
object
A write operation into a scratch slot.
2 properties 2 required
LedgerStateDelta
object
Ledger StateDelta object
ApplicationStateSchema
object
Specifies maximums on the number of each type that may be stored.
2 properties 2 required
Asset
object
Specifies both the unique identifier and the parameters for an asset
2 properties 1 required
BoxReference
object
References a box of an application.
2 properties 2 required
Genesis
object
9 properties 7 required
ApplicationStateOperation
object
An operation against an application's global/local/box state.
5 properties 3 required
TransactionProof
object
Proof of transaction in a block.
5 properties 5 required
AssetParams
object
AssetParams specifies the parameters for an asset. \[apar\] when part of an AssetConfig transaction. Definition: data/transactions/asset.go : AssetParams
15 properties 3 required
Version
object
algod version information.
4 properties 4 required
DryrunSource
object
DryrunSource is TEAL source text that gets uploaded, compiled, and inserted into transactions or application state.
4 properties 4 required
DryrunTxnResult
object
DryrunTxnResult contains any LogicSig or ApplicationCall program debug information and state updates from a dryrun.
11 properties 1 required
ApplicationInitialStates
object
An application's initial global/local/box states that were accessed during simulation.
4 properties 1 required
AccountStateDelta
object
Application state delta.
2 properties 2 required
Box
object
Box name and its content.
3 properties 3 required
ErrorResponse
object
An error response with optional data field.
2 properties 1 required
StateProofMessage
object
Represents the message that the state proofs are attesting to.
5 properties 5 required
LedgerStateDeltaForTransactionGroup
object
Contains a ledger delta for a single transaction group
2 properties 2 required
Application
object
Application index and its parameters
2 properties 1 required
SimulationTransactionExecTrace
object
The execution trace of calling an app or a logic sig, containing the inner app call trace in a recursive way.
9 properties
DryrunState
object
Stores the TEAL eval step data
5 properties 3 required
BoxDescriptor
object
Box descriptor describes a Box.
2 properties 1 required
EvalDeltaKeyValue
object
Key-value pairs for StateDelta.
2 properties 2 required
SimulateInitialStates
object
Initial states of resources that were accessed during simulation.
1 property
SimulationEvalOverrides
object
The set of parameters and limits override during simulation. If this set of parameters is present, then evaluation parameters may differ from standard evaluati…
6 properties
AssetHolding
object
Describes an asset held by an account. Definition: data/basics/userBalance.go : AssetHolding
3 properties 3 required
TealValue
object
Represents a TEAL value.
3 properties 3 required
AccountAssetHolding
object
AccountAssetHolding describes the account's asset holding and asset parameters (if either exist) for a specific asset ID.
2 properties 1 required
DryrunRequest
object
Request data type for dryrun endpoint. Given the Transactions and simulated ledger state upload, run TEAL scripts and return debugging information.
7 properties 7 required
PendingTransactionResponse
object
Details about a pending transaction. If the transaction was recently confirmed, includes confirmation details like the round and reward details.
14 properties 2 required
SimulateRequestTransactionGroup
object
A transaction group to simulate.
1 property 1 required
AssetHoldingReference
object
References an asset held by an account.
2 properties 2 required
EvalDelta
object
Represents a TEAL value delta.
3 properties 1 required
SimulateUnnamedResourcesAccessed
object
These are resources that were accessed by this group that would normally have caused failure, but were allowed in simulation. Depending on where this object is…
7 properties
AvmKeyValue
object
Represents an AVM key-value pair in an application store.
2 properties 2 required
Account
object
Account information at a given round. Definition: data/basics/userBalance.go : AccountData
27 properties 12 required
SimulateTransactionGroupResult
object
Simulation result for an atomic transaction group
6 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

algorand-public-api-openapi.yml Raw ↑

Other APIs Algorand publishes across the network.

Algorand KMD REST API
Algorand common API
Algorand Key API
Algorand lookup API
Algorand Master Key API
Algorand Multisig API
Algorand private API
Algorand Program API
Algorand search API
Algorand Swagger.json API
Algorand Transaction API
Algorand Versions API
Where this information came from

This is an independent, third-party profile of Algorand public API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.