Sui Blockchain RPC API Documentation

Sui RPC

With Dwellir, you get access to our global Sui network which always routes your API requests to the nearest available location, ensuring low latency and the fastest speeds.

Get your API key

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 · Rate limits · Authentication · Archive nodes

Enterprise-Grade Infrastructure for Sui's Object-Centric Blockchain

Sui represents a paradigm shift in blockchain architecture, introducing an object-centric data model that enables parallel transaction execution and horizontal scaling. Dwellir provides enterprise-grade RPC infrastructure for Sui, empowering developers to build high-performance decentralized applications with unprecedented throughput and sub-second finality.

Why Choose Dwellir for Sui Development?

Lightning-Fast Performance

• Sub-second finality: Experience near-instant transaction confirmation
• Parallel execution: Leverage Sui's unique ability to process independent transactions simultaneously
• Optimized routing: Global infrastructure ensures minimal latency worldwide
• High throughput: Support for Sui's capability of 120,000+ TPS

Enterprise Reliability

• 99.99% uptime SLA: Industry-leading service level agreement
• Redundant infrastructure: Multiple node clusters across geographic regions
• Automatic failover: Seamless switching between nodes for uninterrupted service
• 24/7 monitoring: Proactive issue detection and resolution

Developer-First Features

• Full JSON-RPC support: Complete implementation of Sui's JSON-RPC API
• High-performance gRPC: Binary Protocol Buffers for 5-10x faster serialization
• WebSocket subscriptions: Real-time event streaming for responsive applications
• Batch requests: Optimize performance with multi-call support
• Detailed analytics: Monitor usage patterns and optimize your applications

Sui's Unique Architecture

Object-Centric Model

Unlike traditional blockchains that organize data around accounts, Sui revolutionizes blockchain architecture with its object-centric approach:

• Objects as first-class citizens: Every piece of data is an object with unique identifiers
• Direct object manipulation: Transactions directly reference and modify objects
• Ownership types: Shared, owned, and immutable objects enable different consensus paths
• Composability: Objects can contain other objects, enabling complex data structures

Move Programming Language

Sui utilizes Move, a resource-oriented programming language designed for safe asset management:

• Resource safety: Prevents duplication and accidental deletion of digital assets
• Formal verification: Mathematical proofs ensure contract correctness
• Module system: Reusable code components for efficient development
• Native asset handling: Built-in support for fungible and non-fungible tokens

Consensus Innovation

Sui's consensus mechanism optimizes for different transaction types:

• Simple transactions: Skip consensus for single-owner object modifications
• Complex transactions: Narwhal and Bullshark consensus for shared objects
• Causal ordering: Maintains transaction dependencies without total ordering
• Byzantine fault tolerance: Secure against malicious actors

API Options

Dwellir provides two high-performance API options for accessing Sui:

JSON-RPC API

Traditional HTTP-based JSON-RPC interface with broad compatibility:

• Standard JSON request/response format
• Native browser support
• Extensive tooling ecosystem
• WebSocket event subscriptions

gRPC API

High-performance binary protocol for demanding applications:

• 5-10x faster serialization with Protocol Buffers
• 70% smaller payloads through binary encoding
• HTTP/2 multiplexing for concurrent requests
• Server streaming for real-time blockchain monitoring

Learn more about gRPC

API Reference

Sui exposes both JSON-RPC and gRPC methods through the reference tree above, covering transaction execution, object queries, balance lookups, event indexing, and validator-system data.

View all JSON-RPC methods

Getting Started

Connection Details

# Mainnet endpoint
https://api-sui-mainnet-full.n.dwellir.com/YOUR_API_KEY

Testnet access is currently provisioned through dedicated node clusters. Reach out to our team if you need a Sui testnet endpoint.

Quick Start Example

// Initialize connection
const provider = new JsonRpcProvider(
  'https://api-sui-mainnet-full.n.dwellir.com/YOUR_API_KEY'
);

// Query account balance
const balance = await provider.getBalance({
  owner: '0x...',
  coinType: '0x2::sui::SUI'
});

// Execute a transaction
const result = await provider.executeTransactionBlock({
  transactionBlock: signedTx,
  options: {
    showEffects: true,
    showEvents: true
  }
});

Use Cases

DeFi Applications

Build sophisticated financial protocols leveraging Sui's performance:

• High-frequency trading: Sub-second settlement for optimal execution
• Automated market makers: Efficient liquidity provision with minimal slippage
• Lending protocols: Real-time collateral management and liquidations
• Yield aggregators: Complex multi-protocol strategies

Gaming & NFTs

Create immersive gaming experiences with true digital ownership:

• On-chain gaming: Real-time gameplay with instant state updates
• Dynamic NFTs: Evolving digital assets with programmable attributes
• Gaming economies: Complex in-game economies with tradeable assets
• Metaverse applications: Scalable virtual worlds with millions of objects

Social & Creator Platforms

Develop next-generation social applications:

• Decentralized social: User-owned content and relationships
• Creator monetization: Direct fan engagement without intermediaries
• Content distribution: Efficient media delivery with proof of ownership
• Reputation systems: Portable identity and achievement tracking

Network Specifications

Best Practices

Optimize Performance

• Batch requests: Combine multiple calls for efficiency
• Object caching: Store frequently accessed objects locally
• Event filtering: Use precise filters to reduce data transfer
• Connection pooling: Reuse connections for better throughput

Handle Errors Gracefully

• Implement retries: Automatic retry with exponential backoff
• Monitor rate limits: Track usage to avoid throttling
• Validate inputs: Check object versions and ownership before submission
• Error classification: Distinguish between temporary and permanent failures

Security Considerations

• Secure key management: Never expose private keys in code
• Transaction validation: Verify transaction effects before confirmation
• Input sanitization: Validate all user inputs before processing
• Access control: Implement proper authentication for sensitive operations

Support & Resources

Developer Resources

• API Reference: Complete method documentation with examples
• Integration Guides: Step-by-step tutorials for common use cases
• Code Samples: Production-ready examples in multiple languages
• SDK Support: Official libraries for seamless integration

Get Help

• Email: support@dwellir.com
• Documentation: Comprehensive guides and API references
• Dashboard: dashboard.dwellir.com

Related Reading

• Best Sui RPC Providers 2026

Ready to build on Sui? Get your API key and start developing with Dwellir's enterprise-grade infrastructure today.

Need assistance? Contact our support team for expert guidance on Sui development.