Get contract metadata.

GET

https://optimism-index.nownodes.io/api/v2/contract/{contract}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

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

blockHeight reflects the indexer's best block at request time. ERC4626 fields under protocols.erc4626 are fetched through JSON-RPC calls pinned to that exact blockHeight, so the ERC4626 values are a consistent snapshot. If a vault is detected but the underlying asset metadata cannot be resolved, protocols.erc4626 contains error and omits asset; callers must not derive fiat rates or human-unit exchange rates from such a partial response.

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

Parameters

contractstringrequiredpath

Smart contract address.

currencystringquery

Secondary currency code for rates.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated.

Response

200OK

Contract metadata.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

default

Public API error.

Get contract metadata.

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

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

const data = await response.json();

require 'net/http'
require 'json'

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

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

const data = await response.json();

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://optimism-index.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)

{
  "type": "BEP20",
  "standard": "BEP20",
  "contract": "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c",
  "name": "Wrapped BNB",
  "symbol": "WBNB",
  "decimals": 18,
  "createdInBlock": 0,
  "destructedInBlock": 0,
  "rates": {
    "baseRate": 0.9633355140686035,
    "currency": "usd",
    "secondaryRate": 1.24
  },
  "protocols": {
    "erc4626": {
      "asset": {
        "contract": "0x0000000000000000000000000000000000000002",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18
      },
      "share": {
        "contract": "0x0000000000000000000000000000000000000001",
        "name": "Vault Share",
        "symbol": "vETH",
        "decimals": 18
      },
      "totalAssets": "123456789",
      "convertToAssets1Share": "1000000000000000000",
      "convertToShares1Asset": "1000000000000000000",
      "previewDeposit1Asset": "999999999999999999",
      "previewRedeem1Share": "1000000000000000000",
      "error": "string"
    }
  },
  "blockHeight": 114742391
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "error": "Invalid contract, Address missing"
}