sui Node API - suix_getAllCoins

v1.0.0

Base URL

https://sui.nownodes.io

Returns all Coin objects owned by a given sui address, supporting pagination with optional cursor and limit parameters.

Authentication

ApiKeyAuthapiKey

API Key: api-key in header

api-keyAuthapiKey

API Key: api-key in header

apiKeyapiKey

API Key: api-key in header

Coin Query API

suixGetAllCoins

Get all coins for an sui address

POST

https://sui.nownodes.io/

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.

Authorization

ApiKeyAuthapiKey in header

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
  }'

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()

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
  }
}

suixGetAllBalances

Get total coin balances for an sui address

POST

https://sui.nownodes.io/

This method returns the total coin balance for all coin types owned by a given sui address.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

Parameters array containing the owner’s sui address.

idintegerrequired

Response

200OK

Successful response with total balances for all coin types.

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve balances.

Authorization

ApiKeyAuthapiKey in header

Get total coin balances for an sui address

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_getAllBalances",
  "params": [
    "0x94f1a597b4e8f709a396f7f6b1482bdcd65a673d111e49286c527fab7c2d0961"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "suix_getAllBalances",
  "params": [
    "0x94f1a597b4e8f709a396f7f6b1482bdcd65a673d111e49286c527fab7c2d0961"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "coinType": "0x2::sui::sui",
      "coinObjectCount": 2,
      "totalBalance": "7364065201200"
    }
  ]
}

suixGetBalance

Get total balance of a specific coin type for an sui address

POST

https://sui.nownodes.io/

Returns the total balance for a specified coin type for the given sui address. Defaults to 0x2::sui::sui if coin_type is not provided.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | string>required

Array containing the owner address and optional coin type.

Show child attributes

One of

sui address of the owner.

string

Optional coin type. Defaults to 0x2::sui::sui.

string

idintegerrequired

Response

200OK

Successful response returning the balance.

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve balance.

Authorization

ApiKeyAuthapiKey in header

Get total balance of a specific coin type for an sui address

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_getBalance",
  "params": [
    "0x51ceab2edc89f74730e683ebee65578cb3bc9237ba6fca019438a9737cf156ae"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "suix_getBalance",
  "params": [
    "0x51ceab2edc89f74730e683ebee65578cb3bc9237ba6fca019438a9737cf156ae"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "coinType": "0x2::sui::sui",
    "coinObjectCount": 1,
    "totalBalance": "49000000"
  }
}

suixGetCoinMetadata

Get coin metadata

POST

https://sui.nownodes.io/

Returns metadata (symbol, decimals, description, icon, and object ID) for the specified coin type.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

Array with one coin type string

idintegerrequired

Response

200OK

Successful response returning coin metadata.

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve coin metadata.

Authorization

ApiKeyAuthapiKey in header

Get coin metadata

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_getCoinMetadata",
  "params": [
    "0x168da5bf1f48dafc111b0a488fa454aca95e0b5e::usdc::USDC"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "suix_getCoinMetadata",
  "params": [
    "0x168da5bf1f48dafc111b0a488fa454aca95e0b5e::usdc::USDC"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "decimals": 9,
    "name": "Usdc",
    "symbol": "USDC",
    "description": "Stable coin.",
    "iconUrl": "null",
    "id": "0x6d907beaa3a49db57bdfdb3557e6d405cbf01c293a53e01457d65e92b5d8dd68"
  }
}

suixGetCoins

Get coins for an address

POST

https://sui.nownodes.io/

Returns all Coin objects owned by an address. Supports pagination via cursor and limit, and optional filtering by coin type.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | integer>required

Array with the following parameters: 1. owner address (string, required) 2. coin type (string, optional) 3. cursor (string, optional) 4. limit (integer, optional)

Show child attributes

One of

string

integer

idintegerrequired

Response

200OK

Successful response returning a paginated list of Coin objects.

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve coins.

Authorization

ApiKeyAuthapiKey in header

Get coins for an address

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_getCoins",
  "params": [
    "0xd62ca040aba24f862a763851c54908cd2a0ee7d709c11b93d4a2083747b76856",
    "0x2::sui::sui",
    "0xe5c651321915b06c81838c2e370109b554a448a78d3a56220f798398dde66eab",
    3
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "suix_getCoins",
  "params": [
    "0xd62ca040aba24f862a763851c54908cd2a0ee7d709c11b93d4a2083747b76856",
    "0x2::sui::sui",
    "0xe5c651321915b06c81838c2e370109b554a448a78d3a56220f798398dde66eab",
    3
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "data": [
      {
        "coinType": "0x2::sui::sui",
        "coinObjectId": "0x001851cd7087de53b43c95ef79a2309ff8ffcfc67f4fd63ac636d8073b6c748d",
        "version": "1",
        "digest": "HNm8FY8WU1QsfbGTDpSjiCYRBdYtFUqhdDvShH8fyYrA",
        "balance": "269046000000000",
        "previousTransaction": "9Dt8qnC3ck6MedU4fuHc8mwFSBrQodTNdiKzaZ6TG8QY"
      }
    ],
    "nextCursor": "0x005bd046b8ba38fcd085f5fc1df7eb124ab76f5658f42570754eb73534f416ed",
    "hasNextPage": true
  }
}

suixGetTotalSupply

Get total supply of a coin

POST

https://sui.nownodes.io/

Returns the total supply for the specified coin type. Default is sui if coin_type is not specified.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

Array with one string the coin type

idintegerrequired

Response

200OK

Successful response returning the total supply for the coin.

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve total supply.

Authorization

ApiKeyAuthapiKey in header

Get total supply of a coin

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "suix_getTotalSupply",
  "params": [
    "0x2::sui::sui"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "value": "4619174535328000000"
  }
}

Discover

POST

https://sui.nownodes.io/

Main entry point for all Sui JSON-RPC methods.

Body

application/json

jsonrpcstring2.0required

JSON-RPC protocol version

methodstringrequired

Name of the RPC method to call

paramsarray

Parameters for the method (may be empty)

idintegerrequired

Request identifier (can be any JSON value, typically a number)

Response

200OK

Successful RPC response

Authorization

api-keyAuthapiKey in header

POST /

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "rpc.discover",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "rpc.discover",
  "id": 1
}

200

{
  "rpc_discover": {
    "summary": "RPC discovery response",
    "value": {
      "jsonrpc": "2.0",
      "id": 1,
      "result": {
        "openrpc": "1.2.6",
        "info": {
          "title": "Sui JSON-RPC",
          "description": "Sui JSON-RPC API for interaction with Sui Full node.",
          "version": "1.67.3",
          "contact": {
            "name": "Mysten Labs",
            "url": "https://mystenlabs.com",
            "email": "[email protected]"
          },
          "license": {
            "name": "Apache-2.0",
            "url": "https://raw.githubusercontent.com/MystenLabs/sui/main/LICENSE"
          },
          "x-gitbook-description-document": {
            "object": "document",
            "data": {
              "schemaVersion": 9
            },
            "nodes": [
              {
                "object": "block",
                "type": "paragraph",
                "isVoid": false,
                "data": {},
                "nodes": [
                  {
                    "object": "text",
                    "leaves": [
                      {
                        "object": "leaf",
                        "text": "Sui JSON-RPC API for interaction with Sui Full node.",
                        "marks": []
                      }
                    ],
                    "key": "U4EmXLwbYWNe"
                  }
                ],
                "key": "xwwb3PYFnM0f"
              }
            ],
            "key": "eRCxBdEzQE9j"
          },
          "x-gitbook-description-html": "<p>Sui JSON-RPC API for interaction with Sui Full node.</p>"
        },
        "methods": []
      }
    }
  }
}

Externed API

suixGetDynamicFieldObject

Get dynamic field object

POST

https://sui.nownodes.io/

Returns information about a dynamic field object given a parent object ID and field name.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | object>required

Array with parent object ID and dynamic field name

Show child attributes

One of

Parent object ID

string

typestring

valuestring

idintegerrequired

Response

200OK

Successful response returning the dynamic field object information.

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve dynamic field object.

Authorization

ApiKeyAuthapiKey in header

Get dynamic field object

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_getDynamicFieldObject",
  "params": [
    "string"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "suix_getDynamicFieldObject",
  "params": [
    "string"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "data": {
      "objectId": "0x5ea6f7a348f4a7bd1a9ab069eb7f63865de3075cc5a4e62432f634b50fd2bb2b",
      "version": "1",
      "digest": "FnxePMX8y7AqX5mRL4nCcK4xecSrpHrd85c3sJDmh5uG",
      "type": "0x0000000000000000000000000000000000000000000000000000000000000009::test::TestField",
      "owner": {
        "AddressOwner": "0x013d1eb156edcc1bedc3b1af1be1fe41671856fd3450dc5574abd53c793c9f22"
      },
      "previousTransaction": "Faiv4yqGR4HjAW8WhMN1NHHNStxXgP3u22dVPyvLad2z",
      "storageRebate": "100",
      "content": {
        "dataType": "moveObject",
        "type": "0x0000000000000000000000000000000000000000000000000000000000000009::test::TestField",
        "fields": {}
      }
    }
  }
}

