OnFinality
New RPC users get 35% off their first monthView the offer
Sui Testnet logo

Sui Testnet RPC & gRPC Endpoints

Sui delivers the benefits of Web3 with the ease of Web2

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.

Create a free API key for 400,000 response units per day and up to 40 response units/second. Method weights apply.

Public endpoint rate limit: 5 req/sec

Connect to Sui Testnet RPC
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
GET CONNECTED

Connect to Sui Testnet

Test Move object access and checkpoint handling on Sui Testnet with OnFinality gRPC. Rehearse transaction simulation and streaming before a Sui Mainnet rollout.

Try the public interface

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

Use the interface and request shown above for an initial check, then test the methods and traffic pattern your application actually needs.

02

Create your own access

  1. Open the dashboard and select this network.
  2. Create an endpoint and copy the access details supplied by the dashboard.
  3. Validate your application's methods, peak traffic and error handling before production.
Create an RPC endpoint for Sui Testnet
RPC API

RPC API plans & response units

Choose a shared RPC plan by response-unit allowance and peak throughput. Method weights and network-specific availability still apply.

Developer

Free
Included response units
400,000/day
Rate limit
Up to 40 RU/s
Extra RU
Not available

Accelerate

$249/month
Included response units
100 million/month
Rate limit
500 RU/s
Extra RU
$3.75/million
Compare RPC plans

Plan figures checked 8 November 2026. RU are not always raw requests; WebSocket responses also count toward limits. Check the current pricing and this network's method documentation. Node charges and applicable taxes are additional.

NETWORK REFERENCE

Sui Testnet RPC and gRPC details

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
NETWORK REFERENCE

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

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

Authenticated gRPC endpoint

API
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

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

NETWORK REFERENCE

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

GetServiceInfoGetObjectBatchGetObjectsGetTransactionBatchGetTransactionsGetCheckpointGetEpochListCheckpointsListTransactionsListEvents

StateService

ListDynamicFieldsListOwnedObjectsGetCoinInfoGetBalanceListBalances

SubscriptionService

SubscribeCheckpointsSubscribeTransactionsSubscribeEvents

TransactionExecutionService

ExecuteTransactionSimulateTransaction

MovePackageService

GetPackageGetDatatypeGetFunctionListPackageVersions

NameService

LookupNameReverseLookupName

SignatureVerificationService

API
VerifySignature
NETWORK REFERENCE

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.

SubscribeCheckpointsSubscribeTransactionsSubscribeEvents

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

NETWORK REFERENCE

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.

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

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.

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

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-RPCSui gRPC
sui_getObjectLedgerService.GetObject
sui_getTransactionBlockLedgerService.GetTransaction
suix_queryTransactionBlocksLedgerService.ListTransactions
suix_queryEventsLedgerService.ListEvents
sui_subscribeEventSubscriptionService.SubscribeEvents
sui_subscribeTransactionSubscriptionService.SubscribeTransactions
sui_executeTransactionBlockTransactionExecutionService.ExecuteTransaction
sui_dryRunTransactionBlockTransactionExecutionService.SimulateTransaction
NETWORK REFERENCE

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.

NETWORK REFERENCE

Sui Mainnet and Testnet endpoints

EnvironmentMainnetTestnet
NetworkSui MainnetSui Testnet
gRPCSupportedSupported
JSON-RPCLegacyLegacy
EnvironmentProductionDevelopment / QA
Best forLive applicationsTesting and staging
BUILT FOR YOUR WORKLOAD

Build with Sui Testnet

Plan access around the requests, operational requirements and release workflow your application needs.

Integration

Start with a connection check, then validate the reads, transactions or data workflows required by your application.

Usage planning

Review method-specific limits, plan allowances and usage before increasing traffic. Different methods can consume different response units.

Operations

Use your real client region and request pattern when evaluating latency, retries and service availability.

Never Worry about Infrastructure Again

OnFinality takes away the heavy lifting of DevOps so you can build smarter and faster.

Get Started