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

JSON-RPC deprecation notice: migrate by 30 September 2026. The Sui JSON-RPC interface is being retired network-wide during 2026, and the Sui Foundation asks every RPC provider, Ankr included, to have customers migrated by the end of September 2026. Migrate existing integrations to gRPC (for indexers and backend services) or GraphQL (for frontends and analytics).

Because Ankr runs its own Sui full nodes, Ankr's JSON-RPC endpoints keep serving until JSON-RPC is removed from the Sui node software (mid-October 2026). Treat that as a hard ceiling rather than a migration buffer: historical and pruned-data queries may start returning incomplete results from the end of September 2026, and the final two weeks are reserved by the Sui Foundation for codebase removal. See the JSON-RPC page for the full timeline.

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 multiple interfaces for interacting with Sui — JSON-RPC, gRPC, and GraphQL — across mainnet, testnet, and archival data.


Endpoints

InterfaceNetworkEndpointAuth
JSON-RPC (deprecated, migrate by 30 Sep 2026)Mainnethttps://rpc.ankr.com/suiToken for Premium
JSON-RPC (deprecated, migrate by 30 Sep 2026)Testnethttps://rpc.ankr.com/sui_testnetToken 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:443x-token header for Premium
GraphQLMainnethttps://rpc.ankr.com/http/sui_graphqlToken for Premium

For Premium endpoints, append your token to the URL (for HTTP-based APIs) or pass it 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)

warning

Migrate by 30 September 2026. Sunset on Ankr's nodes follows the removal of JSON-RPC from the Sui full-node software in mid-October 2026, but the Sui Foundation's archival fallback disconnects at the end of September and the final two weeks are reserved for codebase removal. Sui Foundation public-good endpoints were turned off earlier, in July 2026. Migrate existing integrations to gRPC or GraphQL.

The standard JSON-RPC 2.0 interface for reading blockchain data and sending transactions. Historically the most common entry point for Sui dApps; superseded by gRPC and GraphQL going forward.

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