# SUI

<figure><img src="/files/s9Brqede5FY3fhTaIJgD" alt=""><figcaption></figcaption></figure>

> Sui API is available on [Web3 API platform](https://crypto-chief.com/rpc/sui/).

*Sui* is a Layer 1 blockchain and smart contract platform built around the Move programming language and an object-centric data model. Rather than maintaining a global account state, every asset and piece of data on Sui exists as a discrete, typed *object* — enabling fine-grained ownership, parallel execution, and sub-second finality without global locking. Sui's consensus (Mysticeti) achieves throughput of hundreds of thousands of transactions per second with deterministic latency, making it one of the highest-performance programmable blockchains in production.

Crypto Chief provides three interfaces for interacting with Sui — JSON-RPC, gRPC, and GraphQL — covering mainnet, testnet, and full archival history.

***

### Endpoints

| Interface                                        | Network | Endpoint                                                  | Auth                         |
| ------------------------------------------------ | ------- | --------------------------------------------------------- | ---------------------------- |
| JSON-RPC *(deprecated, sunset end of July 2026)* | Mainnet | `https://rpc.crypto-chief.com/sui/{YOUR_API_KEY}`         | Token for Premium            |
| JSON-RPC *(deprecated, sunset end of July 2026)* | Testnet | `https://rpc.crypto-chief.com/sui-testnet/{YOUR_API_KEY}` | Token for Premium            |
| gRPC                                             | Mainnet | `sui.grpc.crypto-chief.com:443`                           | `x-token` header for Premium |
| gRPC                                             | Testnet | `sui-testnet.grpc.crypto-chief.com:443`                   | `x-token` header for Premium |
| gRPC Archive                                     | Mainnet | `sui-archive.grpc.crypto-chief.com:443`                   | `x-token` header for Premium |
| GraphQL                                          | Mainnet | `https://rpc.crypto-chief.com/sui/{YOUR_API_KEY}`         | Token for Premium            |

For Premium endpoints, append your token to the URL (for HTTP-based APIs) or pass it via the `x-token` header (for gRPC).

***

### Regions

Sui gRPC services are deployed across multiple regions for low-latency access. Requests are routed to the closest healthy region automatically.

| Service              | High-level coverage |
| -------------------- | ------------------- |
| Mainnet gRPC         | EU, Americas, APAC  |
| Mainnet Archive gRPC | EU, Americas, APAC  |
| Testnet gRPC         | EU, Americas, APAC  |

See the [gRPC page](https://github.com/crypto-chiefs/crypto-chief-rpc-documentation/blob/main/chains/sui/sui.md#regions) for the full list of cities per service.

***

### Interfaces

#### JSON-RPC *(deprecated)*

Sunset at \*\*end of July 2026\*\*. Migrate existing integrations to gRPC or GraphQL.

The standard [JSON-RPC 2.0](https://www.jsonrpc.org/specification) interface for reading blockchain data and sending transactions. Historically the most common entry point for Sui dApps; superseded by gRPC and GraphQL going forward.

[View JSON-RPC methods →](/chains/sui/sui-json-rpc.md)

#### gRPC

A high-performance interface using [Protocol Buffers](https://protobuf.dev/overview/) for fast, type-safe, and bandwidth-efficient communication. gRPC supports server-side streaming for real-time data delivery and automatic client generation in TypeScript, Go, Rust, and more. Ideal for indexers, explorers, and backend systems.

[View gRPC methods →](/chains/sui/sui-grpc.md)

#### GraphQL

A flexible query language that lets you request exactly the data you need in a single call. Sui's GraphQL RPC provides composable queries for on-chain state — objects, transactions, balances, checkpoints — without overfetching. It supports pagination, filtering, and nested lookups.

[View GraphQL documentation →](/chains/sui/sui-graphql.md)

***

### gRPC Archive

The gRPC Archive endpoint (`sui-archive.grpc.crypto-chief.com:443`) provides access to historical Sui network data that standard full nodes may have pruned. It exposes the same `LedgerService` gRPC API as the standard gRPC endpoint, so you can use the same client code and methods.

Use the Archive endpoint when you need to query older transactions, checkpoints, or objects that are no longer available on current full nodes. A common pattern is to first query the standard endpoint and fall back to the Archive endpoint if the data is not found.

***

### Getting started

1. **Get your API token** — Sign up at [crypto-chief.com/rpc](https://crypto-chief.com/rpc/sui/) to get a Premium token, or use the public endpoints without authentication.
2. **Choose your interface** — Pick gRPC or GraphQL based on your use case (JSON-RPC is deprecated; see notice above).
3. **Connect** — Use the endpoints from the table above with your preferred client library or tool.

Official Sui links: [Website](https://sui.io/), [Docs](https://docs.sui.io/), [GitHub](https://github.com/MystenLabs)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-rpc.crypto-chief.com/chains/sui.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.