Blocks

Lookup block.

GEThttps://algo-index.nownodes.io/v2/blocks/{round-number}

Path parameters

round-number*integer

Round number

Query parameters

Response

200404500

(empty)

Body

application/json

genesis-hash*string (byte)

\[gh\] hash to which this block belongs.

Pattern: ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$

genesis-id*string

\[gen\] ID to which this block belongs.

participation-updatesobject

Participation account data that needs to be checked/acted on by the network.

previous-block-hash*string (byte)

\[prev\] Previous block hash.

Pattern: ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$

rewardsobject

Fields relating to rewards,

round*integer

\[rnd\] Current round on which this block was appended to the chain.

seed*string (byte)

\[seed\] Sortition seed.

Pattern: ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$

state-proof-trackingarray of object

Tracks the status of state proofs.

timestamp*integer

\[ts\] Block creation timestamp in seconds since eposh

transactionsarray of object

\[txns\] list of transactions corresponding to a given round.

transactions-root*string (byte)

\[txn\] TransactionsRoot authenticates the set of transactions appearing in the block. More specifically, it's the root of a merkle tree whose leaves are the block's Txids, in lexicographic order. For the empty block, it's 0. Note that the TxnRoot does not authenticate the signatures on the transactions, only the transactions themselves. Two blocks with the same transactions but in a different order and with different signatures will have the same TxnRoot.

Pattern: ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$

transactions-root-sha256*string (byte)

\[txn256\] TransactionsRootSHA256 is an auxiliary TransactionRoot, built using a vector commitment instead of a merkle tree, and SHA256 hash function instead of the default SHA512_256. This commitment can be used on environments where only the SHA256 function exists.

Pattern: ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$

txn-counterinteger

\[tc\] TxnCounter counts the number of transactions committed in the ledger, from the time at which support for this feature was introduced. Specifically, TxnCounter is the number of the next transaction that will be committed after this block. It is 0 when no transactions have ever been committed (since TxnCounter started being supported).

upgrade-stateobject

Fields relating to a protocol upgrade.

upgrade-voteobject

Fields relating to voting for a protocol upgrade.

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://algo-index.nownodes.io/v2/blocks/{round-number}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200404500

