suix_getBalance (deprecated)

deprecated

POST

https://sui.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Deprecated. Removed in Sui 1.82.3: the JSON-RPC service was removed from the Sui full node, so this method is no longer available on the NOWNodes SUI endpoint. Use the SUI gRPC API instead. This page is kept for reference only.

Returns the total coin balance for one coin type, owned by the address owner.

Body

application/json

JSON-RPC request for suix_getBalance.

JSON-RPC request accepted by this operation.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringsuix_getBalancerequired

Sui JSON-RPC method to execute.

paramsArray<any>required

Ordered parameters: owner — the owner's Sui address; coin_type — optional type names for the coin (e.g., 0x168da5bf1f48dafc111b0a488fa454aca95e0b5e::usdc::USDC), default to..

idintegerrequired

Identifier used to match the request and response.

Response

200OK

Successful JSON-RPC response.

400Bad Request

The JSON-RPC request or parameters are invalid.

401Unauthorized

The API key is missing or invalid.

429Too Many Requests

The request rate limit was exceeded.

500Internal Server Error

The node could not complete the request.

suix_getBalance (deprecated)

curl -X POST 'https://sui.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "suix_getBalance",
    "params": [
      "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
      "0x2::sui::SUI"
    ],
    "id": 1
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://sui.nownodes.io/");
const result = await provider.send("suix_getBalance", [
  "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
  "0x2::sui::SUI"
]);
console.log(result);

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

uri = URI('https://sui.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "suix_getBalance",
  "params": [
    "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
    "0x2::sui::SUI"
  ],
  "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://sui.nownodes.io/"))
response = w3.provider.make_request("suix_getBalance", [
  "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
  "0x2::sui::SUI"
])
print(response)

import { createPublicClient, http } from "viem";

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

const result = await client.request({
  method: "suix_getBalance",
  params: [
  "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
  "0x2::sui::SUI"
],
});

console.log(result);

const endpoint = "https://sui.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: "suix_getBalance", params: [
  "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
  "0x2::sui::SUI"
], id: 1 });
console.log(result);

const response = await fetch('https://sui.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "suix_getBalance",
      "params": [
        "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
        "0x2::sui::SUI"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_getBalance",
  "params": [
    "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
    "0x2::sui::SUI"
  ],
  "id": 1
}

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

require 'net/http'
require 'json'

uri = URI('https://sui.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "suix_getBalance",
    "params": [
      "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
      "0x2::sui::SUI"
    ],
    "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": "suix_getBalance",
  "params": [
    "0xf861d2ba5e9a4e590ee0d5a2baba787d9bdf7f10e9a2c0689e2c52a464b28475",
    "0x2::sui::SUI"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "coinType": "0x2::sui::SUI",
    "coinObjectCount": 1,
    "totalBalance": "8143604644",
    "lockedBalance": {},
    "fundsInAddressBalance": "8143604644"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}