Indexer 3.9.0 to 3.10.0 API CHANGES

v1.0.0

Base URL

https://algo-index.nownodes.io

This page lists what changed in the Indexer API between versions 3.9.0 and 3.10.0. Only added and changed methods are listed. Everything not mentioned here works exactly as described in the main Indexer reference. No method was removed in this release.

Added

GET /v2/applications/{application-id}/boxes — new optional query parameter include. Pass include=values to get the content of every box in the same response.

Changed

GET /v2/applications/{application-id}/boxes — the response now also carries round, and every entry of boxes may carry value.
GET /v2/blocks/{round-number} — the block may now carry congestion-tax and load.
GET /v2/transactions, GET /v2/transactions/{txid}, GET /v2/accounts/{account-id}/transactions, GET /v2/assets/{asset-id}/transactions — a transaction signature may now be a post-quantum signature: signature.pqsig and signature.logicsig.pqsig.
GET /v2/accounts, GET /v2/accounts/{account-id} — the sig-type field of an account may now be pqsig. The sig-type filter of the transaction search methods accepts the same new value.
The heartbeat transaction object gained the hb-challenge-discount field.

About consensus version v42

Indexer 3.10.0 is the release that understands consensus version v42 (post-quantum Falcon-1024 signatures, block load tracking). Mainnet upgrades to v42 at round 64318659. Everything v42 brings — congestion-tax, load, pqsig, hb-challenge-discount — starts appearing in responses only after that round. The new include parameter of the box search and the round field of its response work right away, they do not depend on the upgrade.

Indexer 3.10.0 must be run together with node 5.0.0 and Conduit 1.10.0.

Authentication

api-keyAuthapiKey

API Key: api-key in header

Changelog indexer 3.9.0 to 3.10.0

Accounts

GET

https://algo-index.nownodes.io/v2/accounts

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed in 3.10.0. The sig-type field of an account may now be pqsig. Returned only from consensus version v42 onwards. Mainnet upgrades to v42 at round 64318659, until then the field is never returned.

Search for accounts.

Parameters

asset-idintegerquery

Asset ID

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

currency-greater-thanintegerquery

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.

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

excludeArray<string>allassetscreated-assetsapps-local-statecreated-appsnonequery

Exclude additional items such as asset holdings, application local data stored for this account, asset parameters created by this account, and application parameters created by this account.

currency-less-thanintegerquery

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.

auth-addrstringquery

Include accounts configured to use this spending key.

roundintegerquery

Include results for the specified round. For performance reasons, this parameter may be disabled on some configurations. Using application-id or asset-id filters will return both creator and opt-in accounts. Filtering by include-all will return creator and opt-in accounts for deleted assets and accounts. Non-opt-in managers are not included in the results when asset-id is used.

application-idintegerquery

Application ID

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

GET /v2/accounts

curl -X GET 'https://algo-index.nownodes.io/v2/accounts'

const response = await fetch('https://algo-index.nownodes.io/v2/accounts', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/accounts')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://algo-index.nownodes.io/v2/accounts')
data = response.json()

