Use Sui gRPC to query Mainnet or Testnet. This guide shows you how to create an endpoint and send your first request.
JSON-RPC has been removed from both Sui Mainnet and Testnet. Use gRPC on either network or GraphQL on Mainnet.
Get Your Sui Endpoint
Create a Quicknode account
Sign up here if you haven't already.
Go to your dashboard
Go to your Quicknode dashboard, then select Endpoints from the left sidebar.
Create a new endpoint
Click Create Endpoint in the top-right corner. Select Sui as the chain, click Continue, then select your preferred network.
Copy your provider URLs
Keep the HTTP URL handy. You'll use it in your requests below.
For a detailed walkthrough of the Quicknode dashboard, check out our guide
Send Your First Request
Use grpcurl to call GetServiceInfo, which returns the network, checkpoint height, and server version. Set the hostname and token from your own endpoint:
export QN_SUI_GRPC_HOST="YOUR_ENDPOINT_HOST:9000"
export QN_SUI_TOKEN="YOUR_ENDPOINT_TOKEN"
grpcurl -H "x-token: $QN_SUI_TOKEN" -d '{}' \
"$QN_SUI_GRPC_HOST" sui.rpc.v2.LedgerService/GetServiceInfo
The hostname has no https:// prefix or token path. Use your Testnet hostname when connecting to Testnet. The command uses server reflection; see the grpcurl setup for loading protobuf files explicitly.
See GetServiceInfo for the response fields and Go, TypeScript, and Python examples. For rich Mainnet queries, use GraphQL.
If you want to continue learning about making API requests, check out our guides and sample apps.