API Reference

Complete documentation for all Inodra API methods and gateways.

📚 Interactive REST API Documentation

https://api.inodra.com/docs - Full interactive REST API documentation powered by OpenAPI with live request testing, complete schemas, and code generation support.

Gateway Documentation

Complete guides for each gateway type:

gRPC Proxy

High-performance binary protocol with server reflection enabled.

• Endpoint: grpc.inodra.com:443 (TLS required)
• Proto Files:Sui gRPC Proto Definitions
• API Reference: Sui gRPC Documentation
• Server Reflection: Enabled - use grpcurl for service discovery

JSON-RPC Gateway

Drop-in replacement for Sui RPC nodes with long-term support commitment.

• Endpoint: https://api.inodra.com/v1/jsonrpc
• Methods: Complete Sui JSON-RPC compatibility
• Sui Reference: Sui JSON-RPC Documentation

Note: While Sui has deprecated JSON-RPC, Inodra maintains full compatibility by translating requests to GraphQL/gRPC behind the scenes.

GraphQL Proxy

Flexible queries through Inodra-managed Sui GraphQL nodes.

• Endpoint: https://api.inodra.com/v1/graphql
• Schema Reference: Sui GraphQL Schema
• Concepts Guide: Sui GraphQL Concepts
• Examples: Sui GraphQL Examples

REST API

Indexed Sui data with powerful filtering, pagination, and analytics.

• Base URL: https://api.inodra.com/v1/
• Interactive Docs: api.inodra.com/docs
• OpenAPI Spec: openapi.json

Authentication

All gateways use the same API key authentication:

Primary Method (Recommended):

curl -H "x-api-key: YOUR_API_KEY" https://api.inodra.com/v1/checkpoints

Alternative Method (Also Supported):

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.inodra.com/v1/checkpoints

Rate Limits

• Standard rate limits apply across all gateways
• HTTP 429 returned when limits exceeded
• Retry-After header indicates wait time in seconds
• Check response headers:
  • X-RateLimit-Limit - Total requests allowed
  • X-RateLimit-Remaining - Requests remaining
  • X-RateLimit-Reset - Unix timestamp when limit resets

For higher limits, contact [email protected].

Quick Start Examples

JSON-RPC

const response = await fetch('https://api.inodra.com/v1/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'sui_getLatestCheckpointSequenceNumber',
    params: []
  })
})

GraphQL

const query = `
  query {
    checkpoints(last: 5) {
      nodes {
        sequenceNumber
        timestamp
      }
    }
  }
`

const response = await fetch('https://api.inodra.com/v1/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({ query })
})

gRPC

# List all services (server reflection enabled)
grpcurl -H "x-api-key: YOUR_API_KEY" \
  grpc.inodra.com:443 list

# Make a call
grpcurl -H "x-api-key: YOUR_API_KEY" \
  -d '{}' \
  grpc.inodra.com:443 \
  sui.rpc.v2.LedgerService/GetLatestCheckpoint

REST API

# Get latest checkpoints
curl -H "x-api-key: YOUR_API_KEY" \
  'https://api.inodra.com/v1/checkpoints/latest'

# Get transactions
curl -H "x-api-key: YOUR_API_KEY" \
  'https://api.inodra.com/v1/transactions/latest?limit=10'

Need Help?

• Interactive API Docs - Try REST endpoints in your browser
• Troubleshooting Guide - Common issues and solutions
• Discord Community - Get help from the community
• Support Email - Direct support

External References

For complete method specifications and advanced usage:

• Sui Official API Documentation - Comprehensive Sui API reference
• Sui GraphQL Reference - GraphQL schema and query guide
• Sui RPC Concepts - Understanding Sui's RPC architecture