const response = await fetch('https://algo-index.nownodes.io/v2/accounts', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://algo-index.nownodes.io/v2/accounts";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://algo-index.nownodes.io/v2/accounts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://algo-index.nownodes.io/v2/accounts')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/accounts')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "accounts": [
    {
      "address": "string",
      "amount": 0,
      "amount-without-pending-rewards": 0,
      "apps-local-state": [
        {
          "closed-out-at-round": 0,
          "deleted": true,
          "id": 0,
          "key-value": [
            {
              "key": "string",
              "value": {
                "bytes": "string",
                "type": 0,
                "uint": 0
              }
            }
          ],
          "opted-in-at-round": 0,
          "schema": {
            "num-byte-slice": 0,
            "num-uint": 0
          }
        }
      ],
      "apps-total-extra-pages": 0,
      "apps-total-schema": {
        "num-byte-slice": 0,
        "num-uint": 0
      },
      "assets": [
        {
          "amount": 0,
          "asset-id": 0,
          "deleted": true,
          "is-frozen": true,
          "opted-in-at-round": 0,
          "opted-out-at-round": 0
        }
      ],
      "auth-addr": "string",
      "closed-at-round": 0,
      "created-apps": [
        {
          "created-at-round": 0,
          "deleted": true,
          "deleted-at-round": 0,
          "id": 0,
          "params": {
            "approval-program": "dGVzdA==",
            "clear-state-program": "dGVzdA==",
            "creator": "string",
            "extra-program-pages": 0,
            "global-state": [
              {
                "key": "string",
                "value": {
                  "bytes": "string",
                  "type": 0,
                  "uint": 0
                }
              }
            ],
            "global-state-schema": {
              "num-byte-slice": 0,
              "num-uint": 0
            },
            "local-state-schema": {
              "num-byte-slice": 0,
              "num-uint": 0
            }
          }
        }
      ],
      "created-assets": [
        {
          "created-at-round": 0,
          "deleted": true,
          "destroyed-at-round": 0,
          "index": 0,
          "params": {
            "clawback": "string",
            "creator": "string",
            "decimals": 0,
            "default-frozen": true,
            "freeze": "string",
            "manager": "string",
            "metadata-hash": "dGVzdA==",
            "name": "string",
            "name-b64": "dGVzdA==",
            "reserve": "string",
            "total": 0,
            "unit-name": "string",
            "unit-name-b64": "dGVzdA==",
            "url": "string",
            "url-b64": "dGVzdA=="
          }
        }
      ],
      "created-at-round": 0,
      "deleted": true,
      "participation": {
        "selection-participation-key": "dGVzdA==",
        "state-proof-key": "dGVzdA==",
        "vote-first-valid": 0,
        "vote-key-dilution": 0,
        "vote-last-valid": 0,
        "vote-participation-key": "dGVzdA=="
      },
      "pending-rewards": 0,
      "reward-base": 0,
      "rewards": 0,
      "round": 0,
      "sig-type": "sig",
      "status": "string",
      "total-apps-opted-in": 0,
      "total-assets-opted-in": 0,
      "total-box-bytes": 0,
      "total-boxes": 0,
      "total-created-apps": 0,
      "total-created-assets": 0
    }
  ],
  "current-round": 0,
  "next-token": "string"
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

GET

https://algo-index.nownodes.io/v2/accounts/{account-id}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup account information.

Parameters

account-idstringrequiredpath

account string

roundintegerquery

Include results for the specified round.

include-allbooleanquery

Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

excludeArray<string>allassetscreated-assetsapps-local-statecreated-appsnonequery

Exclude additional items such as asset holdings, application local data stored for this account, asset parameters created by this account, and application parameters created by this account.

Response

200OK

(empty)

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET /v2/accounts/{account-id}

curl -X GET 'https://algo-index.nownodes.io/v2/accounts/{account-id}'

const response = await fetch('https://algo-index.nownodes.io/v2/accounts/{account-id}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/accounts/{account-id}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://algo-index.nownodes.io/v2/accounts/{account-id}')
data = response.json()

