New RPC users get 35% off their first monthView the offer

Sui RPC & gRPC Endpoints for Mainnet

Sui delivers the benefits of Web3 with the ease of Web2

Connect to Sui Mainnet through OnFinality's production-ready gRPC and RPC infrastructure. Use the Sui Full Node gRPC API to query checkpoints, transactions, objects and balances, execute or simulate transactions, and stream real-time blockchain activity without operating your own Sui full node.

Sui has deprecated Full Node JSON-RPC in favour of gRPC and GraphQL. OnFinality provides Sui gRPC access for teams migrating existing applications or building new wallets, exchanges, indexers, explorers, games, and backend services.

Sign up for a Free Plan to unlock up to 40 req/sec and API Usage and Performance Insights. Get Started

Public endpoint rate limit: 5 req/sec

Connect to Sui Mainnet RPC

Mainnet Testnet

grpcurl -v \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

grpcurl -v \ -d '{ "sequence_number": "299599072", "read_mask": { "paths": ["transactions"] } }' \ sui.api.onfinality.io:443 \ sui.rpc.v2.LedgerService/GetCheckpoint

Sui gRPC Host

sui.api.onfinality.io:443

sui.api.onfinality.io:443

JSON-RPC Endpoint

https://sui.api.onfinality.io/public

https://sui.api.onfinality.io/public

Go to Growth Plan

High Performance
Powerful RPC Analytics
Up to 500 rps
No daily response limit
Priority Support
Decentralized Servers

Get Started

Sui Mainnet RPC and gRPC details

Item

Value

Network

Sui Mainnet

Native Token

SUI

Primary Protocol

Sui gRPC v2

Legacy Protocol

Sui JSON-RPC

gRPC Transport

HTTP/2 + TLS

JSON-RPC Transport

HTTPS

gRPC Streaming

Supported

gRPC Host

sui.api.onfinality.io:443

JSON-RPC Endpoint

https://sui.api.onfinality.io/public

Regions

N. Virginia / Hong Kong

30-day Uptime

99.99% · Check details

Connect to Sui Mainnet

Use the Sui Full Node gRPC API for typed access to checkpoints, transactions, objects and balances. The public endpoint is useful for initial testing; add an API key for authenticated application traffic.

Public gRPC endpoint

grpcurl -v \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

Authenticated gRPC endpoint

grpcurl -v \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "sequence_number": "299599072",
    "read_mask": {
      "paths": ["transactions"]
    }
  }' \
  sui.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

Check gRPC connectivity

grpcurl sui.api.onfinality.io:443 sui.rpc.v2.LedgerService/GetServiceInfo

Sui has deprecated Full Node JSON-RPC in favour of gRPC and GraphQL. Use gRPC for new integrations and migrate existing JSON-RPC applications as part of your upgrade path.

Sui Full Node gRPC API

Sui gRPC exposes typed services for reading ledger state, querying objects and Move packages, executing transactions, and consuming live blockchain data from a Sui Full Node.

LedgerService

GetServiceInfo
GetObject
BatchGetObjects
GetTransaction
BatchGetTransactions
GetCheckpoint
GetEpoch
ListCheckpoints
ListTransactions
ListEvents

StateService

ListDynamicFields
ListOwnedObjects
GetCoinInfo
GetBalance
ListBalances

SubscriptionService

SubscribeCheckpoints
SubscribeTransactions
SubscribeEvents

TransactionExecutionService

ExecuteTransaction
SimulateTransaction

MovePackageService

GetPackage
GetDatatype
GetFunction
ListPackageVersions

NameService

LookupName
ReverseLookupName

SignatureVerificationService

VerifySignature

Real-time Sui gRPC streaming

Use SubscriptionService streams to receive checkpoints, transactions, and events as they are produced. Streaming avoids repeatedly polling HTTP endpoints for applications that need live Sui activity.

SubscribeCheckpoints
SubscribeTransactions
SubscribeEvents