{
  "genesis-hash": "Ynl0ZXM=",
  "genesis-id": "text",
  "participation-updates": {
    "expired-participation-accounts": [
      "text"
    ]
  },
  "previous-block-hash": "Ynl0ZXM=",
  "rewards": {
    "fee-sink": "text",
    "rewards-calculation-round": 0,
    "rewards-level": 0,
    "rewards-pool": "text",
    "rewards-rate": 0,
    "rewards-residue": 0
  },
  "round": 0,
  "seed": "Ynl0ZXM=",
  "state-proof-tracking": [
    {
      "next-round": 0,
      "online-total-weight": 0,
      "type": 0,
      "voters-commitment": "Ynl0ZXM="
    }
  ],
  "timestamp": 0,
  "transactions": [
    {
      "application-transaction": {
        "accounts": [
          "text"
        ],
        "application-args": [
          "text"
        ],
        "application-id": 0,
        "approval-program": "Ynl0ZXM=",
        "clear-state-program": "Ynl0ZXM=",
        "extra-program-pages": 0,
        "foreign-apps": [
          0
        ],
        "foreign-assets": [
          0
        ],
        "global-state-schema": {
          "num-byte-slice": 0,
          "num-uint": 0
        },
        "local-state-schema": {
          "num-byte-slice": 0,
          "num-uint": 0
        },
        "on-completion": "noop"
      },
      "asset-config-transaction": {
        "asset-id": 0,
        "params": {
          "clawback": "text",
          "creator": "text",
          "decimals": 0,
          "default-frozen": false,
          "freeze": "text",
          "manager": "text",
          "metadata-hash": "Ynl0ZXM=",
          "name": "text",
          "name-b64": "Ynl0ZXM=",
          "reserve": "text",
          "total": 0,
          "unit-name": "text",
          "unit-name-b64": "Ynl0ZXM=",
          "url": "text",
          "url-b64": "Ynl0ZXM="
        }
      },
      "asset-freeze-transaction": {
        "address": "text",
        "asset-id": 0,
        "new-freeze-status": false
      },
      "asset-transfer-transaction": {
        "amount": 0,
        "asset-id": 0,
        "close-amount": 0,
        "close-to": "text",
        "receiver": "text",
        "sender": "text"
      },
      "auth-addr": "text",
      "close-rewards": 0,
      "closing-amount": 0,
      "confirmed-round": 0,
      "created-application-index": 0,
      "created-asset-index": 0,
      "fee": 0,
      "first-valid": 0,
      "genesis-hash": "Ynl0ZXM=",
      "genesis-id": "text",
      "global-state-delta": [
        {
          "key": "text",
          "value": {
            "action": 0,
            "bytes": "text",
            "uint": 0
          }
        }
      ],
      "group": "Ynl0ZXM=",
      "id": "text",
      "inner-txns": [
        {
          "application-transaction": {
            "accounts": [
              "text"
            ],
            "application-args": [
              "text"
            ],
            "application-id": 0,
            "approval-program": "Ynl0ZXM=",
            "clear-state-program": "Ynl0ZXM=",
            "extra-program-pages": 0,
            "foreign-apps": [
              0
            ],
            "foreign-assets": [
              0
            ],
            "global-state-schema": {
              "num-byte-slice": 0,
              "num-uint": 0
            },
            "local-state-schema": {
              "num-byte-slice": 0,
              "num-uint": 0
            },
            "on-completion": "noop"
          },
          "asset-config-transaction": {
            "asset-id": 0,
            "params": {
              "clawback": "text",
              "creator": "text",
              "decimals": 0,
              "default-frozen": false,
              "freeze": "text",
              "manager": "text",
              "metadata-hash": "Ynl0ZXM=",
              "name": "text",
              "name-b64": "Ynl0ZXM=",
              "reserve": "text",
              "total": 0,
              "unit-name": "text",
              "unit-name-b64": "Ynl0ZXM=",
              "url": "text",
              "url-b64": "Ynl0ZXM="
            }
          },
          "asset-freeze-transaction": {
            "address": "text",
            "asset-id": 0,
            "new-freeze-status": false
          },
          "asset-transfer-transaction": {
            "amount": 0,
            "asset-id": 0,
            "close-amount": 0,
            "close-to": "text",
            "receiver": "text",
            "sender": "text"
          },
          "auth-addr": "text",
          "close-rewards": 0,
          "closing-amount": 0,
          "confirmed-round": 0,
          "created-application-index": 0,
          "created-asset-index": 0,
          "fee": 0,
          "first-valid": 0,
          "genesis-hash": "Ynl0ZXM=",
          "genesis-id": "text",
          "global-state-delta": [
            {
              "key": "text",
              "value": {
                "action": 0,
                "bytes": "text",
                "uint": 0
              }
            }
          ],
          "group": "Ynl0ZXM=",
          "id": "text",
          "intra-round-offset": 0,
          "keyreg-transaction": {
            "non-participation": false,
            "selection-participation-key": "Ynl0ZXM=",
            "state-proof-key": "Ynl0ZXM=",
            "vote-first-valid": 0,
            "vote-key-dilution": 0,
            "vote-last-valid": 0,
            "vote-participation-key": "Ynl0ZXM="
          },
          "last-valid": 0,
          "lease": "Ynl0ZXM=",
          "local-state-delta": [
            {
              "address": "text",
              "delta": [
                {
                  "key": "text",
                  "value": {
                    "action": 0,
                    "bytes": "text",
                    "uint": 0
                  }
                }
              ]
            }
          ],
          "logs": [
            "Ynl0ZXM="
          ],
          "note": "Ynl0ZXM=",
          "payment-transaction": {
            "amount": 0,
            "close-amount": 0,
            "close-remainder-to": "text",
            "receiver": "text"
          },
          "receiver-rewards": 0,
          "rekey-to": "text",
          "round-time": 0,
          "sender": "text",
          "sender-rewards": 0,
          "signature": {
            "logicsig": {
              "args": [
                "text"
              ],
              "logic": "Ynl0ZXM=",
              "multisig-signature": {
                "subsignature": [
                  {
                    "public-key": "Ynl0ZXM=",
                    "signature": "Ynl0ZXM="
                  }
                ],
                "threshold": 0,
                "version": 0
              },
              "signature": "Ynl0ZXM="
            },
            "multisig": {
              "subsignature": [
                {
                  "public-key": "Ynl0ZXM=",
                  "signature": "Ynl0ZXM="
                }
              ],
              "threshold": 0,
              "version": 0
            },
            "sig": "Ynl0ZXM="
          },
          "state-proof-transaction": {
            "message": {
              "block-headers-commitment": "Ynl0ZXM=",
              "first-attested-round": 0,
              "latest-attested-round": 0,
              "ln-proven-weight": 0,
              "voters-commitment": "Ynl0ZXM="
            },
            "state-proof": {
              "part-proofs": {
                "hash-factory": {
                  "hash-type": 0
                },
                "path": [
                  "Ynl0ZXM="
                ],
                "tree-depth": 0
              },
              "positions-to-reveal": [
                0
              ],
              "reveals": [
                {
                  "participant": {
                    "verifier": {
                      "commitment": "Ynl0ZXM=",
                      "key-lifetime": 0
                    },
                    "weight": 0
                  },
                  "position": 0,
                  "sig-slot": {
                    "lower-sig-weight": 0,
                    "signature": {
                      "falcon-signature": "Ynl0ZXM=",
                      "merkle-array-index": 0,
                      "proof": {
                        "hash-factory": {
                          "hash-type": 0
                        },
                        "path": [
                          "Ynl0ZXM="
                        ],
                        "tree-depth": 0
                      },
                      "verifying-key": "Ynl0ZXM="
                    }
                  }
                }
              ],
              "salt-version": 0,
              "sig-commit": "Ynl0ZXM=",
              "sig-proofs": {
                "hash-factory": {
                  "hash-type": 0
                },
                "path": [
                  "Ynl0ZXM="
                ],
                "tree-depth": 0
              },
              "signed-weight": 0
            },
            "state-proof-type": 0
          },
          "tx-type": "pay"
        }
      ],
      "intra-round-offset": 0,
      "keyreg-transaction": {
        "non-participation": false,
        "selection-participation-key": "Ynl0ZXM=",
        "state-proof-key": "Ynl0ZXM=",
        "vote-first-valid": 0,
        "vote-key-dilution": 0,
        "vote-last-valid": 0,
        "vote-participation-key": "Ynl0ZXM="
      },
      "last-valid": 0,
      "lease": "Ynl0ZXM=",
      "local-state-delta": [
        {
          "address": "text",
          "delta": [
            {
              "key": "text",
              "value": {
                "action": 0,
                "bytes": "text",
                "uint": 0
              }
            }
          ]
        }
      ],
      "logs": [
        "Ynl0ZXM="
      ],
      "note": "Ynl0ZXM=",
      "payment-transaction": {
        "amount": 0,
        "close-amount": 0,
        "close-remainder-to": "text",
        "receiver": "text"
      },
      "receiver-rewards": 0,
      "rekey-to": "text",
      "round-time": 0,
      "sender": "text",
      "sender-rewards": 0,
      "signature": {
        "logicsig": {
          "args": [
            "text"
          ],
          "logic": "Ynl0ZXM=",
          "multisig-signature": {
            "subsignature": [
              {
                "public-key": "Ynl0ZXM=",
                "signature": "Ynl0ZXM="
              }
            ],
            "threshold": 0,
            "version": 0
          },
          "signature": "Ynl0ZXM="
        },
        "multisig": {
          "subsignature": [
            {
              "public-key": "Ynl0ZXM=",
              "signature": "Ynl0ZXM="
            }
          ],
          "threshold": 0,
          "version": 0
        },
        "sig": "Ynl0ZXM="
      },
      "state-proof-transaction": {
        "message": {
          "block-headers-commitment": "Ynl0ZXM=",
          "first-attested-round": 0,
          "latest-attested-round": 0,
          "ln-proven-weight": 0,
          "voters-commitment": "Ynl0ZXM="
        },
        "state-proof": {
          "part-proofs": {
            "hash-factory": {
              "hash-type": 0
            },
            "path": [
              "Ynl0ZXM="
            ],
            "tree-depth": 0
          },
          "positions-to-reveal": [
            0
          ],
          "reveals": [
            {
              "participant": {
                "verifier": {
                  "commitment": "Ynl0ZXM=",
                  "key-lifetime": 0
                },
                "weight": 0
              },
              "position": 0,
              "sig-slot": {
                "lower-sig-weight": 0,
                "signature": {
                  "falcon-signature": "Ynl0ZXM=",
                  "merkle-array-index": 0,
                  "proof": {
                    "hash-factory": {
                      "hash-type": 0
                    },
                    "path": [
                      "Ynl0ZXM="
                    ],
                    "tree-depth": 0
                  },
                  "verifying-key": "Ynl0ZXM="
                }
              }
            }
          ],
          "salt-version": 0,
          "sig-commit": "Ynl0ZXM=",
          "sig-proofs": {
            "hash-factory": {
              "hash-type": 0
            },
            "path": [
              "Ynl0ZXM="
            ],
            "tree-depth": 0
          },
          "signed-weight": 0
        },
        "state-proof-type": 0
      },
      "tx-type": "pay"
    }
  ],
  "transactions-root": "Ynl0ZXM=",
  "transactions-root-sha256": "Ynl0ZXM=",
  "txn-counter": 0,
  "upgrade-state": {
    "current-protocol": "text",
    "next-protocol": "text",
    "next-protocol-approvals": 0,
    "next-protocol-switch-on": 0,
    "next-protocol-vote-before": 0
  },
  "upgrade-vote": {
    "upgrade-approve": false,
    "upgrade-delay": 0,
    "upgrade-propose": "text"
  }
}