新用户订阅 RPC，首月享 6.5 折优惠查看优惠

Sui Testnet RPC & gRPC Endpoints

Connect to Sui Testnet 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.

注册 Free Plan，可将速率提升至 40 req/sec，并获得 API 使用与性能洞察。立即开始

公共接口速率限制为 5 req/sec

Connect to Sui Testnet

主网测试网

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

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

Sui gRPC Host

sui-testnet.api.onfinality.io:443

sui-testnet.api.onfinality.io:443

JSON-RPC Endpoint

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

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

升级 Growth Plan

高性能
强大的 RPC 分析
最高 500 rps
无每日响应限制
优先支持
去中心化服务器

立即开始

Sui Testnet RPC and gRPC details

Item

Value

Network

Sui Testnet

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-testnet.api.onfinality.io:443

JSON-RPC Endpoint

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

Regions

France / N. Virginia / Hong Kong

30-day Uptime

99.99% · Check details

Connect to Sui Testnet

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-testnet.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-testnet.api.onfinality.io:443 \
  sui.rpc.v2.LedgerService/GetCheckpoint

Check gRPC connectivity

grpcurl sui-testnet.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 legacysui_subscribeEvent and sui_subscribeTransactionworkflows.

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-testnet.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