Get contract metadata.

GET

https://xvg-blockbook.nownodes.io/api/v2/contract/{contract}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Added in Blockbook v0.6.0: single-contract lookup endpoint /api/v2/contract/{contract} with optional ERC-4626 vault enrichment (protocols=erc4626); it did not exist in 0.5.0. Contract indexing is an EVM-chains feature and is not applicable to the Verge UTXO chain. Documented as it exists in 0.6.0.

Returns indexed token/contract metadata and optional current protocol enrichments such as ERC4626.

Load estimate: Medium; indexed metadata is cheap, but optional protocol enrichment can add backend RPC calls and token metadata lookups (EVM chains only).

live-verified behavior:

Live on the deployed 0.6.0 XVG build: the gateway does not route this path to the contract handler - /api/v2/contract/{anything} falls through to the index handler and answers HTTP 200 with the Blockbook status object (the same body served at /api/). The live capture below is that status body, shown with the corrected decimals value 6.

Parameters

contractstringrequiredpath

Smart contract address.

currencystringquery

Secondary currency code for rates.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated.

Response

200OK

HTTP 200 Verge Blockbook response for getContractInfo.

400Bad Request

Domain or validation error. live-verified: JSON body {"error": "..."} (unknown block/transaction, invalid address, malformed broadcast hex, missing filter parameters).

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes (and for the v1 GET broadcast route on this instance).

500Internal Server Error

Internal Server Error. live-verified on the deployed instance: JSON body {"error":"Internal server error"} (observed on /api/rawtx and invalid XPUB lookups).

Get contract metadata.

curl -X GET 'https://xvg-blockbook.nownodes.io/api/v2/contract/{contract}'

const response = await fetch('https://xvg-blockbook.nownodes.io/api/v2/contract/{contract}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://xvg-blockbook.nownodes.io/api/v2/contract/{contract}')
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://xvg-blockbook.nownodes.io/api/v2/contract/{contract}')
data = response.json()

const response = await fetch('https://xvg-blockbook.nownodes.io/api/v2/contract/{contract}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://xvg-blockbook.nownodes.io/api/v2/contract/{contract}";
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://xvg-blockbook.nownodes.io/api/v2/contract/{contract}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://xvg-blockbook.nownodes.io/api/v2/contract/{contract}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://xvg-blockbook.nownodes.io/api/v2/contract/{contract}')
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)

{
  "blockbook": {
    "coin": "Verge",
    "network": "XVG",
    "host": "5615d5d83d95",
    "version": "0.6.0",
    "gitCommit": "c4e97eb7-dirty",
    "buildTime": "2026-04-12T16:57:40+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 9446079,
    "lastBlockTime": "2026-09-01T08:22:43.811504021Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-09-01T08:23:47.035058095Z",
    "mempoolSize": 0,
    "decimals": 6,
    "dbSize": 10614632829,
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "main",
    "blocks": 9446079,
    "headers": 9446079,
    "bestBlockHash": "e2fa13a5affbbe613af90bdf87832308f36ded8150f0b011dbedecbfcc2fb479",
    "difficulty": "30779.88304093567",
    "sizeOnDisk": 9686927235,
    "version": "26070000",
    "subversion": "/verge:26.7.0/",
    "protocolVersion": "90009"
  }
}

{
  "error": "Contract not found"
}

{
  "error": "Contract not found"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}

Documentation

How to migrate to NOWNodes

Get contract metadata.

Authorizations

Parameters

Response