Get contract bytecode at an address

POST

https://vinu.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the contract code stored at a given address. If the address is an externally owned account (EOA), it returns "0x".

State access is limited to recent blocks - these are full nodes, not archive nodes. In practice only the last dozen or so blocks resolve; deeper block parameters return -32000 missing trie node <hash> (path ). earliest also works, since genesis state is kept. Use latest or pending for anything that must not fail: the pruning boundary moves continuously, so a height taken from eth_blockNumber can already be out of range by the time you query it.

Block, transaction and receipt history is complete back to block 1 - only state is pruned.

Block tags accepted by this node: earliest, latest, pending, or a hex block number. safe and finalized are NOT supported and fail with -32602 invalid argument N: hex string without 0x prefix - Lachesis aBFT finalises immediately, so there is no separate safe/finalized head.

Body

application/json

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with two elements:

The address to get the code for (hex string, 0x-prefixed).
The block number or block tag (e.g., "latest", "earliest", "pending").

idintegerrequired

Request identifier.

Response

200OK

Contract bytecode in hex format

405Method Not Allowed

Method not served by this endpoint. The body is the plain-text string Method Not Allowed, not JSON.

422Unprocessable Entity

Missing API key - the api-key header was absent. The body is the plain-text string Missing API_key, not JSON.

Get contract bytecode at an address

curl -X POST 'https://vinu.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -H 'api-key: YOUR_API_KEY' \
  -d '{"jsonrpc": "2.0", "method": "eth_getCode", "params": ["0xfc00face00000000000000000000000000000000", "latest"], "id": 1}'

import { FetchRequest, JsonRpcProvider } from "ethers";

const request = new FetchRequest("https://vinu.nownodes.io/");
request.setHeader("api-key", "YOUR_API_KEY");

const provider = new JsonRpcProvider(request);
const result = await provider.send("eth_getCode", ["0xfc00face00000000000000000000000000000000", "latest"]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://vinu.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['api-key'] = 'YOUR_API_KEY'
request.body = '{"jsonrpc": "2.0", "method": "eth_getCode", "params": ["0xfc00face00000000000000000000000000000000", "latest"], "id": 1}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider(
    "https://vinu.nownodes.io/",
    request_kwargs={"headers": {"api-key": "YOUR_API_KEY"}},
))

response = w3.provider.make_request("eth_getCode", [
    "0xfc00face00000000000000000000000000000000",
    "latest",
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://vinu.nownodes.io/", {
    fetchOptions: { headers: { "api-key": "YOUR_API_KEY" } },
  }),
});

const result = await client.request({
  method: "eth_getCode",
  params: ["0xfc00face00000000000000000000000000000000", "latest"],
});

console.log(result);

const endpoint = "https://vinu.nownodes.io/";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "eth_getCode", params: [
  "0xfc00face00000000000000000000000000000000",
  "latest"
], id: 1 });
console.log(result);

const response = await fetch('https://vinu.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_getCode",
    "params": [
      "0xfc00face00000000000000000000000000000000",
      "latest"
    ],
    "id": 1
  }),
});

const data = await response.json();

import requests

payload = {
    "jsonrpc": "2.0",
    "method": "eth_getCode",
    "params": [
        "0xfc00face00000000000000000000000000000000",
        "latest",
    ],
    "id": 1,
}

response = requests.post(
    "https://vinu.nownodes.io/",
    json=payload,
    headers={"api-key": "YOUR_API_KEY"},
)

print(response.json())

require 'net/http'
require 'json'

uri = URI('https://vinu.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['api-key'] = 'YOUR_API_KEY'
request.body = '{"jsonrpc": "2.0", "method": "eth_getCode", "params": ["0xfc00face00000000000000000000000000000000", "latest"], "id": 1}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0xfc00face00000000000000000000000000000000",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x6080604052348015600f57600080fd5b5060..."
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Method Not Allowed

Missing API_key