suix_getDynamicFields

Get Dynamic Fields

POST

https://sui.nownodes.io/

Return the list of dynamic field objects owned by an object

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsuix_getDynamicFieldsrequired

paramsArray<string | string | integer>required

Show child attributes

One of

Object ID to get dynamic fields for

string

Cursor for pagination (optional)

string

Limit of results per page (optional)

integer

Response

200OK

Successful response returning dynamic field objects

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Get Dynamic Fields

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getDynamicFields",
  "params": [
    "0xe15bb8de6dadd21835dfe44f4973139c15f93ddea0f8c3da994d9ead562ce76e",
    "0xa9334aeacc435c70ab9635e47a277d8f8dd9d87765d1aadec2db8cc24c312542",
    3
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getDynamicFields",
  "params": [
    "0xe15bb8de6dadd21835dfe44f4973139c15f93ddea0f8c3da994d9ead562ce76e",
    "0xa9334aeacc435c70ab9635e47a277d8f8dd9d87765d1aadec2db8cc24c312542",
    3
  ]
}

{
  "jsonrpc": "2.0",
  "result": {
    "data": [
      {
        "name": {
          "type": "0x0000000000000000000000000000000000000000000000000000000000000009::test::TestField",
          "value": "some_value"
        },
        "bcsName": "2F1KQ3miNpBx1RzoRr1MVYMraK7RV",
        "type": "DynamicField",
        "objectType": "test",
        "objectId": "0x36fdef6a382da344930c73d1298b0e9644b85ea6f7a348f4a7bd1a9ab069eb7f",
        "version": 1,
        "digest": "7hWCQjKfZf7oNLpSrhFJZEmYnpmSPzVLwJfFuHmMD9ct"
      }
    ],
    "nextCursor": "0x8a25d8876ea3c60e345ac3861444136b4a1b0b37a91692359a98496738a58c17",
    "hasNextPage": true
  },
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

suixGetOwnedObjects

Get objects owned by an address

POST

https://sui.nownodes.io/

Returns all objects owned by the specified sui address, with optional filtering and pagination.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | object>required

Show child attributes

One of

Owner sui address or cursor

string

Optional filter and options

object

idintegerrequired

Response

200OK

Successful response returning dynamic fields

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve owned objects.

Authorization

ApiKeyAuthapiKey in header

Get objects owned by an address

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_getOwnedObjects",
  "params": [
    "string"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "suix_getOwnedObjects",
  "params": [
    "string"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "data": [
      {
        "name": {
          "type": "0x0000000000000000000000000000000000000000000000000000000000000009::test::TestField",
          "value": "some_value"
        },
        "bcsName": "2F1KQ3miNpBx1RzoRr1MVYMraK7RV",
        "type": "DynamicField",
        "objectType": "test",
        "objectId": "0x36fdef6a382da344930c73d1298b0e9644b85ea6f7a348f4a7bd1a9ab069eb7f",
        "version": 1,
        "digest": "7hWCQjKfZf7oNLpSrhFJZEmYnpmSPzVLwJfFuHmMD9ct"
      }
    ],
    "nextCursor": "0x8a25d8876ea3c60e345ac3861444136b4a1b0b37a91692359a98496738a58c17",
    "hasNextPage": true
  }
}

suixQueryEvents

Query events with optional filters

POST

https://sui.nownodes.io/

Returns a list of events for the specified query criteria, supporting pagination and ordering.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<object | object | integer | boolean>required

Show child attributes

One of

Query criteria

object

Cursor for pagination

object

Maximum number of items per page

integer

Descending order flag

boolean

idintegerrequired

Response

200OK

Successful response returning a paginated list of events

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve events.

Authorization

ApiKeyAuthapiKey in header

Query events with optional filters

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_queryEvents",
  "params": [
    {}
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "suix_queryEvents",
  "params": [
    {}
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "data": [
      {
        "id": {
          "txDigest": "FUMhRSj76es8MYeaRYeaBnppk56cuEehKwL2CiU82U7B",
          "eventSeq": "1"
        },
        "packageId": "0xd3d707164b2a378eee639ebc2690873d2f7dd97d60bdd8f0b9935a5c791b096d",
        "transactionModule": "test",
        "sender": "0x84bd999f9ff7a1804872957fafa528628a24386298faa98850887f64da841b87",
        "type": "0x3::test::Test<0x3::test::Test>",
        "parsedJson": "some_value",
        "bcsEncoding": "base64",
        "bcs": ""
      }
    ],
    "nextCursor": {
      "txDigest": "EnySDWe22mnp35umt47kifqXvvchBqTzAoyoPXaH3rfK",
      "eventSeq": "1"
    },
    "hasNextPage": false
  }
}

suixQueryTransactionBlocks

Query transaction blocks with optional filters

POST

https://sui.nownodes.io/

Returns a list of transaction digests for the specified query criteria, supporting pagination and ordering.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<object | string | integer | boolean>required

Show child attributes

One of

Query criteria

object

Cursor for pagination

string

Maximum number of items per page

integer

Descending order flag

boolean

idintegerrequired

Response

200OK

Successful response returning a paginated list of transaction digests

400Bad Request

Bad Request — Invalid parameters.

401Unauthorized

Unauthorized — Missing or invalid API key.

500Internal Server Error

Internal Server Error — Could not retrieve transaction blocks.

Authorization

ApiKeyAuthapiKey in header

Query transaction blocks with optional filters

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "suix_queryTransactionBlocks",
  "params": [
    {}
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "suix_queryTransactionBlocks",
  "params": [
    {}
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "data": [
      {
        "digest": "GUPcK4cmRmgsTFr52ab9f6fnzNVg3Lz6hF2aXFcsRzaD"
      }
    ],
    "nextCursor": "3nek86HEjXZ7K3EtrAcBG4wMrCS21gqr8BqwwC6M6P7F",
    "hasNextPage": false
  }
}

suix_resolveNameServiceAddress

Resolve Name Service Address

POST

https://sui.nownodes.io/

Returns the resolved address for the provided domain name

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsuix_resolveNameServiceAddressrequired

paramsArray<string>required

Response

200OK

Successful response returning resolved address for the domain name

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Resolve Name Service Address

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_resolveNameServiceAddress",
  "params": [
    "example.sui"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_resolveNameServiceAddress",
  "params": [
    "example.sui"
  ]
}

{
  "jsonrpc": "2.0",
  "result": "0x70f2d83f980fe0996a92d351d6749a0a0b47998aaf3d11da24c49e014d4ccb1d",
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

suix_resolveNameServiceNames

Resolve Name Service Names

POST

https://sui.nownodes.io/

Return the resolved names given address, if multiple names are resolved, the first one is the primary name

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsuix_resolveNameServiceNamesrequired

paramsArray<string | string | integer>required

Show child attributes

One of

Address to resolve names for

string

Cursor for pagination (optional)

string

Limit of results per page (optional)

integer

Response

200OK

Successful response returning resolved names for the address

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Resolve Name Service Names

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_resolveNameServiceNames",
  "params": [
    "0xb01f2f3f227a90090e6777f19aa10fd9e64e29dd4e8da119481d1a7c3c050dc5",
    "0x7d0cd09d3cc1679290f1df2803b32b76ba0395dbb635e3fb7390f04e6567f739",
    3
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_resolveNameServiceNames",
  "params": [
    "0xb01f2f3f227a90090e6777f19aa10fd9e64e29dd4e8da119481d1a7c3c050dc5",
    "0x7d0cd09d3cc1679290f1df2803b32b76ba0395dbb635e3fb7390f04e6567f739",
    3
  ]
}

{
  "jsonrpc": "2.0",
  "result": {
    "data": [
      "example.sui"
    ],
    "nextCursor": "0x7d0cd09d3cc1679290f1df2803b32b76ba0395dbb635e3fb7390f04e6567f739",
    "hasNextPage": false
  },
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

Governance Read API

suix_getCommitteeInfo

Get Committee Info

POST

https://sui.nownodes.io/

Return the committee information for the asked epoch

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsuix_getCommitteeInforequired

paramsArray<string>required

Response

200OK

Successful response returning committee information

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Get Committee Info

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getCommitteeInfo",
  "params": [
    "5000"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getCommitteeInfo",
  "params": [
    "5000"
  ]
}

{
  "jsonrpc": "2.0",
  "result": {
    "epoch": "5000",
    "validators": [
      []
    ]
  },
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

suix_getLatestSuiSystemState

Get Latest Sui System State

POST

https://sui.nownodes.io/

Return the latest SUI system state object on-chain

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsuix_getLatestSuiSystemStaterequired

paramsarrayrequired

No parameters required for this method

Response

200OK

Successful response returning the latest SUI system state

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Get Latest Sui System State

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getLatestSuiSystemState",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getLatestSuiSystemState",
  "params": []
}

{
  "jsonrpc": "2.0",
  "result": "some_system_state",
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

suix_getReferenceGasPrice

Get Reference Gas Price

POST

https://sui.nownodes.io/

Return the reference gas price for the network

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsuix_getReferenceGasPricerequired

paramsarrayrequired

No parameters required for this method

Response

200OK

Successful response returning the reference gas price

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Get Reference Gas Price

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getReferenceGasPrice",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getReferenceGasPrice",
  "params": []
}

{
  "jsonrpc": "2.0",
  "result": 1000,
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

suix_getStakesByIds

Get Stakes By IDs

POST

https://sui.nownodes.io/

Return one or more [DelegatedStake]. If a Stake was withdrawn its status will be Unstaked.

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsuix_getStakesByIdsrequired

paramsArray<Array<string>>required

Response

200OK

Successful response returning delegated stakes by IDs

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Get Stakes By IDs

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getStakesByIds",
  "params": [
    [
      "0xb2a5bea2e681ea5af4e59bd1abb0bb4fcb2747866ff92885a3c21a7703f56472",
      "0x1c198308aa0c71b771ada6b96c16fc9c0fa754b3c61936f77fcfdaa213c2f7b4"
    ]
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getStakesByIds",
  "params": [
    [
      "0xb2a5bea2e681ea5af4e59bd1abb0bb4fcb2747866ff92885a3c21a7703f56472",
      "0x1c198308aa0c71b771ada6b96c16fc9c0fa754b3c61936f77fcfdaa213c2f7b4"
    ]
  ]
}

{
  "jsonrpc": "2.0",
  "result": {
    "validatorAddress": "0xfb1b51ef9f3ed66000c0e45697dbee0954790a7b5c15ad7354f23b968be8bb06",
    "stakingPool": "0x03d47b901cb7b3177a791cd29bb5304037fea6ced287081357950315a8842c38",
    "stakes": [
      {
        "stakedSuiId": "0xb2a5bea2e681ea5af4e59bd1abb0bb4fcb2747866ff92885a3c21a7703f56472",
        "stakeRequestEpoch": "62",
        "stakeActiveEpoch": "63",
        "principal": "200000000000",
        "status": "Active",
        "estimatedReward": "520000000"
      }
    ]
  },
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

suix_getStakes

Get Stakes

POST

https://sui.nownodes.io/

Return all [DelegatedStake] for an address

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsuix_getStakesrequired

paramsArray<string>required

Response

200OK

Successful response returning all delegated stakes

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Get Stakes

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getStakes",
  "params": [
    "0xb5387b29a731d26d98108d7abc4902107d7d6a8e0f8fea6fda5488462e58724c"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getStakes",
  "params": [
    "0xb5387b29a731d26d98108d7abc4902107d7d6a8e0f8fea6fda5488462e58724c"
  ]
}

{
  "jsonrpc": "2.0",
  "result": [
    {
      "validatorAddress": "0x034462b6064a08845e2ae2942fe7c4ee816d754eb2eed23e6c6bb32c89fe1f21",
      "stakingPool": "0xab588374445e72e0402aea014b295610579963ee67e81398729f87d81d62f399",
      "stakes": [
        {
          "stakedSuiId": "0xc041b0f8d0938923ea7e3917608ee62df4376710024f81dd33ab6833482ee803",
          "stakeRequestEpoch": "62",
          "stakeActiveEpoch": "63",
          "principal": "200000000000",
          "status": "Active",
          "estimatedReward": "520000000"
        }
      ]
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

suix_getValidatorsApy

Get Validators APY

POST

https://sui.nownodes.io/

Return the validator APY

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsuix_getValidatorsApyrequired

paramsarrayrequired

No parameters required for this method

Response

200OK

Successful response returning validator APYs

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Get Validators APY

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getValidatorsApy",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "suix_getValidatorsApy",
  "params": []
}

{
  "jsonrpc": "2.0",
  "result": {
    "apys": [
      {
        "address": "0xb7d1cb695b9491893f88a5ae1b9d4f235b3c7e00acf5386662fa062483ba507b",
        "apy": 0.06
      }
    ],
    "epoch": "420"
  },
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

Move Utils

sui_getMoveFunctionArgTypes

Get Move Function Argument Types

POST

https://sui.nownodes.io/

Returns the argument types for the package and function the request provides.

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getMoveFunctionArgTypesrequired

paramsArray<any>required

Response

200OK

Successful response returning Move function argument types

400Bad Request

Bad request - invalid parameters

500Internal Server Error

Internal server error

Authorization

apiKeyapiKey in header

Get Move Function Argument Types

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getMoveFunctionArgTypes",
  "params": [
    "0x007efb0f94f1e64d2e8090c619a39299d87ee8070b5f56bb10bafa0e2261d819",
    "suifrens",
    "mint"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getMoveFunctionArgTypes",
  "params": [
    "0x007efb0f94f1e64d2e8090c619a39299d87ee8070b5f56bb10bafa0e2261d819",
    "suifrens",
    "mint"
  ]
}

{
  "jsonrpc": "2.0",
  "result": [
    {
      "Object": "ByMutableReference"
    },
    "Pure",
    "Pure",
    {
      "Object": "ByValue"
    },
    {
      "Object": "ByImmutableReference"
    },
    {
      "Object": "ByValue"
    },
    {
      "Object": "ByMutableReference"
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal error"
  },
  "id": 1
}

sui_getNormalizedMoveFunction

Get normalized Move function

POST

https://sui.nownodes.io/

Returns a structured representation of the specified Move function in a package.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

idintegerrequired

Response

200OK

Normalized representation of the Move function

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get normalized Move function

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "sui_getNormalizedMoveFunction",
  "params": [
    "0x1639f3606a53f61f3a566963b3eac49fe3bb57d304a454ed2f4859b44f4e4918",
    "moduleName",
    "functionName"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "sui_getNormalizedMoveFunction",
  "params": [
    "0x1639f3606a53f61f3a566963b3eac49fe3bb57d304a454ed2f4859b44f4e4918",
    "moduleName",
    "functionName"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "visibility": "Public",
    "isEntry": false,
    "typeParameters": [
      {
        "abilities": [
          "Store"
        ]
      }
    ],
    "parameters": [
      "U64"
    ],
    "return": [
      "U64"
    ]
  }
}

sui_getNormalizedMoveModule

Get Normalized Move Module

POST

https://sui.nownodes.io/

Return a structured representation of Move module

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getNormalizedMoveModulerequired

paramsArray<any>required

Response

200OK

Successful response returning normalized Move module

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Get Normalized Move Module

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getNormalizedMoveModule",
  "params": [
    "0x16dc6797cf787c839a07edc03e633842109123618df6438d21a48040e6bb568c",
    "module"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getNormalizedMoveModule",
  "params": [
    "0x16dc6797cf787c839a07edc03e633842109123618df6438d21a48040e6bb568c",
    "module"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "fileFormatVersion": 6,
    "address": "0x43cc4c24010dafad05b12619b275649741cc9060d87664c26a3f9a509228c21b",
    "name": "module",
    "friends": [],
    "structs": {},
    "exposedFunctions": {}
  },
  "id": 1
}

sui_getNormalizedMoveModulesByPackage

Get Normalized Move Modules By Package

POST

https://sui.nownodes.io/

Return structured representations of all modules in the given package

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getNormalizedMoveModulesByPackagerequired

paramsArray<string>required

Response

200OK

Successful response returning normalized Move modules

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Get Normalized Move Modules By Package

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getNormalizedMoveModulesByPackage",
  "params": [
    "0xece356d10d89e75f565b0934851ba8d5bc59462a46078b90f1f508a1e4fd4eed"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getNormalizedMoveModulesByPackage",
  "params": [
    "0xece356d10d89e75f565b0934851ba8d5bc59462a46078b90f1f508a1e4fd4eed"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "fileFormatVersion": 6,
    "address": "0xafc13246bd847c60448160e0358cac4a11345594d02890c986dbf328d28d21ac",
    "name": "module",
    "friends": [],
    "structs": {},
    "exposedFunctions": {}
  },
  "id": 1
}

sui_getNormalizedMoveStruct

Get normalized Move struct

POST

https://sui.nownodes.io/

Returns a structured representation of a Move struct for the specified package, module, and struct name.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

idintegerrequired

Response

200OK

Normalized Move struct representation

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get normalized Move struct

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "sui_getNormalizedMoveStruct",
  "params": [
    "0x77b3482580ee8d5bdc5b824808df54bfec4fc817622e5add0e48f749f01def98",
    "module",
    "StructName"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "sui_getNormalizedMoveStruct",
  "params": [
    "0x77b3482580ee8d5bdc5b824808df54bfec4fc817622e5add0e48f749f01def98",
    "module",
    "StructName"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "abilities": {
      "abilities": [
        "Store",
        "Key"
      ]
    },
    "typeParameters": [],
    "fields": []
  }
}

Read API

sui_getChainIdentifier

Get chain identifier

POST

https://sui.nownodes.io/

Returns the first four bytes of the chain's genesis checkpoint digest.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<any>required

idintegerrequired

Response

200OK

Chain identifier (first 4 bytes of genesis checkpoint digest)

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get chain identifier

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "sui_getChainIdentifier",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "sui_getChainIdentifier",
  "params": [],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "4c78adac"
}

sui_getCheckpoint

Get checkpoint

POST

https://sui.nownodes.io/

Returns the checkpoint for a given checkpoint digest or sequence number.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

idintegerrequired

Response

200OK

Checkpoint information for the given ID

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get checkpoint

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "sui_getCheckpoint",
  "params": [
    "1000"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "sui_getCheckpoint",
  "params": [
    "1000"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "epoch": "5000",
    "sequenceNumber": "1000",
    "digest": "G6Dtzr1ZSfHFhotGsTE3cLENa7L1ooe1BBvknAUsARbV",
    "networkTotalTransactions": "792385",
    "previousDigest": "6tBy8RXZKrdrB4XkMQn7J3MNG4fQCo9XcRduFFvYrL5Z",
    "epochRollingGasCostSummary": {
      "computationCost": "0",
      "computationCostBurned": "0",
      "storageCost": "0",
      "storageRebate": "0",
      "nonRefundableStorageFee": "0"
    },
    "timestampMs": "1676911928",
    "transactions": [
      "mN8YNBgVR3wB7vfXmjVgDRF4oqxVRRjzmJ6U4mzbq77"
    ],
    "checkpointCommitments": [],
    "validatorSignature": "wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
  }
}

sui_getCheckpoints

Get Checkpoints

POST

https://sui.nownodes.io/

Return paginated list of checkpoints

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getCheckpointsrequired

paramsArray<string | integer | boolean>required

Show child attributes

One of

Starting checkpoint sequence number (optional)

string

Limit of results per page (optional)

integer

Whether to return transactions in the checkpoint (optional)

boolean

Response

200OK

Successful response returning paginated checkpoints

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get Checkpoints

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getCheckpoints",
  "params": [
    "1004",
    4,
    false
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getCheckpoints",
  "params": [
    "1004",
    4,
    false
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "data": [
      {
        "epoch": "5000",
        "sequenceNumber": "1005",
        "digest": "9zA7Q9Ka1ykvYjSQGhQCdCf32FZkcWNWx7L22JczXGsk",
        "networkTotalTransactions": "792385",
        "previousDigest": "8BLFxLTjWZ2KqaGc3FjR1o9aL6kbyYrmhuNfJLU1ehYt",
        "epochRollingGasCostSummary": {
          "computationCost": "0",
          "storageCost": "0",
          "storageRebate": "0",
          "nonRefundableStorageFee": "0"
        },
        "timestampMs": "1676911928",
        "transactions": [
          "7RudGLkQDBNJyqrptkrNU66Zd3pvq8MHVAHYz9WpBm59"
        ],
        "checkpointCommitments": [],
        "validatorSignature": "wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
      }
    ],
    "nextCursor": "1008",
    "hasNextPage": true
  },
  "id": 1
}

sui_getEvents

Get Events

POST

https://sui.nownodes.io/

Return transaction events

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getEventsrequired

paramsArray<string>required

Response

200OK

Successful response returning transaction events

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get Events

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getEvents",
  "params": [
    "11a72GCQ5hGNpWGh2QhQkkusTEGS6EDqifJqxr7nSYX"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getEvents",
  "params": [
    "11a72GCQ5hGNpWGh2QhQkkusTEGS6EDqifJqxr7nSYX"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "data": [
      {
        "id": {
          "txDigest": "11a72GCQ5hGNpWGh2QhQkkusTEGS6EDqifJqxr7nSYX",
          "eventSeq": "0"
        },
        "packageId": "0xc54ab30a3d9adc07c1429c4d6bbecaf9457c9af77a91f631760853934d383634",
        "transactionModule": "test_module",
        "sender": "0xbcf7c32655009a61f1de0eae420a2e4ae1bb772ab2dd5d5a7dfa949c0ef06908",
        "type": "0x0000000000000000000000000000000000000000000000000000000000000009::test::TestEvent",
        "parsedJson": {
          "test": "example value"
        },
        "bcs": ""
      }
    ],
    "nextCursor": {
      "txDigest": "11a72GCQ5hGNpWGh2QhQkkusTEGS6EDqifJqxr7nSYX",
      "eventSeq": "5"
    },
    "hasNextPage": false
  },
  "id": 1
}

sui_getLatestCheckpointSequenceNumber

Get Latest Checkpoint Sequence Number

POST

https://sui.nownodes.io/

Return the sequence number of the latest checkpoint that has been executed

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getLatestCheckpointSequenceNumberrequired

paramsarrayrequired

No parameters required for this method

Response

200OK

Successful response returning the latest checkpoint sequence number

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get Latest Checkpoint Sequence Number

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getLatestCheckpointSequenceNumber",
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getLatestCheckpointSequenceNumber",
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "result": "507021",
  "id": 1
}

sui_getLoadedChildObjects

Get Loaded Child Objects

POST

https://sui.nownodes.io/

Gets loaded child objects associated with the transaction the request provides.

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getLoadedChildObjectsrequired

paramsArray<string>required

Response

200OK

Successful response returning loaded child objects

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get Loaded Child Objects

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getLoadedChildObjects",
  "params": [
    "6hpz6Qxv6t5VkNT5rcBKQS2Jootr6WHuSuRMLmmN13Jg"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getLoadedChildObjects",
  "params": [
    "6hpz6Qxv6t5VkNT5rcBKQS2Jootr6WHuSuRMLmmN13Jg"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "loadedChildObjects": [
      {
        "objectId": "0xb6a23efeb7298cf0a8d0b837b78749c2cfc711c42036cc6b76211639f3606a53",
        "sequenceNumber": "2462820"
      }
    ]
  },
  "id": 1
}

sui_getObject

Get Object

POST

https://sui.nownodes.io/

Return the object information for a specified object

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getObjectrequired

paramsArray<any>required

Response

200OK

Successful response returning object information

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get Object

curl -X POST 'https://sui.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_getObject",
    "params": [
      "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
      {
        "showType": true,
        "showOwner": true,
        "showPreviousTransaction": true,
        "showDisplay": false,
        "showContent": true,
        "showBcs": false,
        "showStorageRebate": true
      }
    ]
  }'

const response = await fetch('https://sui.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "sui_getObject",
      "params": [
        "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
        {
          "showType": true,
          "showOwner": true,
          "showPreviousTransaction": true,
          "showDisplay": false,
          "showContent": true,
          "showBcs": false,
          "showStorageRebate": true
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getObject",
  "params": [
    "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
    {
      "showType": True,
      "showOwner": True,
      "showPreviousTransaction": True,
      "showDisplay": False,
      "showContent": True,
      "showBcs": False,
      "showStorageRebate": True
    }
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getObject",
  "params": [
    "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
    {
      "showType": true,
      "showOwner": true,
      "showPreviousTransaction": true,
      "showDisplay": false,
      "showContent": true,
      "showBcs": false,
      "showStorageRebate": true
    }
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "data": {
      "objectId": "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
      "version": "1",
      "digest": "33K5ZXJ3RyubvYaHuEnQ1QXmmbhgtrFwp199dnEbL4n7",
      "type": "0x2::coin::Coin<0x2::sui::SUI>",
      "owner": {
        "AddressOwner": "0xc8ec1d5b84dd6289e193b9f88de4a994358c9f856135236c3e75a925e1c77ac3"
      },
      "previousTransaction": "5PLgmQye6rraDYqpV3npV6H1cUXoJZgJh1dPCyRa3WCv",
      "storageRebate": "100",
      "content": {
        "dataType": "moveObject",
        "type": "0x2::coin::Coin<0x2::sui::SUI>",
        "hasPublicTransfer": true,
        "fields": {
          "balance": "100000000",
          "id": {
            "id": "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809"
          }
        }
      }
    }
  },
  "id": 1
}

Get Object

POST

https://sui.nownodes.io/

Return the object information for a specified object

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getObjectrequired

paramsArray<any>required

Response

200OK

Successful response returning object information

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get Object

curl -X POST 'https://sui.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_getObject",
    "params": [
      "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
      {
        "showType": true,
        "showOwner": true,
        "showPreviousTransaction": true,
        "showDisplay": false,
        "showContent": true,
        "showBcs": false,
        "showStorageRebate": true
      }
    ]
  }'

const response = await fetch('https://sui.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "sui_getObject",
      "params": [
        "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
        {
          "showType": true,
          "showOwner": true,
          "showPreviousTransaction": true,
          "showDisplay": false,
          "showContent": true,
          "showBcs": false,
          "showStorageRebate": true
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getObject",
  "params": [
    "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
    {
      "showType": True,
      "showOwner": True,
      "showPreviousTransaction": True,
      "showDisplay": False,
      "showContent": True,
      "showBcs": False,
      "showStorageRebate": True
    }
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getObject",
  "params": [
    "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
    {
      "showType": true,
      "showOwner": true,
      "showPreviousTransaction": true,
      "showDisplay": false,
      "showContent": true,
      "showBcs": false,
      "showStorageRebate": true
    }
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "data": {
      "objectId": "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
      "version": "1",
      "digest": "33K5ZXJ3RyubvYaHuEnQ1QXmmbhgtrFwp199dnEbL4n7",
      "type": "0x2::coin::Coin<0x2::sui::SUI>",
      "owner": {
        "AddressOwner": "0xc8ec1d5b84dd6289e193b9f88de4a994358c9f856135236c3e75a925e1c77ac3"
      },
      "previousTransaction": "5PLgmQye6rraDYqpV3npV6H1cUXoJZgJh1dPCyRa3WCv",
      "storageRebate": "100",
      "content": {
        "dataType": "moveObject",
        "type": "0x2::coin::Coin<0x2::sui::SUI>",
        "hasPublicTransfer": true,
        "fields": {
          "balance": "100000000",
          "id": {
            "id": "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809"
          }
        }
      }
    }
  },
  "id": 1
}

sui_getProtocolConfig

Get Protocol Config

POST

https://sui.nownodes.io/

Return the protocol config table for the given version number. If the version number is not specified, the node uses the version of the latest epoch it has processed.

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_getProtocolConfigrequired

paramsArray<integer>required

Response

200OK

Successful response returning protocol configuration

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Get Protocol Config

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getProtocolConfig",
  "params": [
    6
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getProtocolConfig",
  "params": [
    6
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "minSupportedProtocolVersion": "1",
    "maxSupportedProtocolVersion": "44",
    "protocolVersion": "6",
    "featureFlags": {
      "accept_zklogin_in_multisig": false,
      "advance_epoch_start_time_in_safe_mode": true,
      "advance_to_highest_supported_protocol_version": false
    },
    "attributes": {}
  },
  "id": 1
}

sui_tryGetPastObject

Try Get Past Object

POST

https://sui.nownodes.io/

Note there is no software-level guarantee/SLA that objects with past versions can be retrieved by this API, even if the object and version exists/existed. The result may vary across nodes depending on their pruning policies. Return the object information for a specified version.

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_tryGetPastObjectrequired

paramsArray<any>required

Response

200OK

Successful response returning past object information

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Try Get Past Object

curl -X POST 'https://sui.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_tryGetPastObject",
    "params": [
      "0x11af4b844ff94b3fbef6e36b518da3ad4c5856fa686464524a876b463d129760",
      4,
      {
        "showType": true,
        "showOwner": true,
        "showPreviousTransaction": true,
        "showDisplay": false,
        "showContent": true,
        "showBcs": false,
        "showStorageRebate": true
      }
    ]
  }'

const response = await fetch('https://sui.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "sui_tryGetPastObject",
      "params": [
        "0x11af4b844ff94b3fbef6e36b518da3ad4c5856fa686464524a876b463d129760",
        4,
        {
          "showType": true,
          "showOwner": true,
          "showPreviousTransaction": true,
          "showDisplay": false,
          "showContent": true,
          "showBcs": false,
          "showStorageRebate": true
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_tryGetPastObject",
  "params": [
    "0x11af4b844ff94b3fbef6e36b518da3ad4c5856fa686464524a876b463d129760",
    4,
    {
      "showType": True,
      "showOwner": True,
      "showPreviousTransaction": True,
      "showDisplay": False,
      "showContent": True,
      "showBcs": False,
      "showStorageRebate": True
    }
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_tryGetPastObject",
  "params": [
    "0x11af4b844ff94b3fbef6e36b518da3ad4c5856fa686464524a876b463d129760",
    4,
    {
      "showType": true,
      "showOwner": true,
      "showPreviousTransaction": true,
      "showDisplay": false,
      "showContent": true,
      "showBcs": false,
      "showStorageRebate": true
    }
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "status": "VersionFound",
    "details": {
      "objectId": "0x11af4b844ff94b3fbef6e36b518da3ad4c5856fa686464524a876b463d129760",
      "version": "4",
      "digest": "5VPAwDXy3BL72ehFc7gSJoz27ahMd6spUg5YwYc4ibcv",
      "type": "0x2::coin::Coin<0x2::sui::SUI>",
      "owner": {
        "AddressOwner": "0x3568c40e814d9d5396d23087a0fd641e91e0e00df6c012cded9ef9ba5e5bf042"
      },
      "previousTransaction": "5jQByoouHBwaico5pQB73GdbzerC2StjTiHh5garBjiV",
      "storageRebate": "100",
      "content": {
        "dataType": "moveObject",
        "type": "0x2::coin::Coin<0x2::sui::SUI>",
        "hasPublicTransfer": true,
        "fields": {
          "balance": "10000",
          "id": {
            "id": "0x11af4b844ff94b3fbef6e36b518da3ad4c5856fa686464524a876b463d129760"
          }
        }
      }
    }
  },
  "id": 1
}

sui_tryMultiGetPastObjects

Try Multi Get Past Objects

POST

https://sui.nownodes.io/

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_tryMultiGetPastObjectsrequired

paramsArray<any>required

Response

200OK

Successful response returning multiple past object information

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Try Multi Get Past Objects

curl -X POST 'https://sui.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_tryMultiGetPastObjects",
    "params": [
      [
        {
          "objectId": "0x5056aa3325512c8af40b9f5fd7065c83ded900657eac70a7979c2541646fa449",
          "version": "4"
        },
        {
          "objectId": "0xe81109dc075f537067726d63dd5287100e177404a969989215da2abfbfc098cf",
          "version": "12"
        }
      ],
      {
        "showType": true,
        "showOwner": true,
        "showPreviousTransaction": true,
        "showDisplay": false,
        "showContent": true,
        "showBcs": false,
        "showStorageRebate": true
      }
    ]
  }'

const response = await fetch('https://sui.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "sui_tryMultiGetPastObjects",
      "params": [
        [
          {
            "objectId": "0x5056aa3325512c8af40b9f5fd7065c83ded900657eac70a7979c2541646fa449",
            "version": "4"
          },
          {
            "objectId": "0xe81109dc075f537067726d63dd5287100e177404a969989215da2abfbfc098cf",
            "version": "12"
          }
        ],
        {
          "showType": true,
          "showOwner": true,
          "showPreviousTransaction": true,
          "showDisplay": false,
          "showContent": true,
          "showBcs": false,
          "showStorageRebate": true
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_tryMultiGetPastObjects",
  "params": [
    [
      {
        "objectId": "0x5056aa3325512c8af40b9f5fd7065c83ded900657eac70a7979c2541646fa449",
        "version": "4"
      },
      {
        "objectId": "0xe81109dc075f537067726d63dd5287100e177404a969989215da2abfbfc098cf",
        "version": "12"
      }
    ],
    {
      "showType": True,
      "showOwner": True,
      "showPreviousTransaction": True,
      "showDisplay": False,
      "showContent": True,
      "showBcs": False,
      "showStorageRebate": True
    }
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_tryMultiGetPastObjects",
  "params": [
    [
      {
        "objectId": "0x5056aa3325512c8af40b9f5fd7065c83ded900657eac70a7979c2541646fa449",
        "version": "4"
      },
      {
        "objectId": "0xe81109dc075f537067726d63dd5287100e177404a969989215da2abfbfc098cf",
        "version": "12"
      }
    ],
    {
      "showType": true,
      "showOwner": true,
      "showPreviousTransaction": true,
      "showDisplay": false,
      "showContent": true,
      "showBcs": false,
      "showStorageRebate": true
    }
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": [
    {
      "status": "VersionFound",
      "details": {
        "objectId": "0x5056aa3325512c8af40b9f5fd7065c83ded900657eac70a7979c2541646fa449",
        "version": "4",
        "digest": "F34PCnEHm5GAP5ksDKPSdRMKz49JiqrvLUTZsiojqJS2",
        "type": "0x2::coin::Coin<0x2::sui::SUI>",
        "owner": {
          "AddressOwner": "0xfde53941b2a08a8bf752c20979842732ac019f52835282744318d6d84f3c52b3"
        },
        "previousTransaction": "EMLrFqmDkZtFvidxKy1T8bwAiHnUiLqramE58kSUcAf8",
        "storageRebate": "100",
        "content": {
          "dataType": "moveObject",
          "type": "0x2::coin::Coin<0x2::sui::SUI>",
          "hasPublicTransfer": true,
          "fields": {
            "balance": "10000",
            "id": {
              "id": "0x5056aa3325512c8af40b9f5fd7065c83ded900657eac70a7979c2541646fa449"
            }
          }
        }
      }
    }
  ],
  "id": 1
}

Write API

sui_devInspectTransactionBlock

Dev Inspect Transaction Block

POST

https://sui.nownodes.io/

Runs the transaction in dev-inspect mode. Which allows for nearly any transaction (or Move call) with any arguments. Detailed results are provided, including both the transaction effects and any return values.

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_devInspectTransactionBlockrequired

paramsArray<any>required

Response

200OK

Successful response returning dev inspection results

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Dev Inspect Transaction Block

curl -X POST 'https://sui.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_devInspectTransactionBlock",
    "params": [
      "0xd70420418b84502e506794227f897237764dde8d79a01ab2104bf742a277a2ab",
      "AAACACBnxtMcbJcOVn8D72fYEaT4Q2ZbjePygvpIs+AQO6m77QEAagYVO5/EhuEB8OnicDrIZm0GrsxN3355JqNhlwxlpbECAAAAAAAAACDoQ3EipycU+/EOvBcDPFtMkZiSbdzWAw3CwdmQCAtBWAEBAQEBAAEAAC9cVD1xauQ9RT3rOxmbva8bxwMMdoL4dwPc5DEkj+3gASxDgF0Nb1QCp60Npb3sVJx83qBrxKHTOaIlIe6pM7iJAgAAAAAAAAAgnvsgc1pPauyCE27/c+aBnHN3fSsxRAWdEJYzYFOryNAvXFQ9cWrkPUU96zsZm72vG8cDDHaC+HcD3OQxJI/t4AoAAAAAAAAAoIYBAAAAAAAA",
      1000,
      8888,
      null
    ]
  }'

const response = await fetch('https://sui.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "sui_devInspectTransactionBlock",
      "params": [
        "0xd70420418b84502e506794227f897237764dde8d79a01ab2104bf742a277a2ab",
        "AAACACBnxtMcbJcOVn8D72fYEaT4Q2ZbjePygvpIs+AQO6m77QEAagYVO5/EhuEB8OnicDrIZm0GrsxN3355JqNhlwxlpbECAAAAAAAAACDoQ3EipycU+/EOvBcDPFtMkZiSbdzWAw3CwdmQCAtBWAEBAQEBAAEAAC9cVD1xauQ9RT3rOxmbva8bxwMMdoL4dwPc5DEkj+3gASxDgF0Nb1QCp60Npb3sVJx83qBrxKHTOaIlIe6pM7iJAgAAAAAAAAAgnvsgc1pPauyCE27/c+aBnHN3fSsxRAWdEJYzYFOryNAvXFQ9cWrkPUU96zsZm72vG8cDDHaC+HcD3OQxJI/t4AoAAAAAAAAAoIYBAAAAAAAA",
        1000,
        8888,
        null
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_devInspectTransactionBlock",
  "params": [
    "0xd70420418b84502e506794227f897237764dde8d79a01ab2104bf742a277a2ab",
    "AAACACBnxtMcbJcOVn8D72fYEaT4Q2ZbjePygvpIs+AQO6m77QEAagYVO5/EhuEB8OnicDrIZm0GrsxN3355JqNhlwxlpbECAAAAAAAAACDoQ3EipycU+/EOvBcDPFtMkZiSbdzWAw3CwdmQCAtBWAEBAQEBAAEAAC9cVD1xauQ9RT3rOxmbva8bxwMMdoL4dwPc5DEkj+3gASxDgF0Nb1QCp60Npb3sVJx83qBrxKHTOaIlIe6pM7iJAgAAAAAAAAAgnvsgc1pPauyCE27/c+aBnHN3fSsxRAWdEJYzYFOryNAvXFQ9cWrkPUU96zsZm72vG8cDDHaC+HcD3OQxJI/t4AoAAAAAAAAAoIYBAAAAAAAA",
    1000,
    8888,
    null
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_devInspectTransactionBlock",
  "params": [
    "0xd70420418b84502e506794227f897237764dde8d79a01ab2104bf742a277a2ab",
    "AAACACBnxtMcbJcOVn8D72fYEaT4Q2ZbjePygvpIs+AQO6m77QEAagYVO5/EhuEB8OnicDrIZm0GrsxN3355JqNhlwxlpbECAAAAAAAAACDoQ3EipycU+/EOvBcDPFtMkZiSbdzWAw3CwdmQCAtBWAEBAQEBAAEAAC9cVD1xauQ9RT3rOxmbva8bxwMMdoL4dwPc5DEkj+3gASxDgF0Nb1QCp60Npb3sVJx83qBrxKHTOaIlIe6pM7iJAgAAAAAAAAAgnvsgc1pPauyCE27/c+aBnHN3fSsxRAWdEJYzYFOryNAvXFQ9cWrkPUU96zsZm72vG8cDDHaC+HcD3OQxJI/t4AoAAAAAAAAAoIYBAAAAAAAA",
    1000,
    8888,
    null
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "effects": {
      "messageVersion": "v1",
      "status": {
        "status": "success"
      },
      "executedEpoch": "0",
      "gasUsed": {
        "computationCost": "100",
        "storageCost": "100",
        "storageRebate": "10",
        "nonRefundableStorageFee": "0"
      },
      "transactionDigest": "76gyHCk7FRrGACRqXM7Ybj5uJLtAzgEMJ5P9CeEzxZSG",
      "mutated": [
        {
          "owner": {
            "AddressOwner": "0x2f5c543d716ae43d453deb3b199bbdaf1bc7030c7682f87703dce431248fede0"
          },
          "reference": {
            "objectId": "0x2c43805d0d6f5402a7ad0da5bdec549c7cdea06bc4a1d339a22521eea933b889",
            "version": 2,
            "digest": "BhbWpBeESxuRWvmvLMyb2JNUuFa6j4aG1T4WUiPgKAHm"
          }
        }
      ],
      "gasObject": {
        "owner": {
          "ObjectOwner": "0x2f5c543d716ae43d453deb3b199bbdaf1bc7030c7682f87703dce431248fede0"
        },
        "reference": {
          "objectId": "0x2c43805d0d6f5402a7ad0da5bdec549c7cdea06bc4a1d339a22521eea933b889",
          "version": 2,
          "digest": "BhbWpBeESxuRWvmvLMyb2JNUuFa6j4aG1T4WUiPgKAHm"
        }
      },
      "eventsDigest": "6kerMphN4S5QTfd9TAhwMiFq1q9c2YwfpheBfWm85vUq"
    },
    "events": []
  },
  "id": 1
}

sui_dryRunTransactionBlock

Dry Run Transaction Block

POST

https://sui.nownodes.io/

Return transaction execution effects including the gas cost summary, while the effects are not committed to the chain.

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_dryRunTransactionBlockrequired

paramsArray<string>required

Response

200OK

Successful response returning dry run transaction results

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Dry Run Transaction Block

curl -X POST 'https://sui.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_dryRunTransactionBlock",
    "params": [
      "AAACACB7qR3cfnF89wjJNwYPBASHNuwz+xdG2Zml5YzVxnftgAEAT4LxyFh7mNZMAL+0bDhDvYv2zPp8ZahhOGmM0f3Kw9wCAAAAAAAAACCxDABG4pPAjOwPQHg9msS/SrtNf4IGR/2F0ZGD3ufH/wEBAQEBAAEAAGH7tbTzQqQL2/h/5KlGueONGM+P/HsAALl1F1x7apV2AejYx86GPzE9o9vZKoPvJtEouI/ma/JuDg0Jza9yfR2EAgAAAAAAAAAgzMqpegLMOpgEFnDhYJ23FOmFjJbp5GmFXxzzv9+X6GVh+7W080KkC9v4f+SpRrnjjRjPj/x7AAC5dRdce2qVdgoAAAAAAAAAoIYBAAAAAAAA"
    ]
  }'

const response = await fetch('https://sui.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "sui_dryRunTransactionBlock",
      "params": [
        "AAACACB7qR3cfnF89wjJNwYPBASHNuwz+xdG2Zml5YzVxnftgAEAT4LxyFh7mNZMAL+0bDhDvYv2zPp8ZahhOGmM0f3Kw9wCAAAAAAAAACCxDABG4pPAjOwPQHg9msS/SrtNf4IGR/2F0ZGD3ufH/wEBAQEBAAEAAGH7tbTzQqQL2/h/5KlGueONGM+P/HsAALl1F1x7apV2AejYx86GPzE9o9vZKoPvJtEouI/ma/JuDg0Jza9yfR2EAgAAAAAAAAAgzMqpegLMOpgEFnDhYJ23FOmFjJbp5GmFXxzzv9+X6GVh+7W080KkC9v4f+SpRrnjjRjPj/x7AAC5dRdce2qVdgoAAAAAAAAAoIYBAAAAAAAA"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_dryRunTransactionBlock",
  "params": [
    "AAACACB7qR3cfnF89wjJNwYPBASHNuwz+xdG2Zml5YzVxnftgAEAT4LxyFh7mNZMAL+0bDhDvYv2zPp8ZahhOGmM0f3Kw9wCAAAAAAAAACCxDABG4pPAjOwPQHg9msS/SrtNf4IGR/2F0ZGD3ufH/wEBAQEBAAEAAGH7tbTzQqQL2/h/5KlGueONGM+P/HsAALl1F1x7apV2AejYx86GPzE9o9vZKoPvJtEouI/ma/JuDg0Jza9yfR2EAgAAAAAAAAAgzMqpegLMOpgEFnDhYJ23FOmFjJbp5GmFXxzzv9+X6GVh+7W080KkC9v4f+SpRrnjjRjPj/x7AAC5dRdce2qVdgoAAAAAAAAAoIYBAAAAAAAA"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_dryRunTransactionBlock",
  "params": [
    "AAACACB7qR3cfnF89wjJNwYPBASHNuwz+xdG2Zml5YzVxnftgAEAT4LxyFh7mNZMAL+0bDhDvYv2zPp8ZahhOGmM0f3Kw9wCAAAAAAAAACCxDABG4pPAjOwPQHg9msS/SrtNf4IGR/2F0ZGD3ufH/wEBAQEBAAEAAGH7tbTzQqQL2/h/5KlGueONGM+P/HsAALl1F1x7apV2AejYx86GPzE9o9vZKoPvJtEouI/ma/JuDg0Jza9yfR2EAgAAAAAAAAAgzMqpegLMOpgEFnDhYJ23FOmFjJbp5GmFXxzzv9+X6GVh+7W080KkC9v4f+SpRrnjjRjPj/x7AAC5dRdce2qVdgoAAAAAAAAAoIYBAAAAAAAA"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "digest": "DNtx7EmGqSywGbnSC1CKoqmBFEXGvApXpRVt6bU855xP",
    "transaction": {
      "data": {
        "messageVersion": "v1",
        "transaction": {
          "kind": "ProgrammableTransaction",
          "inputs": [
            {}
          ],
          "transactions": [
            {}
          ]
        },
        "sender": "0x61fbb5b4f342a40bdbf87fe4a946b9e38d18cf8ffc7b0000b975175c7b6a9576",
        "gasData": {
          "payment": [
            {}
          ],
          "owner": "0x61fbb5b4f342a40bdbf87fe4a946b9e38d18cf8ffc7b0000b975175c7b6a9576",
          "price": "10",
          "budget": "100000"
        }
      },
      "txSignatures": [
        "string"
      ]
    },
    "rawTransaction": "AQAAAAAAAgAge6kd3H5xfPcIyTcGDwQEhzbsM/sXRtmZpeWM1cZ37YABAE+C8chYe5jWTAC/tGw4Q72L9sz6fGWoYThpjNH9ysPcAgAAAAAAAAAgsQwARuKTwIzsD0B4PZrEv0q7TX+CBkf9hdGRg97nx/8BAQEBAQABAABh+7W080KkC9v4f+SpRrnjjRjPj/x7AAC5dRdce2qVdgHo2MfOhj8xPaPb2SqD7ybRKLiP5mvybg4NCc2vcn0dhAIAAAAAAAAAIMzKqXoCzDqYBBZw4WCdtxTphYyW6eRphV8c87/fl+hlYfu1tPNCpAvb+H/kqUa5440Yz4/8ewAAuXUXXHtqlXYKAAAAAAAAAKCGAQAAAAAAAAFhAG+AHZMT7BZWQVagaGfENXyiFQ2nYRkG4XdnwqwToeJEmZ4J1IxKw0xKzTATGiUzFedY/nxKVuHikFibNlZ3wg9Dij1TvBYKLcfLNo8fq6GASb9yfo6uvuwNUBGkTf54wQ==",
    "effects": {
      "messageVersion": "v1",
      "status": {
        "status": "success"
      },
      "executedEpoch": "0",
      "gasUsed": {
        "computationCost": "100",
        "storageCost": "100",
        "storageRebate": "10",
        "nonRefundableStorageFee": "0"
      },
      "transactionDigest": "8UExPV121BEfWkbymSPDYhh23rVNh3MSWtC5juJ9JGMJ",
      "mutated": [
        {
          "owner": {
            "AddressOwner": "0x61fbb5b4f342a40bdbf87fe4a946b9e38d18cf8ffc7b0000b975175c7b6a9576"
          },
          "reference": {
            "objectId": "0xe8d8c7ce863f313da3dbd92a83ef26d128b88fe66bf26e0e0d09cdaf727d1d84",
            "version": 2,
            "digest": "EnRQXe1hDGAJCFyF2ds2GmPHdvf9V6yxf24LisEsDkYt"
          }
        }
      ],
      "gasObject": {
        "owner": {
          "ObjectOwner": "0x61fbb5b4f342a40bdbf87fe4a946b9e38d18cf8ffc7b0000b975175c7b6a9576"
        },
        "reference": {
          "objectId": "0xe8d8c7ce863f313da3dbd92a83ef26d128b88fe66bf26e0e0d09cdaf727d1d84",
          "version": 2,
          "digest": "EnRQXe1hDGAJCFyF2ds2GmPHdvf9V6yxf24LisEsDkYt"
        }
      },
      "eventsDigest": "55TNn3v5vpuXjQfjqamw76P9GZD522pumo4NuT7RYeFB"
    },
    "objectChanges": [
      {
        "type": "transferred",
        "sender": "0x61fbb5b4f342a40bdbf87fe4a946b9e38d18cf8ffc7b0000b975175c7b6a9576",
        "recipient": {
          "AddressOwner": "0x7ba91ddc7e717cf708c937060f04048736ec33fb1746d999a5e58cd5c677ed80"
        },
        "objectType": "0x2::example::Object",
        "objectId": "0x4f82f1c8587b98d64c00bfb46c3843bd8bf6ccfa7c65a86138698cd1fdcac3dc",
        "version": "2",
        "digest": "B3xLC8EbyvTxy5pgiwTNUzHLa6kS7uwD6sZdErKB8F8f"
      }
    ]
  },
  "id": 1
}

sui_executeTransactionBlock

Execute Transaction Block

POST

https://sui.nownodes.io/

Execute the transaction and wait for results if desired. Request types:

WaitForEffectsCert: waits for TransactionEffectsCert and then return to client. This mode is a proxy for transaction finality.
WaitForLocalExecution: waits for TransactionEffectsCert and make sure the node executed the transaction locally before returning the client. The local execution makes sure this node is aware of this transaction when client fires subsequent queries. However if the node fails to execute the transaction locally in a timely manner, a bool type in the response is set to false to indicated the case. request_type is default to be WaitForEffectsCert unless options.show_events or options.show_effects is true

Body

application/json

jsonrpcstring2.0required

idintegerrequired

methodstringsui_executeTransactionBlockrequired

paramsArray<any>required

Response

200OK

Successful response returning executed transaction results

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Authorization

ApiKeyAuthapiKey in header

Execute Transaction Block

curl -X POST 'https://sui.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_executeTransactionBlock",
    "params": [
      "AAACACBqEB6aOvXIBwES+Ahkizbvv43uihqC3kbZUE6WoRCKFwEAjvdvVsOZYzousxC8qRJOXy84znOeqsu2YAaIgE4HhEgCAAAAAAAAACB9w3+ufZMpihJFwxtCBojBaGy00TVtFxgN2C6TpIPFqwEBAQEBAAEAAAS0l6kWtGVmCaf6gnoJGE1vR2gdO6dM4NejbGSysfiHAZ+Q9/hmzCnfsdpjc86U+dldylpA9OF2mRjuv5+64AvTAgAAAAAAAAAgjleHL0UiRGjh/BfIFHCJ3EMY/dQA22c2TvNQyVJnbYUEtJepFrRlZgmn+oJ6CRhNb0doHTunTODXo2xksrH4hwoAAAAAAAAAoIYBAAAAAAAA",
      [
        "AKD4XdltkCyBi1Heb4EJJ3lzuV3F4u7+CYeaE+Fd7qXpaT17yd4tHWjMf4CWq3TuXBLxTpkc2MV39P6p7eMV8QnqvbuA0Q1Bqu4RHV3JPpqmH+C527hWJGUBOZN1j9sg8w=="
      ],
      {
        "showInput": true,
        "showRawInput": true,
        "showEffects": true,
        "showEvents": true,
        "showObjectChanges": true,
        "showBalanceChanges": true,
        "showRawEffects": false
      },
      "WaitForLocalExecution"
    ]
  }'

const response = await fetch('https://sui.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "sui_executeTransactionBlock",
      "params": [
        "AAACACBqEB6aOvXIBwES+Ahkizbvv43uihqC3kbZUE6WoRCKFwEAjvdvVsOZYzousxC8qRJOXy84znOeqsu2YAaIgE4HhEgCAAAAAAAAACB9w3+ufZMpihJFwxtCBojBaGy00TVtFxgN2C6TpIPFqwEBAQEBAAEAAAS0l6kWtGVmCaf6gnoJGE1vR2gdO6dM4NejbGSysfiHAZ+Q9/hmzCnfsdpjc86U+dldylpA9OF2mRjuv5+64AvTAgAAAAAAAAAgjleHL0UiRGjh/BfIFHCJ3EMY/dQA22c2TvNQyVJnbYUEtJepFrRlZgmn+oJ6CRhNb0doHTunTODXo2xksrH4hwoAAAAAAAAAoIYBAAAAAAAA",
        [
          "AKD4XdltkCyBi1Heb4EJJ3lzuV3F4u7+CYeaE+Fd7qXpaT17yd4tHWjMf4CWq3TuXBLxTpkc2MV39P6p7eMV8QnqvbuA0Q1Bqu4RHV3JPpqmH+C527hWJGUBOZN1j9sg8w=="
        ],
        {
          "showInput": true,
          "showRawInput": true,
          "showEffects": true,
          "showEvents": true,
          "showObjectChanges": true,
          "showBalanceChanges": true,
          "showRawEffects": false
        },
        "WaitForLocalExecution"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_executeTransactionBlock",
  "params": [
    "AAACACBqEB6aOvXIBwES+Ahkizbvv43uihqC3kbZUE6WoRCKFwEAjvdvVsOZYzousxC8qRJOXy84znOeqsu2YAaIgE4HhEgCAAAAAAAAACB9w3+ufZMpihJFwxtCBojBaGy00TVtFxgN2C6TpIPFqwEBAQEBAAEAAAS0l6kWtGVmCaf6gnoJGE1vR2gdO6dM4NejbGSysfiHAZ+Q9/hmzCnfsdpjc86U+dldylpA9OF2mRjuv5+64AvTAgAAAAAAAAAgjleHL0UiRGjh/BfIFHCJ3EMY/dQA22c2TvNQyVJnbYUEtJepFrRlZgmn+oJ6CRhNb0doHTunTODXo2xksrH4hwoAAAAAAAAAoIYBAAAAAAAA",
    [
      "AKD4XdltkCyBi1Heb4EJJ3lzuV3F4u7+CYeaE+Fd7qXpaT17yd4tHWjMf4CWq3TuXBLxTpkc2MV39P6p7eMV8QnqvbuA0Q1Bqu4RHV3JPpqmH+C527hWJGUBOZN1j9sg8w=="
    ],
    {
      "showInput": True,
      "showRawInput": True,
      "showEffects": True,
      "showEvents": True,
      "showObjectChanges": True,
      "showBalanceChanges": True,
      "showRawEffects": False
    },
    "WaitForLocalExecution"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_executeTransactionBlock",
  "params": [
    "AAACACBqEB6aOvXIBwES+Ahkizbvv43uihqC3kbZUE6WoRCKFwEAjvdvVsOZYzousxC8qRJOXy84znOeqsu2YAaIgE4HhEgCAAAAAAAAACB9w3+ufZMpihJFwxtCBojBaGy00TVtFxgN2C6TpIPFqwEBAQEBAAEAAAS0l6kWtGVmCaf6gnoJGE1vR2gdO6dM4NejbGSysfiHAZ+Q9/hmzCnfsdpjc86U+dldylpA9OF2mRjuv5+64AvTAgAAAAAAAAAgjleHL0UiRGjh/BfIFHCJ3EMY/dQA22c2TvNQyVJnbYUEtJepFrRlZgmn+oJ6CRhNb0doHTunTODXo2xksrH4hwoAAAAAAAAAoIYBAAAAAAAA",
    [
      "AKD4XdltkCyBi1Heb4EJJ3lzuV3F4u7+CYeaE+Fd7qXpaT17yd4tHWjMf4CWq3TuXBLxTpkc2MV39P6p7eMV8QnqvbuA0Q1Bqu4RHV3JPpqmH+C527hWJGUBOZN1j9sg8w=="
    ],
    {
      "showInput": true,
      "showRawInput": true,
      "showEffects": true,
      "showEvents": true,
      "showObjectChanges": true,
      "showBalanceChanges": true,
      "showRawEffects": false
    },
    "WaitForLocalExecution"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "digest": "Gx7V6EteEAqSsptc1kbi1nUEMP7mhr4qV2cYS7JjzbBd",
    "transaction": {
      "data": {
        "messageVersion": "v1",
        "transaction": {
          "kind": "ProgrammableTransaction",
          "inputs": [
            {}
          ],
          "transactions": [
            {}
          ]
        },
        "sender": "0x04b497a916b4656609a7fa827a09184d6f47681d3ba74ce0d7a36c64b2b1f887",
        "gasData": {
          "payment": [
            {}
          ],
          "owner": "0x04b497a916b4656609a7fa827a09184d6f47681d3ba74ce0d7a36c64b2b1f887",
          "price": "10",
          "budget": "100000"
        }
      },
      "txSignatures": [
        "string"
      ]
    },
    "rawTransaction": "AQAAAAAAAgAgahAemjr1yAcBEvgIZIs277+N7ooagt5G2VBOlqEQihcBAI73b1bDmWM6LrMQvKkSTl8vOM5znqrLtmAGiIBOB4RIAgAAAAAAAAAgfcN/rn2TKYoSRcMbQgaIwWhstNE1bRcYDdguk6SDxasBAQEBAQABAAAEtJepFrRlZgmn+oJ6CRhNb0doHTunTODXo2xksrH4hwGfkPf4Zswp37HaY3ce94f9d95dca5a40f3e1768e0b0wIAAAAAAAAAII5Xhy9FIkRo4fwXyBRwidxDGP3UANtnNk7zUMlSZ22FBLSXqRa0ZWYJp/qCegkYTW9HaB07p0zg16NsZLKx+IcKAAAAAAAAAKCGAQAAAAAAAAFhAKD4XdltkCyBi1Heb4EJJ3lzuV3F4u7+CYeaE+Fd7qXpaT17yd4tHWjMf4CWq3TuXBLxTpkc2MV39P6p7eMV8QnqvbuA0Q1Bqu4RHV3JPpqmH+C527hWJGUBOZN1j9sg8w==",
    "effects": {
      "messageVersion": "v1",
      "status": {
        "status": "success"
      },
      "executedEpoch": "0",
      "gasUsed": {
        "computationCost": "100",
        "storageCost": "100",
        "storageRebate": "10",
        "nonRefundableStorageFee": "0"
      },
      "transactionDigest": "9agZ3azEMgMqxrDVG8P4GddELfWag2HhimEkpjixHhGE",
      "mutated": [
        {
          "owner": {
            "AddressOwner": "0x04b497a916b4656609a7fa827a09184d6f47681d3ba74ce0d7a36c64b2b1f887"
          },
          "reference": {
            "objectId": "0x9f90f7f866cc29dfb1da6373ce94f9d95dca5a40f4e1769918eebf9fbae00bd3",
            "version": 2,
            "digest": "AaeJbTYkUuyromsivxzkoxSkHt7pCESTyQG7xz6nbQ2G"
          }
        }
      ],
      "gasObject": {
        "owner": {
          "ObjectOwner": "0x04b497a916b4656609a7fa827a09184d6f47681d3ba74ce0d7a36c64b2b1f887"
        },
        "reference": {
          "objectId": "0x9f90f7f866cc29dfb1da6373ce94f9d95dca5a40f4e1769918eebf9fbae00bd3",
          "version": 2,
          "digest": "AaeJbTYkUuyromsivxzkoxSkHt7pCESTyQG7xz6nbQ2G"
        }
      },
      "eventsDigest": "816hEv4WAW2reK9xkf11PeHiaZJrp7PQT9oGJZhdf9TN"
    },
    "objectChanges": [
      {
        "type": "transferred",
        "sender": "0x04b497a916b4656609a7fa827a09184d6f47681d3ba74ce0d7a36c64b2b1f887",
        "recipient": {
          "AddressOwner": "0x6a101e9a3af5c8070112f808648b36efbf8dee8a1a82de46d9504e96a1108a17"
        },
        "objectType": "0x2::example::Object",
        "objectId": "0x8ef76f56c399633a2eb310bca9124e5f2f38ce739eaacbb6600688804e078448",
        "version": "2",
        "digest": "7PsBHpUW6yfGNov2WrbVafLjgT9nYziQ3gVDbRq6zTbF"
      }
    ]
  },
  "id": 1
}

Documentation

Authentication

Coin Query API

suixGetAllCoins

Body

Response

Authorization

suixGetAllBalances

Body

Response

Authorization

suixGetBalance

Body

Response

Authorization

suixGetCoinMetadata

Body

Response

Authorization

suixGetCoins

Body

Response

Authorization

suixGetTotalSupply

Body

Response

Authorization

Discover

Discover

Body

Response

Authorization

Externed API

suixGetDynamicFieldObject

Body

Response

Authorization

suix_getDynamicFields

Body

Response

Authorization

suixGetOwnedObjects

Body

Response

Authorization

suixQueryEvents

Body

Response

Authorization

suixQueryTransactionBlocks

Body

Response

Authorization

suix_resolveNameServiceAddress

Body

Response

Authorization

suix_resolveNameServiceNames

Body

Response

Authorization

Governance Read API

suix_getCommitteeInfo

Body

Response

Authorization

suix_getLatestSuiSystemState

Body

Response

Authorization

suix_getReferenceGasPrice

Body

Response

Authorization

suix_getStakesByIds

Body

Response

Authorization

suix_getStakes

Body