Get all coins for an sui address

POST

https://sui.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all coin objects owned by the specified sui address. Supports pagination via cursor and limit.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | string | integer>required

Parameters array containing the owner address, optional cursor, and optional limit.

Show child attributes

One of

sui address of the coin owner.

string

Optional paging cursor.

string

Optional limit of items per page.

integer

idintegerrequired

Response

200OK

Successful response returning a page of coins.

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve coins.

Get all coins for an sui address

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

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://sui.nownodes.io/");
const result = await provider.send("suix_getAllCoins", [
  "0x41f5975e3c6bd5c95f041a8493ad7e9934be26e69152d2c2e86d8a9bdbd242b3"
]);
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_getAllCoins",
  "params": [
    "0x41f5975e3c6bd5c95f041a8493ad7e9934be26e69152d2c2e86d8a9bdbd242b3"
  ],
  "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_getAllCoins", [
  "0x41f5975e3c6bd5c95f041a8493ad7e9934be26e69152d2c2e86d8a9bdbd242b3"
])
print(response)

import { createPublicClient, http } from "viem";

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

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

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_getAllCoins", params: [
  "0x41f5975e3c6bd5c95f041a8493ad7e9934be26e69152d2c2e86d8a9bdbd242b3"
], 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_getAllCoins",
      "params": [
        "0x41f5975e3c6bd5c95f041a8493ad7e9934be26e69152d2c2e86d8a9bdbd242b3"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_getAllCoins",
  "params": [
    "0x41f5975e3c6bd5c95f041a8493ad7e9934be26e69152d2c2e86d8a9bdbd242b3"
  ],
  "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_getAllCoins",
    "params": [
      "0x41f5975e3c6bd5c95f041a8493ad7e9934be26e69152d2c2e86d8a9bdbd242b3"
    ],
    "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_getAllCoins",
  "params": [
    "0x41f5975e3c6bd5c95f041a8493ad7e9934be26e69152d2c2e86d8a9bdbd242b3"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "data": [
      {
        "coinType": "0x2::sui::sui",
        "coinObjectId": "0x8e0e1ab0e53d874f47ec9910de2dab88a3af7d936f6b6cd03653d68cc8689d5a",
        "version": "2",
        "digest": "9KssB4fKHECePXq7kQXbTej4EqrcDhKvku6wVWvFJbt",
        "balance": "478750000",
        "previousTransaction": "6rdzUN9Pp3D62kRF953UzHG2SQw1bYiKqotVZM8rakF6"
      }
    ],
    "nextCursor": "0x8e0e1ab0e53d874f47ec9910de2dab88a3af7d936f6b6cd03653d68cc8689d5a",
    "hasNextPage": false
  }
}

Documentation

How to migrate to NOWNodes

Get all coins for an sui address

Authorizations

Body

Response