# Sui Blockchain gRPC API Documentation

## Sui RPC plans and rate limits

- **Free plan:** 20 responses per second, up to 100,000 responses a day.
- **Plans:** $49/mo, $299/mo, $999/mo with 25M, 150M, and 500M included responses. Overages billed at $5/$3/$2 per million responses respectively.
- **Paid rate limits:** 100 to 5,000 responses per second (bursts from 500 to 10,000), no daily limit.
- **Billing:** 1 response = 1 API credit on every shared plan, over HTTPS or WebSocket (WSS) where Sui supports it.

Details: [Pricing](https://www.dwellir.com/docs/getting-started/pricing) · [Rate limits](https://www.dwellir.com/docs/getting-started/rate-limits) · [Authentication](https://www.dwellir.com/docs/getting-started/authentication) · [Archive nodes](https://www.dwellir.com/docs/getting-started/archive-nodes)

## Connect to Sui mainnet

Dwellir provides Sui full-node access through the network's gRPC API. Sui removed JSON-RPC from full nodes in `mainnet-v1.82.3`. Existing JSON-RPC integrations must [migrate to gRPC or GraphQL](https://www.dwellir.com/docs/sui/json-rpc-removal).

Connect over TLS on port 443:

```text
api-sui-mainnet-full.n.dwellir.com:443
```

Send your API key in the `x-api-key` metadata header. Do not append it to the endpoint path.

```bash
grpcurl \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{}' \
  api-sui-mainnet-full.n.dwellir.com:443 \
  sui.rpc.v2.LedgerService/GetServiceInfo
```

Get an API key from the [Dwellir dashboard](https://dashboard.dwellir.com). Testnet access is available through dedicated node clusters.

## API Reference

The reference covers 28 methods across seven stable `sui.rpc.v2` services and the experimental `sui.rpc.v2alpha.ProofService`:

- [Ledger Service](https://www.dwellir.com/docs/sui/grpc/ledger/get-service-info) for checkpoints, epochs, transactions, events, and objects
- [State Service](https://www.dwellir.com/docs/sui/grpc/state/get-balance) for balances, owned objects, dynamic fields, and coin information
- [Transaction Execution Service](https://www.dwellir.com/docs/sui/grpc/transaction/execute) for execution and simulation
- [Move Package Service](https://www.dwellir.com/docs/sui/grpc/package/get-package) for packages, modules, functions, types, and versions
- [Subscription Service](https://www.dwellir.com/docs/sui/grpc/subscription/subscribe-checkpoints) for checkpoint, transaction, and event streams
- [Signature Verification Service](https://www.dwellir.com/docs/sui/grpc/signature/verify) for off-chain signature verification
- [Name Service](https://www.dwellir.com/docs/sui/grpc/name/lookup-name) for forward and reverse SuiNS lookup
- [Proof Service](https://www.dwellir.com/docs/sui/grpc/proof/get-checkpoint-object-proof) for experimental checkpoint object proofs

[View all gRPC methods](https://www.dwellir.com/docs/sui#api-reference)

## Choose the right API

Use gRPC for typed full-node queries, transaction submission, and live streams. Use Sui GraphQL when you need flexible joins, advanced filtering, or historical data beyond the node's retention window.

## Client setup

- [grpcurl](https://www.dwellir.com/docs/sui/grpc-setup-grpcurl)
- [TypeScript](https://www.dwellir.com/docs/sui/grpc-setup-typescript)
- [Python](https://www.dwellir.com/docs/sui/grpc-setup-python)
- [Go](https://www.dwellir.com/docs/sui/grpc-setup-go)
- [Sui gRPC overview](https://www.dwellir.com/docs/sui/grpc-overview)

## Support

For help with an integration or a dedicated Sui cluster, contact <support@dwellir.com>.

### Related reading

- [Best Sui RPC Providers 2026](https://www.dwellir.com/blog/best-sui-rpc-providers)
