POST /rpc

POST

https://casper.nownodes.io/rpc

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Executes the query_global_state RPC call to retrieve the value associated with a key in the global state.
Returns block header, stored value, and a Merkle proof.

Body

application/json

idinteger

JSON-RPC request identifier

jsonrpcstring

JSON-RPC version

methodstring

RPC method name

paramsobject

Parameters for the query_global_state RPC

Show child attributes

state_identifierobject

Block identifier to query the state at

Show child attributes

BlockHashstring

The hash of the block

keystring

Key to query in the global state (can be a URef or deploy hash)

pathArray<string>

Path within the stored value (empty array if root)

Response

200OK

Successful query response

POST /rpc

curl -X POST 'https://casper.nownodes.io/rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "query_global_state",
    "params": {
      "state_identifier": {
        "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
      },
      "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
      "path": []
    }
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://casper.nownodes.io/rpc");
const result = await provider.send("query_global_state", {
  "state_identifier": {
    "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
  },
  "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
  "path": []
});
console.log(result);

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

uri = URI('https://casper.nownodes.io/rpc')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "query_global_state",
  "params": {
    "state_identifier": {
      "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
    },
    "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
    "path": []
  },
  "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://casper.nownodes.io/rpc"))
response = w3.provider.make_request("query_global_state", {
  "state_identifier": {
    "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
  },
  "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
  "path": []
})
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://casper.nownodes.io/rpc"),
});

const result = await client.request({
  method: "query_global_state",
  params: {
  "state_identifier": {
    "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
  },
  "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
  "path": []
},
});

console.log(result);

const endpoint = "https://casper.nownodes.io/rpc";
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: "query_global_state", params: {
  "state_identifier": {
    "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
  },
  "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
  "path": []
}, id: 1 });
console.log(result);

const response = await fetch('https://casper.nownodes.io/rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": 1,
      "jsonrpc": "2.0",
      "method": "query_global_state",
      "params": {
        "state_identifier": {
          "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
        },
        "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
        "path": []
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "id": 1,
  "jsonrpc": "2.0",
  "method": "query_global_state",
  "params": {
    "state_identifier": {
      "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
    },
    "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
    "path": []
  }
}

response = requests.post('https://casper.nownodes.io/rpc', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://casper.nownodes.io/rpc')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "query_global_state",
    "params": {
      "state_identifier": {
        "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
      },
      "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
      "path": []
    }
  }'

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

Request Body

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "query_global_state",
  "params": {
    "state_identifier": {
      "BlockHash": "57bb850a21b6531d25f52a19a35b0d0998a0de55afd0a20f1e1d364806d299f2"
    },
    "key": "uref-1f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3-007",
    "path": []
  }
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "api_version": "2.0.0",
    "block_header": {
      "Version2": {
        "parent_hash": "542023d99a887da427a42b200d5fdc90bafcedc22c78b2d71aa137e9483409db",
        "state_root_hash": "0d755cdc493b13b325f1736f19898b1f77c76c89590f792502eacddba4cfa897",
        "body_hash": "df28a738bf142d18d40fea07f4517f9a5b8916504e04c05be18707ddf588e4f2",
        "random_bit": false,
        "accumulated_seed": "9416884b7fa10ea62c20cef65a58e376fcfbe2ea6c4e2e03b7ee424ef46129ad",
        "era_end": null,
        "timestamp": "2025-12-09T15:33:16.433Z",
        "era_id": 20493,
        "height": 5936670,
        "protocol_version": "2.0.4",
        "proposer": "01c377281132044bd3278b039925eeb3efdb9d99dd5f46d9ec6a764add34581af7",
        "current_gas_price": 1,
        "last_switch_block_hash": "39f4a82ccee76954a4de90c637b10e8b266f239b5afb6074aa499b7f3bad7d62"
      }
    },
    "stored_value": {
      "CLValue": {
        "cl_type": "Unit",
        "bytes": "",
        "parsed": "string"
      }
    },
    "merkle_proof": "01000000021f13adab50a177006a9ee7f8d6fd7349c6845cf8fb1734835e262eeb9c8006e3000000000000090400000000ad0700000..."
  }
}

Documentation

How to migrate to NOWNodes

Authorizations

Body

Response