Skip to main content

API Overview

Updated on
Apr 28, 2026

Quicknode supports the following Sui APIs. Using your Sui endpoint, you can call any of the methods available in these APIs. For a complete list of supported RPC methods, refer to the documentation for each API.

Network Availability:

  • GraphQL: Mainnet only
  • JSON-RPC: Mainnet and Testnet (Deprecated, deactivating July 2026)
  • gRPC: Mainnet and Testnet

Archive Support: Historical data beyond 14 epochs is available via gRPC on Mainnet. Archive queries use the same endpoint and are automatically routed to archive nodes when needed.

Infrastructure Regions:

Quicknode's Sui infrastructure is deployed across the following regions:

APIMainnetTestnet
JSON-RPC / gRPCEU, USEU
GraphQLEU, US
Archive (gRPC)US

Limits & Restrictions

Understanding the limits in place helps you build reliable applications. Sui enforces limits at both the network protocol level and the API level.

Network Protocol Limits

These limits are enforced by the Sui network and apply to all transactions regardless of the API used:

LimitValueDescription
Transaction Size128 KBMaximum size of a transaction, including payload, signature, and metadata
Object Size256 KBMaximum size of a single on-chain object
Pure Argument Size16 KBMaximum size of a single pure argument in a transaction
Max Objects Created2,048Maximum number of objects that can be created in a single transaction
Max Dynamic Fields Created1,000Maximum number of dynamic fields that can be created in a single transaction
Max Dynamic Fields Accessed1,000Maximum number of dynamic fields that can be accessed in a single transaction
Max Events Emitted1,024Maximum number of events that can be emitted in a single transaction
Max PTB Commands1,024Maximum number of commands in a single Programmable Transaction Block

For more details, see Building Against Limits in The Move Book.

JSON-RPC Limits

These limits apply to Sui JSON-RPC API methods:

LimitValueDescription
Default Page Size50Default and maximum number of items returned per page for most paginated queries (suix_getOwnedObjects, suix_queryTransactionBlocks, suix_queryEvents, suix_getDynamicFields, suix_getAllCoins, suix_getCoins)
Checkpoint Page Size100Default and maximum number of items returned per page for sui_getCheckpoints
Multi-Get Limit50Maximum number of items per request for batch methods (sui_multiGetObjects, sui_multiGetTransactionBlocks, sui_tryMultiGetPastObjects)
JSON-RPC Deprecation

JSON-RPC is deprecated and will be fully deactivated by July 2026. Consider migrating to GraphQL or gRPC APIs.

GraphQL Service Limits

These limits apply to the Sui GraphQL API. For full details, see the Sui GraphQL Overview.

LimitValueDescription
Request Size175 KB / 5 KBTransaction payloads / other query components
Execution Timeout74 secondsMaximum time for execution queries
Read Timeout40 secondsMaximum time for read queries
Query Complexity300 nodes, 20 levelsMaximum input nodes/field names and nesting depth
Output Nodes1,000,000Maximum estimated output nodes per query
Default Page Size50Default items per page for paginated fields
Multi-Get Page Size200Default items per page for multi-get operations
Rich Queries5Maximum number of queries per request requiring dedicated database access

gRPC Limits

The Sui gRPC API enforces pagination limits on list and batch operations. Always check next_page_token in responses and do not assume all data is returned in a single request. For details, see the Sui gRPC Overview.

  • Archive Data: Full nodes retain the last 14 epochs of data. Queries for older data are automatically routed to archive nodes on Mainnet
  • Field Masks: Use field masks when applicable to reduce response size and latency

Supported APIs

Supported Networks

Quicknode provides access to the following Sui networks:

Mainnet
Type:Production
HTTP:
WSS:
Archive:Yes (gRPC only)
Pruning:Full nodes: 14 epochs. Older data automatically routed to archive nodes
Testnet
Type:Testnet
HTTP:
WSS:
Archive:No
Pruning:Full nodes: 14 epochs

Supported Products

Coming Soon
Additional Quicknode products for Sui are coming soon. Check back for updates on available integrations and tools.
Share this doc