const response = await fetch('https://algo-index.nownodes.io/v2/accounts/{account-id}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://algo-index.nownodes.io/v2/accounts/{account-id}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://algo-index.nownodes.io/v2/accounts/{account-id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://algo-index.nownodes.io/v2/accounts/{account-id}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/accounts/{account-id}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "account": {
    "address": "string",
    "amount": 0,
    "amount-without-pending-rewards": 0,
    "apps-local-state": [
      {
        "closed-out-at-round": 0,
        "deleted": true,
        "id": 0,
        "key-value": [
          {
            "key": "string",
            "value": {
              "bytes": "string",
              "type": 0,
              "uint": 0
            }
          }
        ],
        "opted-in-at-round": 0,
        "schema": {
          "num-byte-slice": 0,
          "num-uint": 0
        }
      }
    ],
    "apps-total-extra-pages": 0,
    "apps-total-schema": {
      "num-byte-slice": 0,
      "num-uint": 0
    },
    "assets": [
      {
        "amount": 0,
        "asset-id": 0,
        "deleted": true,
        "is-frozen": true,
        "opted-in-at-round": 0,
        "opted-out-at-round": 0
      }
    ],
    "auth-addr": "string",
    "closed-at-round": 0,
    "created-apps": [
      {
        "created-at-round": 0,
        "deleted": true,
        "deleted-at-round": 0,
        "id": 0,
        "params": {
          "approval-program": "dGVzdA==",
          "clear-state-program": "dGVzdA==",
          "creator": "string",
          "extra-program-pages": 0,
          "global-state": [
            {
              "key": "string",
              "value": {
                "bytes": "string",
                "type": 0,
                "uint": 0
              }
            }
          ],
          "global-state-schema": {
            "num-byte-slice": 0,
            "num-uint": 0
          },
          "local-state-schema": {
            "num-byte-slice": 0,
            "num-uint": 0
          }
        }
      }
    ],
    "created-assets": [
      {
        "created-at-round": 0,
        "deleted": true,
        "destroyed-at-round": 0,
        "index": 0,
        "params": {
          "clawback": "string",
          "creator": "string",
          "decimals": 0,
          "default-frozen": true,
          "freeze": "string",
          "manager": "string",
          "metadata-hash": "dGVzdA==",
          "name": "string",
          "name-b64": "dGVzdA==",
          "reserve": "string",
          "total": 0,
          "unit-name": "string",
          "unit-name-b64": "dGVzdA==",
          "url": "string",
          "url-b64": "dGVzdA=="
        }
      }
    ],
    "created-at-round": 0,
    "deleted": true,
    "participation": {
      "selection-participation-key": "dGVzdA==",
      "state-proof-key": "dGVzdA==",
      "vote-first-valid": 0,
      "vote-key-dilution": 0,
      "vote-last-valid": 0,
      "vote-participation-key": "dGVzdA=="
    },
    "pending-rewards": 0,
    "reward-base": 0,
    "rewards": 0,
    "round": 0,
    "sig-type": "sig",
    "status": "string",
    "total-apps-opted-in": 0,
    "total-assets-opted-in": 0,
    "total-box-bytes": 0,
    "total-boxes": 0,
    "total-created-apps": 0,
    "total-created-assets": 0
  },
  "current-round": 0
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

GET

https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed in 3.10.0. A transaction signature may now be a post-quantum signature: signature.pqsig and signature.logicsig.pqsig. Returned only from consensus version v42 onwards. Mainnet upgrades to v42 at round 64318659, until then the field is never returned.

Lookup account transactions. Transactions are returned newest to oldest.

Parameters

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

note-prefixstringquery

Specifies a prefix which must be contained in the note field.

tx-typestringpaykeyregacfgaxferafrzapplstpfquery

sig-typestringsigmsiglsigpqsigquery

SigType filters just results using the specified type of signature:

sig - Standard
msig - MultiSig
lsig - LogicSig
pqsig - Post-Quantum

pqsig was added in 3.10.0.

txidstringquery

Lookup the specific transaction by ID.

roundintegerquery

Include results for the specified round.

min-roundintegerquery

Include results at or after the specified min-round.

max-roundintegerquery

Include results at or before the specified max-round.

asset-idintegerquery

Asset ID

before-timestring<date-time>query

Include results before the given time. Must be an RFC 3339 formatted string.

after-timestring<date-time>query

Include results after the given time. Must be an RFC 3339 formatted string.

currency-greater-thanintegerquery

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.

currency-less-thanintegerquery

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.

account-idstringrequiredpath

account string

rekey-tobooleanquery

Include results which include the rekey-to field.

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

GET /v2/accounts/{account-id}/transactions

curl -X GET 'https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions'

const response = await fetch('https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions')
data = response.json()