These typed streams provide the gRPC equivalents of the legacy sui_subscribeEvent and sui_subscribeTransaction workflows.

Use field masks with Sui gRPC

Field masks let clients request only the response fields they need. This keeps responses focused and helps applications control payload size when querying detailed checkpoints, transactions, and objects.

{
  "sequence_number": "299599072",
  "read_mask": {
    "paths": ["transactions"]
  }
}

Sui JSON-RPC — Legacy Access

Existing applications can continue using Sui JSON-RPC while they migrate. The legacy endpoint remains useful for compatibility, but new Sui integrations should prefer gRPC or GraphQL as the network moves away from Full Node JSON-RPC.

curl -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"sui_getTotalTransactionBlocks"
  }' \
  'https://sui.api.onfinality.io/public'

Migrate from Sui JSON-RPC to gRPC

Replace legacy method calls with typed gRPC service methods as you update clients, indexers, wallets, and backend services.

Sui JSON-RPC	Sui gRPC
`sui_getObject`	`LedgerService.GetObject`
`sui_getTransactionBlock`	`LedgerService.GetTransaction`
`suix_queryTransactionBlocks`	`LedgerService.ListTransactions`
`suix_queryEvents`	`LedgerService.ListEvents`
`sui_subscribeEvent`	`SubscriptionService.SubscribeEvents`
`sui_subscribeTransaction`	`SubscriptionService.SubscribeTransactions`
`sui_executeTransactionBlock`	`TransactionExecutionService.ExecuteTransaction`
`sui_dryRunTransactionBlock`	`TransactionExecutionService.SimulateTransaction`

View the Sui JSON-RPC Migration Guide →

Build on Sui with gRPC

Wallets and Exchanges

Query balances, objects, transactions, and live activity for Sui wallets, custody systems, and exchange workflows.

Indexers and Explorers

Combine ledger queries, field masks, and subscriptions to build Sui datasets, explorers, search, and analytics pipelines.

DeFi Applications

Read object and balance state, simulate transactions, execute signed transactions, and stream protocol activity for DeFi products.

Games and Consumer Applications

Use Sui's object-centric model and real-time streams for game assets, social features, digital collectibles, and consumer experiences.

Backend Data Pipelines

Use typed gRPC responses and streaming services to feed operational systems, monitoring, reporting, and data products without running a full node.

Sui Mainnet and Testnet endpoints

Environment	Mainnet	Testnet
Network	Sui Mainnet	Sui Testnet
gRPC	Supported	Supported
JSON-RPC	Legacy	Legacy
Environment	Production	Development / QA
Best for	Live applications	Testing and staging

Resources

Additional Info

Build faster with Sui Mainnet RPC endpoints

Use OnFinality's Sui Mainnet RPC APIs to connect wallets, dApps, dashboards, bots, and backend services without operating your own node from day one.

Public endpoint testing

Start with the Sui Mainnet public RPC endpoint for lightweight checks, prototypes, and quick integration tests.

Authenticated API access

Move production traffic to authenticated endpoints when you need clearer limits, analytics, and operational visibility.

Standard RPC methods

Query Sui Mainnet blocks, transactions, balances, events, and chain state through HTTPS JSON-RPC workflows.

Operate Sui Mainnet infrastructure with more control

Production teams need more than an endpoint URL. They need observability, predictable capacity, and a path from shared RPC access to isolated infrastructure.

Request visibility

Track usage patterns and response activity so your team can understand traffic growth before it becomes an incident.

Dedicated node path

Use dedicated Sui Mainnet nodes when your workload needs isolated resources, custom operations, or stronger capacity planning.

Archive and historical data

Plan for archive access when analytics, audits, indexers, or advanced app features need older Sui Mainnet state.

Choose the right Sui Mainnet RPC setup

Different Sui Mainnet products need different infrastructure. OnFinality gives teams a practical path from public RPC testing to production-grade API and node operations.