{ "components": { "parameters": { "account-id": { "description": "account string", "in": "path", "name": "account-id", "required": true, "schema": { "type": "string", "x-go-name": "AccountID" }, "x-go-name": "AccountID" }, "address": { "description": "Only include transactions with this address in one of the transaction fields.", "in": "query", "name": "address", "schema": { "type": "string" } }, "address-role": { "description": "Combine with the address parameter to define what type of address to search for.", "in": "query", "name": "address-role", "schema": { "enum": [ "sender", "receiver", "freeze-target" ], "type": "string" } }, "after-time": { "description": "Include results after the given time. Must be an RFC 3339 formatted string.", "in": "query", "name": "after-time", "schema": { "format": "date-time", "type": "string", "x-algorand-format": "RFC3339 String" }, "x-algorand-format": "RFC3339 String" }, "asset-id": { "description": "Asset ID", "in": "query", "name": "asset-id", "schema": { "type": "integer", "x-go-name": "AssetID" }, "x-go-name": "AssetID" }, "before-time": { "description": "Include results before the given time. Must be an RFC 3339 formatted string.", "in": "query", "name": "before-time", "schema": { "format": "date-time", "type": "string", "x-algorand-format": "RFC3339 String" }, "x-algorand-format": "RFC3339 String" }, "catchpoint": { "description": "A catch point", "in": "path", "name": "catchpoint", "required": true, "schema": { "format": "catchpoint", "pattern": "[0-9]{1,10}#[A-Z0-9]{1,53}", "type": "string", "x-algorand-format": "Catchpoint String" }, "x-algorand-format": "Catchpoint String" }, "currency-greater-than": { "description": "Results should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.", "in": "query", "name": "currency-greater-than", "schema": { "type": "integer" } }, "currency-less-than": { "description": "Results should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.", "in": "query", "name": "currency-less-than", "schema": { "type": "integer" } }, "exclude-close-to": { "description": "Combine with address and address-role parameters to define what type of address to search for. The close to fields are normally treated as a receiver, if you would like to exclude them set this parameter to true.", "in": "query", "name": "exclude-close-to", "schema": { "type": "boolean" } }, "format": { "description": "Configures whether the response object is JSON or MessagePack encoded.", "in": "query", "name": "format", "schema": { "enum": [ "json", "msgpack" ], "type": "string" } }, "limit": { "description": "Maximum number of results to return.", "in": "query", "name": "limit", "schema": { "type": "integer" } }, "max": { "description": "Truncated number of transactions to display. If max=0, returns all pending txns.", "in": "query", "name": "max", "schema": { "type": "integer" } }, "max-round": { "description": "Include results at or before the specified max-round.", "in": "query", "name": "max-round", "schema": { "type": "integer" } }, "min-round": { "description": "Include results at or after the specified min-round.", "in": "query", "name": "min-round", "schema": { "type": "integer" } }, "next": { "description": "The next page of results. Use the next token provided by the previous results.", "in": "query", "name": "next", "schema": { "type": "string" } }, "note-prefix": { "description": "Specifies a prefix which must be contained in the note field.", "in": "query", "name": "note-prefix", "schema": { "type": "string", "x-algorand-format": "base64" }, "x-algorand-format": "base64" }, "round": { "description": "Include results for the specified round.", "in": "query", "name": "round", "schema": { "type": "integer" } }, "round-number": { "description": "Round number", "in": "path", "name": "round-number", "required": true, "schema": { "type": "integer" } }, "sig-type": { "description": "SigType filters just results using the specified type of signature:\n* sig - Standard\n* msig - MultiSig\n* lsig - LogicSig", "in": "query", "name": "sig-type", "schema": { "enum": [ "sig", "msig", "lsig" ], "type": "string" } }, "tx-id": { "description": "Lookup the specific transaction by ID.", "in": "query", "name": "tx-id", "schema": { "type": "string", "x-algorand-format": "Address", "x-go-name": "TxID" }, "x-algorand-format": "Address", "x-go-name": "TxID" }, "tx-type": { "in": "query", "name": "tx-type", "schema": { "enum": [ "pay", "keyreg", "acfg", "axfer", "afrz", "appl" ], "type": "string" } } }, "responses": { "AccountApplicationResponse": { "content": { "application/json": { "schema": { "properties": { "app-local-state": { "$ref": "#/components/schemas/ApplicationLocalState" }, "created-app": { "$ref": "#/components/schemas/ApplicationParams" }, "round": { "description": "The round for which this information is relevant.", "type": "integer" } }, "required": [ "round" ], "type": "object" } } }, "description": "AccountApplicationResponse describes the account's application local state and global state (AppLocalState and AppParams, if either exists) for a specific application ID. Global state will only be returned if the provided address is the application's creator." }, "AccountAssetResponse": { "content": { "application/json": { "schema": { "properties": { "asset-holding": { "$ref": "#/components/schemas/AssetHolding" }, "created-asset": { "$ref": "#/components/schemas/AssetParams" }, "round": { "description": "The round for which this information is relevant.", "type": "integer" } }, "required": [ "round" ], "type": "object" } } }, "description": "AccountAssetResponse describes the account's asset holding and asset parameters (if either exist) for a specific asset ID. Asset parameters will only be returned if the provided address is the asset's creator." }, "AccountResponse": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Account" } } }, "description": "AccountResponse wraps the Account type in a response." }, "ApplicationResponse": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application" } } }, "description": "Application information" }, "AssetResponse": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Asset" } } }, "description": "Asset information" }, "BlockResponse": { "content": { "application/json": { "schema": { "properties": { "block": { "description": "Block header data.", "properties": {}, "type": "object", "x-algorand-format": "BlockHeader" }, "cert": { "description": "Optional certificate object. This is only included when the format is set to message pack.", "properties": {}, "type": "object", "x-algorand-format": "BlockCertificate" } }, "required": [ "block" ], "type": "object" } } }, "description": "Encoded block object." }, "CatchpointAbortResponse": { "content": { "application/json": { "schema": { "description": "An catchpoint abort response.", "properties": { "catchup-message": { "description": "Catchup abort response string", "type": "string" } }, "required": [ "catchup-message" ], "type": "object" } } } }, "CatchpointStartResponse": { "content": { "application/json": { "schema": { "description": "An catchpoint start response.", "properties": { "catchup-message": { "description": "Catchup start response string", "type": "string" } }, "required": [ "catchup-message" ], "type": "object" } } } }, "CompileResponse": { "content": { "application/json": { "schema": { "properties": { "hash": { "description": "base32 SHA512_256 of program bytes (Address style)", "type": "string" }, "result": { "description": "base64 encoded program bytes", "type": "string" }, "sourcemap": { "description": "JSON of the source map", "properties": {}, "type": "object" } }, "required": [ "hash", "result" ], "type": "object" } } }, "description": "Teal compile Result" }, "DisassembleResponse": { "content": { "application/json": { "schema": { "properties": { "result": { "description": "disassembled Teal code", "type": "string" } }, "required": [ "result" ], "type": "object" } } }, "description": "Teal disassembly Result" }, "DryrunResponse": { "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" }, "protocol-version": { "description": "Protocol version is the protocol version Dryrun was operated under.", "type": "string" }, "txns": { "items": { "$ref": "#/components/schemas/DryrunTxnResult" }, "type": "array" } }, "required": [ "error", "protocol-version", "txns" ], "type": "object" } } }, "description": "DryrunResponse contains per-txn debug information from a dryrun." }, "NodeStatusResponse": { "content": { "application/json": { "schema": { "description": "NodeStatus contains the information about a node status", "properties": { "catchpoint": { "description": "The current catchpoint that is being caught up to", "type": "string" }, "catchpoint-acquired-blocks": { "description": "The number of blocks that have already been obtained by the node as part of the catchup", "type": "integer" }, "catchpoint-processed-accounts": { "description": "The number of accounts from the current catchpoint that have been processed so far as part of the catchup", "type": "integer" }, "catchpoint-total-accounts": { "description": "The total number of accounts included in the current catchpoint", "type": "integer" }, "catchpoint-total-blocks": { "description": "The total number of blocks that are required to complete the current catchpoint catchup", "type": "integer" }, "catchpoint-verified-accounts": { "description": "The number of accounts from the current catchpoint that have been verified so far as part of the catchup", "type": "integer" }, "catchup-time": { "description": "CatchupTime in nanoseconds", "type": "integer" }, "last-catchpoint": { "description": "The last catchpoint seen by the node", "type": "string" }, "last-round": { "description": "LastRound indicates the last round seen", "type": "integer" }, "last-version": { "description": "LastVersion indicates the last consensus version supported", "type": "string" }, "next-version": { "description": "NextVersion of consensus protocol to use", "type": "string" }, "next-version-round": { "description": "NextVersionRound is the round at which the next consensus version will apply", "type": "integer" }, "next-version-supported": { "description": "NextVersionSupported indicates whether the next consensus version is supported by this node", "type": "boolean" }, "stopped-at-unsupported-round": { "description": "StoppedAtUnsupportedRound indicates that the node does not support the new rounds and has stopped making progress", "type": "boolean" }, "time-since-last-round": { "description": "TimeSinceLastRound in nanoseconds", "type": "integer" } }, "required": [ "catchup-time", "last-round", "last-version", "next-version", "next-version-round", "next-version-supported", "stopped-at-unsupported-round", "time-since-last-round" ], "type": "object" } } } }, "ParticipationKeyResponse": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ParticipationKey" } } }, "description": "A detailed description of a participation ID" }, "ParticipationKeysResponse": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ParticipationKey" }, "type": "array" } } }, "description": "A list of participation keys" }, "PendingTransactionsResponse": { "content": { "application/json": { "schema": { "description": "PendingTransactions is an array of signed transactions exactly as they were submitted.", "properties": { "top-transactions": { "description": "An array of signed transaction objects.", "items": { "properties": {}, "type": "object", "x-algorand-format": "SignedTransaction" }, "type": "array" }, "total-transactions": { "description": "Total number of transactions in the pool.", "type": "integer" } }, "required": [ "top-transactions", "total-transactions" ], "type": "object" } } }, "description": "A potentially truncated list of transactions currently in the node's transaction pool. You can compute whether or not the list is truncated if the number of elements in the **top-transactions** array is fewer than **total-transactions**." }, "PostParticipationResponse": { "content": { "application/json": { "schema": { "properties": { "partId": { "description": "encoding of the participation ID.", "type": "string" } }, "required": [ "partId" ], "type": "object" } } }, "description": "Participation ID of the submission" }, "PostTransactionsResponse": { "content": { "application/json": { "schema": { "properties": { "txId": { "description": "encoding of the transaction hash.", "type": "string" } }, "required": [ "txId" ], "type": "object" } } }, "description": "Transaction ID of the submission." }, "ProofResponse": { "content": { "application/json": { "schema": { "properties": { "hashtype": { "description": "The type of hash function used to create the proof, must be one of: \n* sha512_256 \n* sha256", "enum": [ "sha512_256", "sha256" ], "type": "string" }, "idx": { "description": "Index of the transaction in the block's payset.", "type": "integer" }, "proof": { "description": "Merkle proof of transaction membership.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "stibhash": { "description": "Hash of SignedTxnInBlock for verifying proof.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "treedepth": { "description": "Represents the depth of the tree that is being proven, i.e. the number of edges from a leaf to the root.", "type": "integer" } }, "required": [ "hashtype", "idx", "proof", "stibhash", "treedepth" ], "type": "object" } } }, "description": "Proof of transaction in a block." }, "SupplyResponse": { "content": { "application/json": { "schema": { "description": "Supply represents the current supply of MicroAlgos in the system", "properties": { "current_round": { "description": "Round", "type": "integer" }, "online-money": { "description": "OnlineMoney", "type": "integer" }, "total-money": { "description": "TotalMoney", "type": "integer" } }, "required": [ "current_round", "online-money", "total-money" ], "type": "object" } } }, "description": "Supply represents the current supply of MicroAlgos in the system." }, "TransactionParametersResponse": { "content": { "application/json": { "schema": { "description": "TransactionParams contains the parameters that help a client construct\na new transaction.", "properties": { "consensus-version": { "description": "ConsensusVersion indicates the consensus protocol version\nas of LastRound.", "type": "string" }, "fee": { "description": "Fee is the suggested transaction fee\nFee is in units of micro-Algos per byte.\nFee may fall to zero but transactions must still have a fee of\nat least MinTxnFee for the current network protocol.", "type": "integer" }, "genesis-hash": { "description": "GenesisHash is the hash of the genesis block.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "genesis-id": { "description": "GenesisID is an ID listed in the genesis block.", "type": "string" }, "last-round": { "description": "LastRound indicates the last round seen", "type": "integer" }, "min-fee": { "description": "The minimum transaction fee (not per byte) required for the\ntxn to validate for the current network protocol.", "type": "integer" } }, "required": [ "consensus-version", "fee", "genesis-hash", "genesis-id", "last-round", "min-fee" ], "type": "object", "x-go-package": "github.com/algorand/go-algorand/daemon/algod/api/spec/v1" } } }, "description": "TransactionParams contains the parameters that help a client construct a new transaction." }, "VersionsResponse": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Version" } } }, "description": "VersionsResponse is the response to 'GET /versions'" } }, "schemas": { "Account": { "description": "Account information at a given round.\n\nDefinition:\ndata/basics/userBalance.go : AccountData\n", "properties": { "address": { "description": "the account public key", "type": "string" }, "amount": { "description": "\\[algo\\] total number of MicroAlgos in the account", "type": "integer" }, "amount-without-pending-rewards": { "description": "specifies the amount of MicroAlgos in the account, without the pending rewards.", "type": "integer" }, "apps-local-state": { "description": "\\[appl\\] applications local data stored in this account.\n\nNote the raw object uses `map[int] -> AppLocalState` for this type.", "items": { "$ref": "#/components/schemas/ApplicationLocalState" }, "type": "array" }, "apps-total-extra-pages": { "description": "\\[teap\\] the sum of all extra application program pages for this account.", "type": "integer" }, "apps-total-schema": { "$ref": "#/components/schemas/ApplicationStateSchema" }, "assets": { "description": "\\[asset\\] assets held by this account.\n\nNote the raw object uses `map[int] -> AssetHolding` for this type.", "items": { "$ref": "#/components/schemas/AssetHolding" }, "type": "array" }, "auth-addr": { "description": "\\[spend\\] the address against which signing should be checked. If empty, the address of the current account is used. This field can be updated in any transaction by setting the RekeyTo field.", "type": "string", "x-algorand-format": "Address" }, "created-apps": { "description": "\\[appp\\] parameters of applications created by this account including app global data.\n\nNote: the raw account uses `map[int] -> AppParams` for this type.", "items": { "$ref": "#/components/schemas/Application" }, "type": "array" }, "created-assets": { "description": "\\[apar\\] parameters of assets created by this account.\n\nNote: the raw account uses `map[int] -> Asset` for this type.", "items": { "$ref": "#/components/schemas/Asset" }, "type": "array" }, "min-balance": { "description": "MicroAlgo balance required by the account.\n\nThe requirement grows based on asset and application usage.", "type": "integer" }, "participation": { "$ref": "#/components/schemas/AccountParticipation" }, "pending-rewards": { "description": "amount of MicroAlgos of pending rewards in this account.", "type": "integer" }, "reward-base": { "description": "\\[ebase\\] used as part of the rewards computation. Only applicable to accounts which are participating.", "type": "integer" }, "rewards": { "description": "\\[ern\\] total rewards of MicroAlgos the account has received, including pending rewards.", "type": "integer" }, "round": { "description": "The round for which this information is relevant.", "type": "integer" }, "sig-type": { "description": "Indicates what type of signature is used by this account, must be one of:\n* sig\n* msig\n* lsig", "enum": [ "sig", "msig", "lsig" ], "type": "string" }, "status": { "description": "\\[onl\\] delegation status of the account's MicroAlgos\n* Offline - indicates that the associated account is delegated.\n* Online - indicates that the associated account used as part of the delegation pool.\n* NotParticipating - indicates that the associated account is neither a delegator nor a delegate.", "type": "string" }, "total-apps-opted-in": { "description": "The count of all applications that have been opted in, equivalent to the count of application local data (AppLocalState objects) stored in this account.", "type": "integer" }, "total-assets-opted-in": { "description": "The count of all assets that have been opted in, equivalent to the count of AssetHolding objects held by this account.", "type": "integer" }, "total-created-apps": { "description": "The count of all apps (AppParams objects) created by this account.", "type": "integer" }, "total-created-assets": { "description": "The count of all assets (AssetParams objects) created by this account.", "type": "integer" } }, "required": [ "address", "amount", "amount-without-pending-rewards", "min-balance", "pending-rewards", "rewards", "round", "status", "total-apps-opted-in", "total-assets-opted-in", "total-created-apps", "total-created-assets" ], "type": "object" }, "AccountParticipation": { "description": "AccountParticipation describes the parameters used by this account in consensus protocol.", "properties": { "selection-participation-key": { "description": "\\[sel\\] Selection public key (if any) currently registered for this round.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "state-proof-key": { "description": "\\[stprf\\] Root of the state proof key (if any)", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "vote-first-valid": { "description": "\\[voteFst\\] First round for which this participation is valid.", "type": "integer" }, "vote-key-dilution": { "description": "\\[voteKD\\] Number of subkeys in each batch of participation keys.", "type": "integer" }, "vote-last-valid": { "description": "\\[voteLst\\] Last round for which this participation is valid.", "type": "integer" }, "vote-participation-key": { "description": "\\[vote\\] root participation public key (if any) currently registered for this round.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" } }, "required": [ "selection-participation-key", "vote-first-valid", "vote-key-dilution", "vote-last-valid", "vote-participation-key" ], "type": "object" }, "AccountStateDelta": { "description": "Application state delta.", "properties": { "address": { "type": "string" }, "delta": { "$ref": "#/components/schemas/StateDelta" } }, "required": [ "address", "delta" ], "type": "object" }, "Application": { "description": "Application index and its parameters", "properties": { "id": { "description": "\\[appidx\\] application index.", "type": "integer" }, "params": { "$ref": "#/components/schemas/ApplicationParams" } }, "required": [ "id", "params" ], "type": "object" }, "ApplicationLocalState": { "description": "Stores local state associated with an application.", "properties": { "id": { "description": "The application which this local state is for.", "type": "integer" }, "key-value": { "$ref": "#/components/schemas/TealKeyValueStore" }, "schema": { "$ref": "#/components/schemas/ApplicationStateSchema" } }, "required": [ "id", "schema" ], "type": "object" }, "ApplicationParams": { "description": "Stores the global information associated with an application.", "properties": { "approval-program": { "description": "\\[approv\\] approval program.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string", "x-algorand-format": "TEALProgram" }, "clear-state-program": { "description": "\\[clearp\\] approval program.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string", "x-algorand-format": "TEALProgram" }, "creator": { "description": "The address that created this application. This is the address where the parameters and global state for this application can be found.", "type": "string", "x-algorand-format": "Address" }, "extra-program-pages": { "description": "\\[epp\\] the amount of extra program pages available to this app.", "type": "integer" }, "global-state": { "$ref": "#/components/schemas/TealKeyValueStore" }, "global-state-schema": { "$ref": "#/components/schemas/ApplicationStateSchema" }, "local-state-schema": { "$ref": "#/components/schemas/ApplicationStateSchema" } }, "required": [ "approval-program", "clear-state-program", "creator" ], "type": "object" }, "ApplicationStateSchema": { "description": "Specifies maximums on the number of each type that may be stored.", "properties": { "num-byte-slice": { "description": "\\[nbs\\] num of byte slices.", "type": "integer" }, "num-uint": { "description": "\\[nui\\] num of uints.", "type": "integer" } }, "required": [ "num-byte-slice", "num-uint" ], "type": "object" }, "Asset": { "description": "Specifies both the unique identifier and the parameters for an asset", "properties": { "index": { "description": "unique asset identifier", "type": "integer" }, "params": { "$ref": "#/components/schemas/AssetParams" } }, "required": [ "index", "params" ], "type": "object" }, "AssetHolding": { "description": "Describes an asset held by an account.\n\nDefinition:\ndata/basics/userBalance.go : AssetHolding", "properties": { "amount": { "description": "\\[a\\] number of units held.", "type": "integer", "x-algorand-format": "uint64" }, "asset-id": { "description": "Asset ID of the holding.", "type": "integer", "x-go-name": "AssetID" }, "is-frozen": { "description": "\\[f\\] whether or not the holding is frozen.", "type": "boolean" } }, "required": [ "amount", "asset-id", "is-frozen" ], "type": "object" }, "AssetParams": { "description": "AssetParams specifies the parameters for an asset.\n\n\\[apar\\] when part of an AssetConfig transaction.\n\nDefinition:\ndata/transactions/asset.go : AssetParams", "properties": { "clawback": { "description": "\\[c\\] Address of account used to clawback holdings of this asset. If empty, clawback is not permitted.", "type": "string" }, "creator": { "description": "The address that created this asset. This is the address where the parameters for this asset can be found, and also the address where unwanted asset units can be sent in the worst case.", "type": "string" }, "decimals": { "description": "\\[dc\\] The number of digits to use after the decimal point when displaying this asset. If 0, the asset is not divisible. If 1, the base unit of the asset is in tenths. If 2, the base unit of the asset is in hundredths, and so on. This value must be between 0 and 19 (inclusive).", "maximum": 19, "minimum": 0, "type": "integer" }, "default-frozen": { "description": "\\[df\\] Whether holdings of this asset are frozen by default.", "type": "boolean" }, "freeze": { "description": "\\[f\\] Address of account used to freeze holdings of this asset. If empty, freezing is not permitted.", "type": "string" }, "manager": { "description": "\\[m\\] Address of account used to manage the keys of this asset and to destroy it.", "type": "string" }, "metadata-hash": { "description": "\\[am\\] A commitment to some unspecified asset metadata. The format of this metadata is up to the application.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "name": { "description": "\\[an\\] Name of this asset, as supplied by the creator. Included only when the asset name is composed of printable utf-8 characters.", "type": "string" }, "name-b64": { "description": "Base64 encoded name of this asset, as supplied by the creator.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "reserve": { "description": "\\[r\\] Address of account holding reserve (non-minted) units of this asset.", "type": "string" }, "total": { "description": "\\[t\\] The total number of units of this asset.", "type": "integer", "x-algorand-format": "uint64" }, "unit-name": { "description": "\\[un\\] Name of a unit of this asset, as supplied by the creator. Included only when the name of a unit of this asset is composed of printable utf-8 characters.", "type": "string" }, "unit-name-b64": { "description": "Base64 encoded name of a unit of this asset, as supplied by the creator.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "url": { "description": "\\[au\\] URL where more information about the asset can be retrieved. Included only when the URL is composed of printable utf-8 characters.", "type": "string" }, "url-b64": { "description": "Base64 encoded URL where more information about the asset can be retrieved.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" } }, "required": [ "creator", "decimals", "total" ], "type": "object" }, "BuildVersion": { "properties": { "branch": { "type": "string" }, "build_number": { "format": "int64", "type": "integer" }, "channel": { "type": "string" }, "commit_hash": { "type": "string" }, "major": { "format": "int64", "type": "integer" }, "minor": { "format": "int64", "type": "integer" } }, "required": [ "branch", "build_number", "channel", "commit_hash", "major", "minor" ], "title": "BuildVersion contains the current algod build version information.", "type": "object" }, "DryrunRequest": { "description": "Request data type for dryrun endpoint. Given the Transactions and simulated ledger state upload, run TEAL scripts and return debugging information.", "properties": { "accounts": { "items": { "$ref": "#/components/schemas/Account" }, "type": "array" }, "apps": { "items": { "$ref": "#/components/schemas/Application" }, "type": "array" }, "latest-timestamp": { "description": "LatestTimestamp is available to some TEAL scripts. Defaults to the latest confirmed timestamp this algod is attached to.", "format": "int64", "type": "integer" }, "protocol-version": { "description": "ProtocolVersion specifies a specific version string to operate under, otherwise whatever the current protocol of the network this algod is running in.", "type": "string" }, "round": { "description": "Round is available to some TEAL scripts. Defaults to the current round on the network this algod is attached to.", "type": "integer", "x-algorand-format": "uint64" }, "sources": { "items": { "$ref": "#/components/schemas/DryrunSource" }, "type": "array" }, "txns": { "items": { "description": "SignedTxn object. Must be canonically encoded.", "format": "json", "type": "string", "x-algorand-format": "SignedTransaction" }, "type": "array" } }, "required": [ "accounts", "apps", "latest-timestamp", "protocol-version", "round", "sources", "txns" ], "type": "object" }, "DryrunSource": { "description": "DryrunSource is TEAL source text that gets uploaded, compiled, and inserted into transactions or application state.", "properties": { "app-index": { "type": "integer", "x-algorand-format": "uint64" }, "field-name": { "description": "FieldName is what kind of sources this is. If lsig then it goes into the transactions[this.TxnIndex].LogicSig. If approv or clearp it goes into the Approval Program or Clear State Program of application[this.AppIndex].", "type": "string" }, "source": { "type": "string" }, "txn-index": { "type": "integer" } }, "required": [ "app-index", "field-name", "source", "txn-index" ], "type": "object" }, "DryrunState": { "description": "Stores the TEAL eval step data", "properties": { "error": { "description": "Evaluation error if any", "type": "string" }, "line": { "description": "Line number", "type": "integer" }, "pc": { "description": "Program counter", "type": "integer" }, "scratch": { "items": { "$ref": "#/components/schemas/TealValue" }, "type": "array" }, "stack": { "items": { "$ref": "#/components/schemas/TealValue" }, "type": "array" } }, "required": [ "line", "pc", "stack" ], "type": "object" }, "DryrunTxnResult": { "description": "DryrunTxnResult contains any LogicSig or ApplicationCall program debug information and state updates from a dryrun.", "properties": { "app-call-messages": { "items": { "type": "string" }, "type": "array" }, "app-call-trace": { "items": { "$ref": "#/components/schemas/DryrunState" }, "type": "array" }, "budget-added": { "description": "Budget added during execution of app call transaction.", "type": "integer" }, "budget-consumed": { "description": "Budget consumed during execution of app call transaction.", "type": "integer" }, "cost": { "description": "Net cost of app execution. Field is DEPRECATED and is subject for removal. Instead, use `budget-added` and `budget-consumed.", "type": "integer" }, "disassembly": { "description": "Disassembled program line by line.", "items": { "type": "string" }, "type": "array" }, "global-delta": { "$ref": "#/components/schemas/StateDelta" }, "local-deltas": { "items": { "$ref": "#/components/schemas/AccountStateDelta" }, "type": "array" }, "logic-sig-disassembly": { "description": "Disassembled lsig program line by line.", "items": { "type": "string" }, "type": "array" }, "logic-sig-messages": { "items": { "type": "string" }, "type": "array" }, "logic-sig-trace": { "items": { "$ref": "#/components/schemas/DryrunState" }, "type": "array" }, "logs": { "items": { "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "type": "array" } }, "required": [ "disassembly" ], "type": "object" }, "ErrorResponse": { "description": "An error response with optional data field.", "properties": { "data": { "properties": {}, "type": "object" }, "message": { "type": "string" } }, "required": [ "message" ], "type": "object" }, "EvalDelta": { "description": "Represents a TEAL value delta.", "properties": { "action": { "description": "\\[at\\] delta action.", "type": "integer" }, "bytes": { "description": "\\[bs\\] bytes value.", "type": "string" }, "uint": { "description": "\\[ui\\] uint value.", "type": "integer", "x-algorand-format": "uint64" } }, "required": [ "action" ], "type": "object" }, "EvalDeltaKeyValue": { "description": "Key-value pairs for StateDelta.", "properties": { "key": { "type": "string" }, "value": { "$ref": "#/components/schemas/EvalDelta" } }, "required": [ "key", "value" ], "type": "object" }, "ParticipationKey": { "description": "Represents a participation key used by the node.", "properties": { "address": { "description": "Address the key was generated for.", "type": "string", "x-algorand-format": "Address" }, "effective-first-valid": { "description": "When registered, this is the first round it may be used.", "type": "integer", "x-algorand-format": "uint64" }, "effective-last-valid": { "description": "When registered, this is the last round it may be used.", "type": "integer", "x-algorand-format": "uint64" }, "id": { "description": "The key's ParticipationID.", "type": "string" }, "key": { "$ref": "#/components/schemas/AccountParticipation" }, "last-block-proposal": { "description": "Round when this key was last used to propose a block.", "type": "integer" }, "last-state-proof": { "description": "Round when this key was last used to generate a state proof.", "type": "integer" }, "last-vote": { "description": "Round when this key was last used to vote.", "type": "integer" } }, "required": [ "address", "id", "key" ], "type": "object" }, "PendingTransactionResponse": { "description": "Details about a pending transaction. If the transaction was recently confirmed, includes confirmation details like the round and reward details.", "properties": { "application-index": { "description": "The application index if the transaction was found and it created an application.", "type": "integer" }, "asset-closing-amount": { "description": "The number of the asset's unit that were transferred to the close-to address.", "type": "integer" }, "asset-index": { "description": "The asset index if the transaction was found and it created an asset.", "type": "integer" }, "close-rewards": { "description": "Rewards in microalgos applied to the close remainder to account.", "type": "integer" }, "closing-amount": { "description": "Closing amount for the transaction.", "type": "integer" }, "confirmed-round": { "description": "The round where this transaction was confirmed, if present.", "type": "integer" }, "global-state-delta": { "$ref": "#/components/schemas/StateDelta" }, "inner-txns": { "description": "Inner transactions produced by application execution.", "items": { "$ref": "#/components/schemas/PendingTransactionResponse" }, "type": "array" }, "local-state-delta": { "description": "\\[ld\\] Local state key/value changes for the application being executed by this transaction.", "items": { "$ref": "#/components/schemas/AccountStateDelta" }, "type": "array" }, "logs": { "description": "\\[lg\\] Logs for the application being executed by this transaction.", "items": { "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "type": "array" }, "pool-error": { "description": "Indicates that the transaction was kicked out of this node's transaction pool (and specifies why that happened). An empty string indicates the transaction wasn't kicked out of this node's txpool due to an error.\n", "type": "string" }, "receiver-rewards": { "description": "Rewards in microalgos applied to the receiver account.", "type": "integer" }, "sender-rewards": { "description": "Rewards in microalgos applied to the sender account.", "type": "integer" }, "txn": { "description": "The raw signed transaction.", "properties": {}, "type": "object", "x-algorand-format": "SignedTransaction" } }, "required": [ "pool-error", "txn" ], "type": "object" }, "StateDelta": { "description": "Application state delta.", "items": { "$ref": "#/components/schemas/EvalDeltaKeyValue" }, "type": "array" }, "TealKeyValue": { "description": "Represents a key-value pair in an application store.", "properties": { "key": { "type": "string" }, "value": { "$ref": "#/components/schemas/TealValue" } }, "required": [ "key", "value" ], "type": "object" }, "TealKeyValueStore": { "description": "Represents a key-value store for use in an application.", "items": { "$ref": "#/components/schemas/TealKeyValue" }, "type": "array" }, "TealValue": { "description": "Represents a TEAL value.", "properties": { "bytes": { "description": "\\[tb\\] bytes value.", "type": "string" }, "type": { "description": "\\[tt\\] value type. Value `1` refers to **bytes**, value `2` refers to **uint**", "type": "integer" }, "uint": { "description": "\\[ui\\] uint value.", "type": "integer", "x-algorand-format": "uint64" } }, "required": [ "bytes", "type", "uint" ], "type": "object" }, "Version": { "description": "algod version information.", "properties": { "build": { "$ref": "#/components/schemas/BuildVersion" }, "genesis_hash_b64": { "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "genesis_id": { "type": "string" }, "versions": { "items": { "type": "string" }, "type": "array" } }, "required": [ "build", "genesis_hash_b64", "genesis_id", "versions" ], "title": "Version contains the current algod version.", "type": "object" } }, "securitySchemes": { "api_key": { "description": "Generated header parameter. This token can be generated using the Goal command line tool. Example value ='b7e384d0317b8050ce45900a94a1931e28540e1f69b2d242b424659c341b4697'", "in": "header", "name": "X-Algo-API-Token", "type": "apiKey" } } }, "info": { "contact": { "email": "contact@algorand.com", "name": "algorand", "url": "https://www.algorand.com/get-in-touch/contact" }, "description": "API endpoint for algod operations.", "title": "Algod REST API.", "version": "0.0.1" }, "openapi": "3.0.1", "paths": { "/genesis": { "get": { "description": "Returns the entire genesis file in json.", "operationId": "GetGenesis", "responses": { "200": { "content": { "application/json": { "schema": { "type": "string" } } }, "description": "The genesis file in json." }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Gets the genesis information.", "tags": [ "common" ] } }, "/health": { "get": { "operationId": "HealthCheck", "responses": { "200": { "content": {}, "description": "OK." }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Returns OK if healthy.", "tags": [ "common" ] } }, "/metrics": { "get": { "operationId": "Metrics", "responses": { "200": { "content": {}, "description": "text with \\#-comments and key:value lines" }, "404": { "content": {}, "description": "metrics were compiled out" } }, "summary": "Return metrics about algod functioning.", "tags": [ "common" ] } }, "/swagger.json": { "get": { "description": "Returns the entire swagger spec in json.", "operationId": "SwaggerJSON", "responses": { "200": { "content": { "application/json": { "schema": { "type": "string" } } }, "description": "The current swagger spec" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Gets the current swagger spec.", "tags": [ "common" ] } }, "/v2/accounts/{address}": { "get": { "description": "Given a specific account public key, this call returns the accounts status, balance and spendable amounts", "operationId": "AccountInformation", "parameters": [ { "description": "Configures whether the response object is JSON or MessagePack encoded.", "in": "query", "name": "format", "schema": { "enum": [ "json", "msgpack" ], "type": "string" } }, { "description": "An account public key", "in": "path", "name": "address", "required": true, "schema": { "pattern": "[A-Z0-9]{58}", "type": "string" } }, { "description": "When set to `all` will exclude asset holdings, application local state, created asset parameters, any created application parameters. Defaults to `none`.", "in": "query", "name": "exclude", "schema": { "enum": [ "all", "none" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Account" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/Account" } } }, "description": "AccountResponse wraps the Account type in a response." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get account information." } }, "/v2/accounts/{address}/applications/{application-id}": { "get": { "description": "Given a specific account public key and application ID, this call returns the account's application local state and global state (AppLocalState and AppParams, if either exists). Global state will only be returned if the provided address is the application's creator.", "operationId": "AccountApplicationInformation", "parameters": [ { "description": "Configures whether the response object is JSON or MessagePack encoded.", "in": "query", "name": "format", "schema": { "enum": [ "json", "msgpack" ], "type": "string" } }, { "description": "An account public key", "in": "path", "name": "address", "required": true, "schema": { "pattern": "[A-Z0-9]{58}", "type": "string" } }, { "description": "An application identifier", "in": "path", "name": "application-id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "app-local-state": { "$ref": "#/components/schemas/ApplicationLocalState" }, "created-app": { "$ref": "#/components/schemas/ApplicationParams" }, "round": { "description": "The round for which this information is relevant.", "type": "integer" } }, "required": [ "round" ], "type": "object" } }, "application/msgpack": { "schema": { "properties": { "app-local-state": { "$ref": "#/components/schemas/ApplicationLocalState" }, "created-app": { "$ref": "#/components/schemas/ApplicationParams" }, "round": { "description": "The round for which this information is relevant.", "type": "integer" } }, "required": [ "round" ], "type": "object" } } }, "description": "AccountApplicationResponse describes the account's application local state and global state (AppLocalState and AppParams, if either exists) for a specific application ID. Global state will only be returned if the provided address is the application's creator." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Malformed address or application ID" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get account information about a given app." } }, "/v2/accounts/{address}/assets/{asset-id}": { "get": { "description": "Given a specific account public key and asset ID, this call returns the account's asset holding and asset parameters (if either exist). Asset parameters will only be returned if the provided address is the asset's creator.", "operationId": "AccountAssetInformation", "parameters": [ { "description": "Configures whether the response object is JSON or MessagePack encoded.", "in": "query", "name": "format", "schema": { "enum": [ "json", "msgpack" ], "type": "string" } }, { "description": "An account public key", "in": "path", "name": "address", "required": true, "schema": { "pattern": "[A-Z0-9]{58}", "type": "string" } }, { "description": "An asset identifier", "in": "path", "name": "asset-id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "asset-holding": { "$ref": "#/components/schemas/AssetHolding" }, "created-asset": { "$ref": "#/components/schemas/AssetParams" }, "round": { "description": "The round for which this information is relevant.", "type": "integer" } }, "required": [ "round" ], "type": "object" } }, "application/msgpack": { "schema": { "properties": { "asset-holding": { "$ref": "#/components/schemas/AssetHolding" }, "created-asset": { "$ref": "#/components/schemas/AssetParams" }, "round": { "description": "The round for which this information is relevant.", "type": "integer" } }, "required": [ "round" ], "type": "object" } } }, "description": "AccountAssetResponse describes the account's asset holding and asset parameters (if either exist) for a specific asset ID. Asset parameters will only be returned if the provided address is the asset's creator." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Malformed address or asset ID" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get account information about a given asset." } }, "/v2/accounts/{address}/transactions/pending": { "get": { "description": "Get the list of pending transactions by address, sorted by priority, in decreasing order, truncated at the end at MAX. If MAX = 0, returns all pending transactions.\n", "operationId": "GetPendingTransactionsByAddress", "parameters": [ { "description": "An account public key", "in": "path", "name": "address", "required": true, "schema": { "pattern": "[A-Z0-9]{58}", "type": "string" } }, { "description": "Truncated number of transactions to display. If max=0, returns all pending txns.", "in": "query", "name": "max", "schema": { "type": "integer" } }, { "description": "Configures whether the response object is JSON or MessagePack encoded.", "in": "query", "name": "format", "schema": { "enum": [ "json", "msgpack" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "description": "PendingTransactions is an array of signed transactions exactly as they were submitted.", "properties": { "top-transactions": { "description": "An array of signed transaction objects.", "items": { "properties": {}, "type": "object", "x-algorand-format": "SignedTransaction" }, "type": "array" }, "total-transactions": { "description": "Total number of transactions in the pool.", "type": "integer" } }, "required": [ "top-transactions", "total-transactions" ], "type": "object" } }, "application/msgpack": { "schema": { "description": "PendingTransactions is an array of signed transactions exactly as they were submitted.", "properties": { "top-transactions": { "description": "An array of signed transaction objects.", "items": { "properties": {}, "type": "object", "x-algorand-format": "SignedTransaction" }, "type": "array" }, "total-transactions": { "description": "Total number of transactions in the pool.", "type": "integer" } }, "required": [ "top-transactions", "total-transactions" ], "type": "object" } } }, "description": "A potentially truncated list of transactions currently in the node's transaction pool. You can compute whether or not the list is truncated if the number of elements in the **top-transactions** array is fewer than **total-transactions**." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Max must be a non-negative integer" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Temporarily Unavailable" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get a list of unconfirmed transactions currently in the transaction pool by address." } }, "/v2/applications/{application-id}": { "get": { "description": "Given a application ID, it returns application information including creator, approval and clear programs, global and local schemas, and global state.", "operationId": "GetApplicationByID", "parameters": [ { "description": "An application identifier", "in": "path", "name": "application-id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application" } } }, "description": "Application information" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Application Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get application information." } }, "/v2/assets/{asset-id}": { "get": { "description": "Given a asset ID, it returns asset information including creator, name, total supply and special addresses.", "operationId": "GetAssetByID", "parameters": [ { "description": "An asset identifier", "in": "path", "name": "asset-id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Asset" } } }, "description": "Asset information" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Application Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get asset information." } }, "/v2/blocks/{round}": { "get": { "operationId": "GetBlock", "parameters": [ { "description": "Configures whether the response object is JSON or MessagePack encoded.", "in": "query", "name": "format", "schema": { "enum": [ "json", "msgpack" ], "type": "string" } }, { "description": "The round from which to fetch block information.", "in": "path", "name": "round", "required": true, "schema": { "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "block": { "description": "Block header data.", "properties": {}, "type": "object", "x-algorand-format": "BlockHeader" }, "cert": { "description": "Optional certificate object. This is only included when the format is set to message pack.", "properties": {}, "type": "object", "x-algorand-format": "BlockCertificate" } }, "required": [ "block" ], "type": "object" } }, "application/msgpack": { "schema": { "properties": { "block": { "description": "Block header data.", "properties": {}, "type": "object", "x-algorand-format": "BlockHeader" }, "cert": { "description": "Optional certificate object. This is only included when the format is set to message pack.", "properties": {}, "type": "object", "x-algorand-format": "BlockCertificate" } }, "required": [ "block" ], "type": "object" } } }, "description": "Encoded block object." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request - Non integer number" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "None existing block " }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get the block for the given round." } }, "/v2/blocks/{round}/transactions/{txid}/proof": { "get": { "operationId": "GetProof", "parameters": [ { "description": "The round in which the transaction appears.", "in": "path", "name": "round", "required": true, "schema": { "type": "integer" } }, { "description": "The transaction ID for which to generate a proof.", "in": "path", "name": "txid", "required": true, "schema": { "pattern": "[A-Z0-9]+", "type": "string" } }, { "description": "The type of hash function used to create the proof, must be one of: \n* sha512_256 \n* sha256", "in": "query", "name": "hashtype", "schema": { "enum": [ "sha512_256", "sha256" ], "type": "string" } }, { "description": "Configures whether the response object is JSON or MessagePack encoded.", "in": "query", "name": "format", "schema": { "enum": [ "json", "msgpack" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "hashtype": { "description": "The type of hash function used to create the proof, must be one of: \n* sha512_256 \n* sha256", "enum": [ "sha512_256", "sha256" ], "type": "string" }, "idx": { "description": "Index of the transaction in the block's payset.", "type": "integer" }, "proof": { "description": "Merkle proof of transaction membership.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "stibhash": { "description": "Hash of SignedTxnInBlock for verifying proof.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "treedepth": { "description": "Represents the depth of the tree that is being proven, i.e. the number of edges from a leaf to the root.", "type": "integer" } }, "required": [ "hashtype", "idx", "proof", "stibhash", "treedepth" ], "type": "object" } } }, "description": "Proof of transaction in a block." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Malformed round number or transaction ID" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Non-existent block or transaction" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal error, including protocol not supporting Merkle proofs." }, "default": { "content": {}, "description": "Unknown error" } }, "summary": "Get a Merkle proof for a transaction in a block." } }, "/v2/catchup/{catchpoint}": { "delete": { "description": "Given a catchpoint, it aborts catching up to this catchpoint", "operationId": "AbortCatchup", "parameters": [ { "description": "A catch point", "in": "path", "name": "catchpoint", "required": true, "schema": { "format": "catchpoint", "pattern": "[0-9]{1,10}#[A-Z0-9]{1,53}", "type": "string", "x-algorand-format": "Catchpoint String" }, "x-algorand-format": "Catchpoint String" } ], "responses": { "200": { "content": { "application/json": { "schema": { "description": "An catchpoint abort response.", "properties": { "catchup-message": { "description": "Catchup abort response string", "type": "string" } }, "required": [ "catchup-message" ], "type": "object" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Aborts a catchpoint catchup.", "tags": [ "private" ] }, "post": { "description": "Given a catchpoint, it starts catching up to this catchpoint", "operationId": "StartCatchup", "parameters": [ { "description": "A catch point", "in": "path", "name": "catchpoint", "required": true, "schema": { "format": "catchpoint", "pattern": "[0-9]{1,10}#[A-Z0-9]{1,53}", "type": "string", "x-algorand-format": "Catchpoint String" }, "x-algorand-format": "Catchpoint String" } ], "responses": { "200": { "content": { "application/json": { "schema": { "description": "An catchpoint start response.", "properties": { "catchup-message": { "description": "Catchup start response string", "type": "string" } }, "required": [ "catchup-message" ], "type": "object" } } } }, "201": { "content": { "application/json": { "schema": { "description": "An catchpoint start response.", "properties": { "catchup-message": { "description": "Catchup start response string", "type": "string" } }, "required": [ "catchup-message" ], "type": "object" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Starts a catchpoint catchup.", "tags": [ "private" ] } }, "/v2/ledger/supply": { "get": { "operationId": "GetSupply", "responses": { "200": { "content": { "application/json": { "schema": { "description": "Supply represents the current supply of MicroAlgos in the system", "properties": { "current_round": { "description": "Round", "type": "integer" }, "online-money": { "description": "OnlineMoney", "type": "integer" }, "total-money": { "description": "TotalMoney", "type": "integer" } }, "required": [ "current_round", "online-money", "total-money" ], "type": "object" } } }, "description": "Supply represents the current supply of MicroAlgos in the system." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get the current supply reported by the ledger." } }, "/v2/participation": { "get": { "description": "Return a list of participation keys", "operationId": "GetParticipationKeys", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ParticipationKey" }, "type": "array" } } }, "description": "A list of participation keys" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Participation Key Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Return a list of participation keys", "tags": [ "private" ] }, "post": { "operationId": "AddParticipationKey", "requestBody": { "content": { "application/msgpack": { "schema": { "format": "binary", "type": "string" } } }, "description": "The participation key to add to the node", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "partId": { "description": "encoding of the participation ID.", "type": "string" } }, "required": [ "partId" ], "type": "object" } } }, "description": "Participation ID of the submission" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Participation Key Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Temporarily Unavailable" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Add a participation key to the node", "tags": [ "private" ], "x-codegen-request-body-name": "participationkey" } }, "/v2/participation/{participation-id}": { "delete": { "description": "Delete a given participation key by ID", "operationId": "DeleteParticipationKeyByID", "parameters": [ { "in": "path", "name": "participation-id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": {}, "description": "Participation key got deleted by ID" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Participation Key Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Delete a given participation key by ID", "tags": [ "private" ] }, "get": { "description": "Given a participation ID, return information about that participation key", "operationId": "GetParticipationKeyByID", "parameters": [ { "in": "path", "name": "participation-id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ParticipationKey" } } }, "description": "A detailed description of a participation ID" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Participation Key Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get participation key info given a participation ID", "tags": [ "private" ] }, "post": { "description": "Given a participation ID, append state proof keys to a particular set of participation keys", "operationId": "AppendKeys", "parameters": [ { "in": "path", "name": "participation-id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/msgpack": { "schema": { "format": "binary", "type": "string" } } }, "description": "The state proof keys to add to an existing participation ID", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ParticipationKey" } } }, "description": "A detailed description of a participation ID" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Participation Key Not Found" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Append state proof keys to a participation key", "tags": [ "private" ], "x-codegen-request-body-name": "keymap" } }, "/v2/shutdown": { "post": { "description": "Special management endpoint to shutdown the node. Optionally provide a timeout parameter to indicate that the node should begin shutting down after a number of seconds.", "operationId": "ShutdownNode", "parameters": [ { "in": "query", "name": "timeout", "schema": { "default": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } } } }, "tags": [ "private" ] } }, "/v2/status": { "get": { "operationId": "GetStatus", "responses": { "200": { "content": { "application/json": { "schema": { "description": "NodeStatus contains the information about a node status", "properties": { "catchpoint": { "description": "The current catchpoint that is being caught up to", "type": "string" }, "catchpoint-acquired-blocks": { "description": "The number of blocks that have already been obtained by the node as part of the catchup", "type": "integer" }, "catchpoint-processed-accounts": { "description": "The number of accounts from the current catchpoint that have been processed so far as part of the catchup", "type": "integer" }, "catchpoint-total-accounts": { "description": "The total number of accounts included in the current catchpoint", "type": "integer" }, "catchpoint-total-blocks": { "description": "The total number of blocks that are required to complete the current catchpoint catchup", "type": "integer" }, "catchpoint-verified-accounts": { "description": "The number of accounts from the current catchpoint that have been verified so far as part of the catchup", "type": "integer" }, "catchup-time": { "description": "CatchupTime in nanoseconds", "type": "integer" }, "last-catchpoint": { "description": "The last catchpoint seen by the node", "type": "string" }, "last-round": { "description": "LastRound indicates the last round seen", "type": "integer" }, "last-version": { "description": "LastVersion indicates the last consensus version supported", "type": "string" }, "next-version": { "description": "NextVersion of consensus protocol to use", "type": "string" }, "next-version-round": { "description": "NextVersionRound is the round at which the next consensus version will apply", "type": "integer" }, "next-version-supported": { "description": "NextVersionSupported indicates whether the next consensus version is supported by this node", "type": "boolean" }, "stopped-at-unsupported-round": { "description": "StoppedAtUnsupportedRound indicates that the node does not support the new rounds and has stopped making progress", "type": "boolean" }, "time-since-last-round": { "description": "TimeSinceLastRound in nanoseconds", "type": "integer" } }, "required": [ "catchup-time", "last-round", "last-version", "next-version", "next-version-round", "next-version-supported", "stopped-at-unsupported-round", "time-since-last-round" ], "type": "object" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "type": "string" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Gets the current node status." } }, "/v2/status/wait-for-block-after/{round}": { "get": { "description": "Waits for a block to appear after round {round} and returns the node's status at the time.", "operationId": "WaitForBlock", "parameters": [ { "description": "The round to wait until returning status", "in": "path", "name": "round", "required": true, "schema": { "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "description": "NodeStatus contains the information about a node status", "properties": { "catchpoint": { "description": "The current catchpoint that is being caught up to", "type": "string" }, "catchpoint-acquired-blocks": { "description": "The number of blocks that have already been obtained by the node as part of the catchup", "type": "integer" }, "catchpoint-processed-accounts": { "description": "The number of accounts from the current catchpoint that have been processed so far as part of the catchup", "type": "integer" }, "catchpoint-total-accounts": { "description": "The total number of accounts included in the current catchpoint", "type": "integer" }, "catchpoint-total-blocks": { "description": "The total number of blocks that are required to complete the current catchpoint catchup", "type": "integer" }, "catchpoint-verified-accounts": { "description": "The number of accounts from the current catchpoint that have been verified so far as part of the catchup", "type": "integer" }, "catchup-time": { "description": "CatchupTime in nanoseconds", "type": "integer" }, "last-catchpoint": { "description": "The last catchpoint seen by the node", "type": "string" }, "last-round": { "description": "LastRound indicates the last round seen", "type": "integer" }, "last-version": { "description": "LastVersion indicates the last consensus version supported", "type": "string" }, "next-version": { "description": "NextVersion of consensus protocol to use", "type": "string" }, "next-version-round": { "description": "NextVersionRound is the round at which the next consensus version will apply", "type": "integer" }, "next-version-supported": { "description": "NextVersionSupported indicates whether the next consensus version is supported by this node", "type": "boolean" }, "stopped-at-unsupported-round": { "description": "StoppedAtUnsupportedRound indicates that the node does not support the new rounds and has stopped making progress", "type": "boolean" }, "time-since-last-round": { "description": "TimeSinceLastRound in nanoseconds", "type": "integer" } }, "required": [ "catchup-time", "last-round", "last-version", "next-version", "next-version-round", "next-version-supported", "stopped-at-unsupported-round", "time-since-last-round" ], "type": "object" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request -- number must be non-negative integer " }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Temporarily Unavailable" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Gets the node status after waiting for the given round." } }, "/v2/teal/compile": { "post": { "description": "Given TEAL source code in plain text, return base64 encoded program bytes and base32 SHA512_256 hash of program bytes (Address style). This endpoint is only enabled when a node's configuration file sets EnableDeveloperAPI to true.", "operationId": "TealCompile", "parameters": [ { "description": "When set to `true`, returns the source map of the program as a JSON. Defaults to `false`.", "in": "query", "name": "sourcemap", "schema": { "type": "boolean" } } ], "requestBody": { "content": { "text/plain": { "schema": { "format": "binary", "type": "string" } } }, "description": "TEAL source code to be compiled", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "hash": { "description": "base32 SHA512_256 of program bytes (Address style)", "type": "string" }, "result": { "description": "base64 encoded program bytes", "type": "string" }, "sourcemap": { "description": "JSON of the source map", "properties": {}, "type": "object" } }, "required": [ "hash", "result" ], "type": "object" } } }, "description": "Teal compile Result" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request - Teal Compile Error" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": {}, "description": "Developer API not enabled" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Compile TEAL source code to binary, produce its hash", "x-codegen-request-body-name": "source" } }, "/v2/teal/disassemble": { "post": { "description": "Given the program bytes, return the TEAL source code in plain text. This endpoint is only enabled when a node's configuration file sets EnableDeveloperAPI to true.", "operationId": "TealDisassemble", "requestBody": { "content": { "application/x-binary": { "schema": { "format": "byte", "type": "string" } } }, "description": "TEAL program binary to be disassembled", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "result": { "description": "disassembled Teal code", "type": "string" } }, "required": [ "result" ], "type": "object" } } }, "description": "Teal disassembly Result" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request - Teal Compile Error" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": {}, "description": "Developer API not enabled" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Disassemble program bytes into the TEAL source code.", "x-codegen-request-body-name": "source" } }, "/v2/teal/dryrun": { "post": { "description": "Executes TEAL program(s) in context and returns debugging information about the execution. This endpoint is only enabled when a node's configuration file sets EnableDeveloperAPI to true.", "operationId": "TealDryrun", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DryrunRequest" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/DryrunRequest" } } }, "description": "Transaction (or group) and any accompanying state-simulation data.", "required": false }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" }, "protocol-version": { "description": "Protocol version is the protocol version Dryrun was operated under.", "type": "string" }, "txns": { "items": { "$ref": "#/components/schemas/DryrunTxnResult" }, "type": "array" } }, "required": [ "error", "protocol-version", "txns" ], "type": "object" } } }, "description": "DryrunResponse contains per-txn debug information from a dryrun." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": {}, "description": "Developer API not enabled" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Provide debugging information for a transaction (or group).", "x-codegen-request-body-name": "request" } }, "/v2/transactions": { "post": { "operationId": "RawTransaction", "requestBody": { "content": { "application/x-binary": { "schema": { "format": "binary", "type": "string" } } }, "description": "The byte encoded signed transaction to broadcast to network", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "txId": { "description": "encoding of the transaction hash.", "type": "string" } }, "required": [ "txId" ], "type": "object" } } }, "description": "Transaction ID of the submission." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request - Malformed Algorand transaction " }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Temporarily Unavailable" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Broadcasts a raw transaction to the network.", "x-codegen-request-body-name": "rawtxn" } }, "/v2/transactions/params": { "get": { "operationId": "TransactionParams", "responses": { "200": { "content": { "application/json": { "schema": { "description": "TransactionParams contains the parameters that help a client construct\na new transaction.", "properties": { "consensus-version": { "description": "ConsensusVersion indicates the consensus protocol version\nas of LastRound.", "type": "string" }, "fee": { "description": "Fee is the suggested transaction fee\nFee is in units of micro-Algos per byte.\nFee may fall to zero but transactions must still have a fee of\nat least MinTxnFee for the current network protocol.", "type": "integer" }, "genesis-hash": { "description": "GenesisHash is the hash of the genesis block.", "format": "byte", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "type": "string" }, "genesis-id": { "description": "GenesisID is an ID listed in the genesis block.", "type": "string" }, "last-round": { "description": "LastRound indicates the last round seen", "type": "integer" }, "min-fee": { "description": "The minimum transaction fee (not per byte) required for the\ntxn to validate for the current network protocol.", "type": "integer" } }, "required": [ "consensus-version", "fee", "genesis-hash", "genesis-id", "last-round", "min-fee" ], "type": "object", "x-go-package": "github.com/algorand/go-algorand/daemon/algod/api/spec/v1" } } }, "description": "TransactionParams contains the parameters that help a client construct a new transaction." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Temporarily Unavailable" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get parameters for constructing a new transaction" } }, "/v2/transactions/pending": { "get": { "description": "Get the list of pending transactions, sorted by priority, in decreasing order, truncated at the end at MAX. If MAX = 0, returns all pending transactions.\n", "operationId": "GetPendingTransactions", "parameters": [ { "description": "Truncated number of transactions to display. If max=0, returns all pending txns.", "in": "query", "name": "max", "schema": { "type": "integer" } }, { "description": "Configures whether the response object is JSON or MessagePack encoded.", "in": "query", "name": "format", "schema": { "enum": [ "json", "msgpack" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "description": "PendingTransactions is an array of signed transactions exactly as they were submitted.", "properties": { "top-transactions": { "description": "An array of signed transaction objects.", "items": { "properties": {}, "type": "object", "x-algorand-format": "SignedTransaction" }, "type": "array" }, "total-transactions": { "description": "Total number of transactions in the pool.", "type": "integer" } }, "required": [ "top-transactions", "total-transactions" ], "type": "object" } }, "application/msgpack": { "schema": { "description": "PendingTransactions is an array of signed transactions exactly as they were submitted.", "properties": { "top-transactions": { "description": "An array of signed transaction objects.", "items": { "properties": {}, "type": "object", "x-algorand-format": "SignedTransaction" }, "type": "array" }, "total-transactions": { "description": "Total number of transactions in the pool.", "type": "integer" } }, "required": [ "top-transactions", "total-transactions" ], "type": "object" } } }, "description": "A potentially truncated list of transactions currently in the node's transaction pool. You can compute whether or not the list is truncated if the number of elements in the **top-transactions** array is fewer than **total-transactions**." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Service Temporarily Unavailable" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get a list of unconfirmed transactions currently in the transaction pool." } }, "/v2/transactions/pending/{txid}": { "get": { "description": "Given a transaction ID of a recently submitted transaction, it returns information about it. There are several cases when this might succeed:\n- transaction committed (committed round > 0)\n- transaction still in the pool (committed round = 0, pool error = \"\")\n- transaction removed from pool due to error (committed round = 0, pool error != \"\")\nOr the transaction may have happened sufficiently long ago that the node no longer remembers it, and this will return an error.\n", "operationId": "PendingTransactionInformation", "parameters": [ { "description": "A transaction ID", "in": "path", "name": "txid", "required": true, "schema": { "pattern": "[A-Z0-9]+", "type": "string" } }, { "description": "Configures whether the response object is JSON or MessagePack encoded.", "in": "query", "name": "format", "schema": { "enum": [ "json", "msgpack" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PendingTransactionResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/PendingTransactionResponse" } } }, "description": "Given a transaction ID of a recently submitted transaction, it returns information about it. There are several cases when this might succeed:\n- transaction committed (committed round > 0)\n- transaction still in the pool (committed round = 0, pool error = \"\")\n- transaction removed from pool due to error (committed round = 0, pool error != \"\")\n\nOr the transaction may have happened sufficiently long ago that the node no longer remembers it, and this will return an error." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid API Token" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/msgpack": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Transaction Not Found" }, "default": { "content": {}, "description": "Unknown Error" } }, "summary": "Get a specific pending transaction." } }, "/versions": { "get": { "description": "Retrieves the supported API versions, binary build versions, and genesis information.", "operationId": "GetVersion", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Version" } } }, "description": "VersionsResponse is the response to 'GET /versions'" } }, "tags": [ "common" ] } } }, "security": [ { "api_key": [] } ], "servers": [ { "url": "http://localhost/" }, { "url": "https://localhost/" } ], "tags": [ { "name": "private" } ] }