Sui (SUI)

GetBlock provides fast and reliable access to Sui RPC nodes via JSON-RPC API. Connect to the SUI network without running your own infrastructure.

S is a high-performance Layer 1 blockchain designed for low-latency, high-throughput applications. Built by Mysten Labs using the Move programming language, SUI features a unique object-centric data model that enables parallel transaction execution. The network achieves sub-second finality through its innovative Narwhal and Bullshark (transitioning to Mysticeti) consensus mechanism, making it ideal for gaming, DeFi, and real-time applications.

Key Features

• Object-Centric Model: Unique architecture where everything is an object with ownership properties

• Move Programming Language: Rust-based, asset-oriented smart contract language with built-in safety

• Parallel Transaction Execution: Independent transactions processed simultaneously for high throughput

• Sub-Second Finality: ~400ms average transaction finality with Mysticeti consensus

• Horizontal Scalability: Designed for 100,000+ TPS through parallel processing

• SUI Native Token: Uses SUI for gas fees, staking, and governance (9 decimals, smallest unit: MIST)

• Dynamic NFTs: Native support for evolving, composable digital assets

• Sponsored Transactions: Gas payment abstraction for better user experience

• SuiNS: Native name service for human-readable addresses

TECHNICAL DISCLAIMER: AUTHORITATIVE JSON-RPC API SPECIFICATION.

GetBlock's RPC API reference documentation is provided exclusively for informational purposes and streamlined developer experience optimization. The canonical and normative specification for SUI JSON-RPC methods is solely maintained and published through the official SUI documentation portal at docs.sui.io. This resource constitutes the sole authoritative reference implementation of the JSON-RPC 2.0 protocol interface for SUI network clients.

Network Information

Property	Value
Network Name	SUI Mainnet
Chain ID	101
Native Currency	SUI
Decimals	9 (1 SUI = 1,000,000,000 MIST)
RPC URL	https://fullnode.mainnet.sui.io:443
Consensus	Narwhal & Mysticeti
Block Time	Sub-second (~400ms finality)
Smart Contracts	Move Language

Base URL

Frankfurt, Germany

https://go.getblock.io

New York, USA

Supported Networks

Network	Chain ID	JSON RPC
Mainnet	101	✅

Quickstart

In this section, you will learn how to make your first call with either:

• Axios

• Python

Before you begin, you must have already installed npm or yarn on your local machine (for the Axios example) or Python and pip (for the Python example).

Refer to:

• npm

• yarn

1

Quickstart with Axios

1. Set up the project

Create and initialize a new project:

mkdir sui-api-quickstart
cd sui-api-quickstart
npm init --yes

Install Axios

npm install axios

2. Create file

Create a new file named index.js. This is where you will make your first call.

3. Set ES module type

Set the ES module "type": "module" in your package.json.

4. Add code

Add the following code to index.js:

index.js

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "sui_getLatestCheckpointSequenceNumber",
    "params": [],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://go.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data)))
    .catch(error => console.log(error));

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

5. Run the script

node index.js

Expected output (example):

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "231610955"
}

2

Quickstart with Python and Requests

1. Set up the project directory

mkdir sui-api-quickstart
cd sui-api-quickstart

2. Create and activate a virtual environment

python -m venv venv
source venv/bin/activate

# On Windows, use venv\Scripts\activate

3. Install requests

pip install requests

4. Create script

Create a file called main.py with the following content:

main.py

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "sui_getLatestCheckpointSequenceNumber",
    "params": [],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

5. Run the script

python main.py

Available API Methods

GetBlock provides access to standard SUI JSON-RPC methods for the SUI network.

Coin Query Methods

Method	Description
suix_getBalance	Returns balance for a specific coin type
suix_getAllBalances	Returns all coin balances for an address
suix_getAllCoins	Returns all coin objects owned by address
suix_getCoins	Returns coins of specific type for address
suix_getCoinMetadata	Returns coin metadata (symbol, decimals)
suix_getTotalSupply	Returns total supply for a coin type

Read Methods

Method	Description
sui_getObject	Returns object data by ID
sui_multiGetObjects	Returns multiple objects by IDs
sui_getTransactionBlock	Returns transaction by digest
sui_multiGetTransactionBlocks	Returns multiple transactions
sui_getChainIdentifier	Returns chain genesis identifier
sui_getCheckpoint	Returns checkpoint by sequence number
sui_getCheckpoints	Returns paginated checkpoints
sui_getLatestCheckpointSequenceNumber	Returns latest checkpoint number
sui_getTotalTransactionBlocks	Returns total transaction count
sui_getEvents	Returns events for a transaction
sui_getProtocolConfig	Returns protocol configuration
sui_tryGetPastObject	Returns object at specific version
sui_tryMultiGetPastObjects	Returns multiple past objects

Extended Query Methods

Method	Description
suix_getOwnedObjects	Returns objects owned by address
suix_getDynamicFields	Returns dynamic fields of object
suix_getDynamicFieldObject	Returns specific dynamic field
suix_queryEvents	Queries events with filters
suix_queryTransactionBlocks	Queries transactions with filters
suix_resolveNameServiceAddress	Resolves SuiNS name to address
suix_resolveNameServiceNames	Resolves address to SuiNS names

Governance Methods

Method	Description
suix_getCommitteeInfo	Returns validator committee info
suix_getLatestSuiSystemState	Returns system state object
suix_getReferenceGasPrice	Returns current gas price
suix_getStakes	Returns stakes for an address
suix_getStakesByIds	Returns stakes by object IDs
suix_getValidatorsApy	Returns validator APY data

Move Utils Methods

Method	Description
sui_getMoveFunctionArgTypes	Returns function argument types
sui_getNormalizedMoveFunction	Returns function definition
sui_getNormalizedMoveModule	Returns module definition
sui_getNormalizedMoveModulesByPackage	Returns all modules in package
sui_getNormalizedMoveStruct	Returns struct definition

Write Methods

Method	Description
sui_executeTransactionBlock	Executes signed transaction
sui_dryRunTransactionBlock	Simulates transaction execution
sui_devInspectTransactionBlock	Dev-mode transaction testing

Subscription Methods (WebSocket)

Method	Description
suix_subscribeEvent	Subscribes to event stream
suix_subscribeTransaction	Subscribes to transaction stream

Support

For technical support and questions:

• Support: [email protected]

See Also

• Sui Developer Documentation

• Sui Block Explorer - SuiScan

• Sui Block Explorer - SuiVision

• Sui Bridge

• Sui TypeScript SDK

• Sui Rust SDK

• Move Language Documentation