For AI agents: an LLM-friendly Markdown version of every page is available by appending .md to its URL or by sending an Accept: text/markdown request header. The full documentation index is at https://www.ankr.com/docs/llms.txt
Skip to main content

Sui


warning

Sui JSON-RPC is deprecated and runs on a reduced method set. The Sui full-node software no longer serves JSON-RPC, so Ankr answers mainnet JSON-RPC from a Sui indexer, with only the methods listed on the JSON-RPC page. Other methods return -32601 Method not found, and there is no JSON-RPC on testnet. Use gRPC (for indexers and backend services) or GraphQL (for frontends and analytics).

tip

Available for Freemium and Premium users.

Sui API is available on Web3 API platform.

Sui is the first permissionless Layer 1 blockchain designed from the ground up to enable creators and developers to build experiences that cater to the next billion users in Web3. Sui is horizontally scalable to support a wide range of application development with unrivaled speed at low cost.

Ankr provides gRPC and GraphQL for Sui across mainnet, testnet, and archival data, plus deprecated JSON-RPC on mainnet with a reduced method set.


Endpoints​

InterfaceNetworkEndpointAuth
JSON-RPC (deprecated, reduced method set)Mainnethttps://rpc.ankr.com/suiToken for Premium
gRPCMainnetsui.grpc.ankr.com:443x-token header for Premium
gRPCTestnetsui-testnet.grpc.ankr.com:443x-token header for Premium
gRPC ArchiveMainnetarchive.sui.grpc.ankr.com:443Premium only

GraphQL (Mainnet, Premium only): https://rpc.ankr.com/premium-http/sui_graphql/YOUR_ANKR_API_KEY. See Sui GraphQL.

For Premium endpoints, pass your token in the URL (for HTTP-based APIs) or via the x-token header (for gRPC).


Regions​

Sui gRPC services are deployed across multiple regions for low-latency access. Requests are routed to the closest healthy region automatically.

ServiceHigh-level coverage
Mainnet gRPCEU, Americas, APAC
Mainnet Archive gRPCEU, Americas, APAC
Testnet gRPCEU, Americas, APAC

See the gRPC page for the full list of cities per service.


Interfaces​

JSON-RPC (deprecated)​

The standard JSON-RPC 2.0 interface, served on mainnet from a Sui indexer with a reduced method set: object, coin, balance, dynamic field, transaction, checkpoint and staking reads, plus dry run, dev inspect and transaction execution. Event queries, unsafe_* transaction builders and several other methods are not available. Superseded by gRPC and GraphQL.

View JSON-RPC methods →

gRPC​

A high-performance interface using Protocol Buffers for fast, type-safe, and bandwidth-efficient communication. gRPC supports server-side streaming for real-time data delivery and automatic client generation in TypeScript, Go, Rust, and more. Ideal for indexers, explorers, and backend systems.

View gRPC methods →

GraphQL​

A flexible query language that lets you request exactly the data you need in a single call. Sui's GraphQL RPC provides composable queries for on-chain state — objects, transactions, balances, checkpoints — without overfetching. It supports pagination, filtering, and nested lookups.

View GraphQL documentation →


gRPC Archive​

The gRPC Archive endpoint (archive.sui.grpc.ankr.com:443) provides access to historical Sui network data that standard full nodes may have pruned. It exposes the same LedgerService gRPC API as the standard gRPC endpoint, so you can use the same client code and methods.

Use the Archive endpoint when you need to query older transactions, checkpoints, or objects that are no longer available on current full nodes. A common pattern is to first query the standard endpoint and fall back to the Archive endpoint if the data is not found.


Getting started​

  1. Get your API token — Sign up at ankr.com/rpc to get a Premium token, or use the public endpoints without authentication.
  2. Choose your interface — Pick gRPC or GraphQL based on your use case (JSON-RPC is deprecated; see notice above).
  3. Connect — Use the endpoints from the table above with your preferred client library or tool.

Official Sui links: Website, Docs, GitHub