Skip to main content
Get started with a reliable Sui RPC endpoint to use the tools below. Your Chainstack Sui node serves both gRPC and JSON-RPC on the same endpoint.
Sui Foundation retires its public JSON-RPC endpoints by Jul 31, 2026. Chainstack’s own JSON-RPC keeps working, but gRPC is the path forward — see Migrate Sui from JSON-RPC to gRPC.

gRPC API

Sui nodes on Chainstack support gRPC for high-performance access. gRPC uses HTTP/2 and Protocol Buffers for binary serialization, which makes payloads smaller and adds server-side streaming — ideal for indexers, backends, and low-latency lookups. gRPC is the forward path as Sui deprecates JSON-RPC.

Endpoint and authentication

Your Sui gRPC endpoint is sui-mainnet.core.chainstack.com:443 (testnet: sui-testnet.core.chainstack.com:443), with TLS. Authenticate by passing your token in the x-token metadata header on every call. To find your endpoint and token on Chainstack, see View node access and credentials.

Explore with grpcurl

Sui gRPC has server reflection enabled, so grpcurl can list services and call methods without compiling proto files:
The node exposes six sui.rpc.v2 services:

gRPC from code

In TypeScript, use the official @mysten/sui SDK with a native gRPC transport (its default transport is gRPC-Web, which Chainstack does not serve). From other languages, generate typed stubs from Sui’s proto definitions. Either way, attach the x-token metadata to every call, and use recent client versions — @mysten/sui 2.16+ and @grpc/grpc-js 1.14+ — since older releases produce intermittent gRPC errors under load.
The native gRPC transport above works only in Node.js and other server runtimes. The SDK’s browser transport is gRPC-Web, which Chainstack does not serve yet (HTTP 415) — from the browser, use JSON-RPC or proxy gRPC through your backend.

JSON-RPC API

Interact with your Sui node using the Sui JSON-RPC API. Chainstack’s JSON-RPC endpoints keep working after Sui’s public endpoints shut down, so this is a valid path while you migrate to gRPC. Use your Chainstack Sui RPC endpoint to make API calls. Example to get the latest checkpoint:

Sui TypeScript SDK

The Sui TypeScript SDK is the official SDK for building Sui applications.

Installation

Basic usage

Sui Rust SDK

The Sui Rust SDK provides comprehensive Rust bindings for Sui.

Installation

Add to your Cargo.toml:

Basic usage

Python SDK (pysui)

pysui is a community-maintained Python SDK for Sui.

Installation

Basic usage

Go SDK

The Sui Go SDK provides Go language bindings for Sui.

Installation

Basic usage

Last modified on July 13, 2026