const response = await fetch('https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/accounts/{account-id}/transactions')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "current-round": 0,
  "next-token": "string",
  "transactions": []
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

Applications

Get box names for a given application.

GET

https://algo-index.nownodes.io/v2/applications/{application-id}/boxes

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed in 3.10.0. New optional query parameter include: include=values adds the content of every box to the response. The response also carries the new round field, and every entry of boxes carries value when the values were requested. An unknown value of include is ignored, the request still succeeds.

Given an application ID, returns the box names of that application sorted lexicographically.

Parameters

application-idintegerrequiredpath

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

includeArray<string>valuesquery

Include additional items in the response. Use values to include box values. Multiple values can be comma-separated. Added in 3.10.0.

Response

200OK

Box names of an application

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

Get box names for a given application.

curl -X GET 'https://algo-index.nownodes.io/v2/applications/{application-id}/boxes'

const response = await fetch('https://algo-index.nownodes.io/v2/applications/{application-id}/boxes', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/applications/{application-id}/boxes')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://algo-index.nownodes.io/v2/applications/{application-id}/boxes')
data = response.json()

const response = await fetch('https://algo-index.nownodes.io/v2/applications/{application-id}/boxes', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://algo-index.nownodes.io/v2/applications/{application-id}/boxes";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://algo-index.nownodes.io/v2/applications/{application-id}/boxes', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://algo-index.nownodes.io/v2/applications/{application-id}/boxes')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/applications/{application-id}/boxes')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "application-id": 0,
  "boxes": [
    {
      "name": "dGVzdA==",
      "value": "dGVzdA=="
    }
  ],
  "next-token": "string",
  "round": 0
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

Assets

GET

https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup transactions for an asset. Transactions are returned oldest to newest.

Parameters

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

note-prefixstringquery

Specifies a prefix which must be contained in the note field.

tx-typestringpaykeyregacfgaxferafrzapplstpfquery

sig-typestringsigmsiglsigpqsigquery

SigType filters just results using the specified type of signature:

sig - Standard
msig - MultiSig
lsig - LogicSig
pqsig - Post-Quantum

pqsig was added in 3.10.0.

txidstringquery

Lookup the specific transaction by ID.

roundintegerquery

Include results for the specified round.

min-roundintegerquery

Include results at or after the specified min-round.

max-roundintegerquery

Include results at or before the specified max-round.

before-timestring<date-time>query

Include results before the given time. Must be an RFC 3339 formatted string.

after-timestring<date-time>query

Include results after the given time. Must be an RFC 3339 formatted string.

currency-greater-thanintegerquery

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.

currency-less-thanintegerquery

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.

addressstringquery

Only include transactions with this address in one of the transaction fields.

address-rolestringsenderreceiverfreeze-targetquery

Combine with the address parameter to define what type of address to search for.

exclude-close-tobooleanquery

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.

asset-idintegerrequiredpath

rekey-tobooleanquery

Include results which include the rekey-to field.

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

GET /v2/assets/{asset-id}/transactions

curl -X GET 'https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions'

const response = await fetch('https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions')
data = response.json()

const response = await fetch('https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/assets/{asset-id}/transactions')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "current-round": 0,
  "next-token": "string",
  "transactions": []
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

Blocks

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed in 3.10.0. A block may now carry congestion-tax and load. Returned only from consensus version v42 onwards. Mainnet upgrades to v42 at round 64318659, until then the field is never returned.

Lookup block.

Parameters

round-numberintegerrequiredpath

Round number

header-onlybooleanquery

Header only flag. When this is set to true, returned block does not contain the transactions

Response

200OK

(empty)

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET /v2/blocks/{round-number}

curl -X GET 'https://algo-index.nownodes.io/v2/blocks/{round-number}'

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

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/blocks/{round-number}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://algo-index.nownodes.io/v2/blocks/{round-number}')
data = response.json()

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

const data = await response.json();

const endpoint = "https://algo-index.nownodes.io/v2/blocks/{round-number}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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

const data = await response.json();

import requests

response = requests.get('https://algo-index.nownodes.io/v2/blocks/{round-number}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/blocks/{round-number}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

Transactions

GET

https://algo-index.nownodes.io/v2/transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Search for transactions. Transactions are returned oldest to newest unless the address parameter is used, in which case results are returned newest to oldest.

Parameters

limitintegerquery

Maximum number of results to return. There could be additional pages even if the limit is not reached.

nextstringquery

The next page of results. Use the next token provided by the previous results.

note-prefixstringquery

Specifies a prefix which must be contained in the note field.

tx-typestringpaykeyregacfgaxferafrzapplstpfquery

sig-typestringsigmsiglsigpqsigquery

SigType filters just results using the specified type of signature:

sig - Standard
msig - MultiSig
lsig - LogicSig
pqsig - Post-Quantum

pqsig was added in 3.10.0.

txidstringquery

Lookup the specific transaction by ID.

roundintegerquery

Include results for the specified round.

min-roundintegerquery

Include results at or after the specified min-round.

max-roundintegerquery

Include results at or before the specified max-round.

asset-idintegerquery

Asset ID

before-timestring<date-time>query

Include results before the given time. Must be an RFC 3339 formatted string.

after-timestring<date-time>query

Include results after the given time. Must be an RFC 3339 formatted string.

currency-greater-thanintegerquery

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.

currency-less-thanintegerquery

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.

addressstringquery

Only include transactions with this address in one of the transaction fields.

address-rolestringsenderreceiverfreeze-targetquery

Combine with the address parameter to define what type of address to search for.

exclude-close-tobooleanquery

rekey-tobooleanquery

Include results which include the rekey-to field.

application-idintegerquery

Application ID

Response

200OK

(empty)

400Bad Request

Response for errors

500Internal Server Error

Response for errors

GET /v2/transactions

curl -X GET 'https://algo-index.nownodes.io/v2/transactions'

const response = await fetch('https://algo-index.nownodes.io/v2/transactions', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/transactions')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://algo-index.nownodes.io/v2/transactions')
data = response.json()

const response = await fetch('https://algo-index.nownodes.io/v2/transactions', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://algo-index.nownodes.io/v2/transactions";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://algo-index.nownodes.io/v2/transactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://algo-index.nownodes.io/v2/transactions')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/transactions')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "current-round": 0,
  "next-token": "string",
  "transactions": []
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

GET

https://algo-index.nownodes.io/v2/transactions/{txid}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lookup a single transaction.

Parameters

txidstringrequiredpath

Response

200OK

(empty)

400Bad Request

Response for errors

404Not Found

Response for errors

500Internal Server Error

Response for errors

GET /v2/transactions/{txid}

curl -X GET 'https://algo-index.nownodes.io/v2/transactions/{txid}'

const response = await fetch('https://algo-index.nownodes.io/v2/transactions/{txid}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/transactions/{txid}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://algo-index.nownodes.io/v2/transactions/{txid}')
data = response.json()

const response = await fetch('https://algo-index.nownodes.io/v2/transactions/{txid}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://algo-index.nownodes.io/v2/transactions/{txid}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://algo-index.nownodes.io/v2/transactions/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://algo-index.nownodes.io/v2/transactions/{txid}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://algo-index.nownodes.io/v2/transactions/{txid}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "current-round": 0
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

{
  "data": {},
  "message": "string"
}

Documentation

How to migrate to NOWNodes

Indexer 3.9.0 to 3.10.0 API CHANGES

Added

Changed

About consensus version v42

Authentication

Changelog indexer 3.9.0 to 3.10.0

Accounts

Authorizations

Parameters

Response

Authorizations

Parameters

Response

Authorizations

Parameters

Response

Applications

Get box names for a given application.

Authorizations

Parameters

Response

Assets

Authorizations

Parameters

Response

Blocks

Authorizations

Parameters

Response

Transactions

Authorizations

Parameters

Response

Authorizations

Parameters

Response