Get account information given an account ID

POST

https://ardr.nownodes.io/nxt

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsobjectrequired

Show child attributes

requestTypestring

accountstring

The account ID

includeLessorsboolean

true to include lessors, lessorsRS and lessorsInfo

includeAssetsboolean

true to include assetBalances and unconfirmedAssetBalances

includeCurrenciesboolean

true to include accountCurrencies

includeEffectiveBalanceboolean

true to include effectiveBalanceNXT and guaranteedBalanceNQT

requireBlockstring

The block ID of a block that must be present in the blockchain

requireLastBlockstring

The block ID of a block that must be last in the blockchain

idintegerrequired

Response

200OK

Account information

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Get account information given an account ID

curl -X POST 'https://ardr.nownodes.io/nxt' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getAccount",
    "params": {
      "requestType": "getAccount",
      "account": "string",
      "includeLessors": true,
      "includeAssets": true,
      "includeCurrencies": true,
      "includeEffectiveBalance": true,
      "requireBlock": "string",
      "requireLastBlock": "string"
    },
    "id": 1
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://ardr.nownodes.io/nxt");
const result = await provider.send("getAccount", {
  "requestType": "getAccount",
  "account": "string",
  "includeLessors": true,
  "includeAssets": true,
  "includeCurrencies": true,
  "includeEffectiveBalance": true,
  "requireBlock": "string",
  "requireLastBlock": "string"
});
console.log(result);

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

uri = URI('https://ardr.nownodes.io/nxt')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "getAccount",
  "params": {
    "requestType": "getAccount",
    "account": "string",
    "includeLessors": true,
    "includeAssets": true,
    "includeCurrencies": true,
    "includeEffectiveBalance": true,
    "requireBlock": "string",
    "requireLastBlock": "string"
  },
  "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://ardr.nownodes.io/nxt"))
response = w3.provider.make_request("getAccount", {
  "requestType": "getAccount",
  "account": "string",
  "includeLessors": True,
  "includeAssets": True,
  "includeCurrencies": True,
  "includeEffectiveBalance": True,
  "requireBlock": "string",
  "requireLastBlock": "string"
})
print(response)

import { createPublicClient, http } from "viem";

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

const result = await client.request({
  method: "getAccount",
  params: {
  "requestType": "getAccount",
  "account": "string",
  "includeLessors": true,
  "includeAssets": true,
  "includeCurrencies": true,
  "includeEffectiveBalance": true,
  "requireBlock": "string",
  "requireLastBlock": "string"
},
});

console.log(result);

const endpoint = "https://ardr.nownodes.io/nxt";
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: "getAccount", params: {
  "requestType": "getAccount",
  "account": "string",
  "includeLessors": true,
  "includeAssets": true,
  "includeCurrencies": true,
  "includeEffectiveBalance": true,
  "requireBlock": "string",
  "requireLastBlock": "string"
}, id: 1 });
console.log(result);

const response = await fetch('https://ardr.nownodes.io/nxt', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "getAccount",
      "params": {
        "requestType": "getAccount",
        "account": "string",
        "includeLessors": true,
        "includeAssets": true,
        "includeCurrencies": true,
        "includeEffectiveBalance": true,
        "requireBlock": "string",
        "requireLastBlock": "string"
      },
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getAccount",
  "params": {
    "requestType": "getAccount",
    "account": "string",
    "includeLessors": True,
    "includeAssets": True,
    "includeCurrencies": True,
    "includeEffectiveBalance": True,
    "requireBlock": "string",
    "requireLastBlock": "string"
  },
  "id": 1
}

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

require 'net/http'
require 'json'

uri = URI('https://ardr.nownodes.io/nxt')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "getAccount",
    "params": {
      "requestType": "getAccount",
      "account": "string",
      "includeLessors": true,
      "includeAssets": true,
      "includeCurrencies": true,
      "includeEffectiveBalance": true,
      "requireBlock": "string",
      "requireLastBlock": "string"
    },
    "id": 1
  }'

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getAccount",
  "params": {
    "requestType": "getAccount",
    "account": "string",
    "includeLessors": true,
    "includeAssets": true,
    "includeCurrencies": true,
    "includeEffectiveBalance": true,
    "requireBlock": "string",
    "requireLastBlock": "string"
  },
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "forgedBalanceFQT": "string",
    "assetBalances": [
      {
        "balanceQNT": "string",
        "asset": "string"
      }
    ],
    "unconfirmedAssetBalances": [
      {
        "unconfirmedBalanceQNT": "string",
        "asset": "string"
      }
    ],
    "accountCurrencies": [
      {}
    ],
    "lessorsInfo": [
      {
        "currentHeightTo": "string",
        "nextHeightFrom": "string",
        "nextLesseeRS": "string",
        "currentLesseeRS": "string",
        "currentHeightFrom": "string",
        "nextHeightTo": "string"
      }
    ],
    "lessors": [
      "string"
    ],
    "currentLessee": "string",
    "currentLeasingHeightTo": 0,
    "balanceNQT": "string",
    "publicKey": "string",
    "requestProcessingTime": 0,
    "guaranteedBalanceFQT": "string",
    "currentLesseeRS": "string",
    "accountRS": "string",
    "lessorsRS": [
      "string"
    ],
    "name": "string",
    "description": "string",
    "effectiveBalanceFXT": "string",
    "account": "string",
    "currentLeasingHeightFrom": 0,
    "lastBlock": "string"
  }
}

Documentation

How to migrate to NOWNodes

Get account information given an account ID

Authorizations

Body

Response