Get contracts

GET

https://xtz-index.nownodes.io/v1/contracts

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns a list of contract accounts.

Parameters

idobject | nullquery

Filter by internal TzKT id. Click on the parameter to expand more details.

addressobject | nullquery

Filter by address. Click on the parameter to expand more details.

kindobject | nullquery

Filter by kind (delegator_contract, smart_contract, or asset). Click on the parameter to expand more details.

tzipsobject | nullquery

Filter by tzips (fa1, fa12, or fa2). Click on the parameter to expand more details.

balanceobject | nullquery

Filter by balance. Click on the parameter to expand more details.

creatorobject | nullquery

Filter by creator. Click on the parameter to expand more details.

delegateobject | nullquery

Filter by delegate. Click on the parameter to expand more details.

firstActivityobject | nullquery

Filter by level of the block where the contract was first seen. Click on the parameter to expand more details.

firstActivityTimeobject | nullquery

Filter by timestamp (ISO 8601) of the block where the contract was first seen. Click on the parameter to expand more details.

lastActivityobject | nullquery

Filter by level of the block where the contract was last seen. Click on the parameter to expand more details.

lastActivityTimeobject | nullquery

Filter by timestamp (ISO 8601) of the block where the contract was last seen. Click on the parameter to expand more details.

typeHashobject | nullquery

Filter by 32-bit hash of contract parameter and storage types (helpful for searching similar contracts). Click on the parameter to expand more details.

codeHashobject | nullquery

Filter by 32-bit hash of contract code (helpful for searching same contracts). Click on the parameter to expand more details.

tokensCountobject | nullquery

Filter by number of different tokens minted within the contract. Click on the parameter to expand more details.

ticketsCountobject | nullquery

Filter by number of different tickets minted within the contract. Click on the parameter to expand more details.

sortobject | nullquery

Sorts items (asc or desc) by the specified field. You can see what fields can be used for sorting in the response description, below. Click on the parameter to expand more details.

offsetobject | nullquery

Specifies which or how many items should be skipped. Click on the parameter to expand more details.

limitinteger<int32>[0, 10000]query

Maximum number of items to return.

selectobject | nullquery

Specify a comma-separated list of fields to include into response or leave it undefined to get default set of fields. This parameter accepts values of the following format: {field}{path?}{as alias?}, so you can do.

includeStoragebooleanfalsequery

Specifies whether to include contract storage into response.

Response

200OK

Successful response.

400Bad Request

Invalid request.

Get contracts

curl -X GET 'https://xtz-index.nownodes.io/v1/contracts'

const response = await fetch('https://xtz-index.nownodes.io/v1/contracts', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/contracts')
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://xtz-index.nownodes.io/v1/contracts')
data = response.json()

const response = await fetch('https://xtz-index.nownodes.io/v1/contracts', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://xtz-index.nownodes.io/v1/contracts";
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://xtz-index.nownodes.io/v1/contracts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://xtz-index.nownodes.io/v1/contracts')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/contracts')
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)

[
  {
    "address": "tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU",
    "kind": "string",
    "creator": {
      "address": "tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU"
    }
  }
]

{
  "error": "Invalid request parameters."
}