Skip to content

Getting Started

Welcome to Inodra! This guide will help you get up and running with the Sui blockchain infrastructure platform in just a few minutes.

Prerequisites

  • A basic understanding of blockchain concepts
  • Familiarity with API usage
  • A development environment set up for your preferred programming language

Step 1: Create Your Account

  1. Visit inodra.com
  2. Sign up for a free account
  3. Verify your email address
  4. Complete your profile setup

Step 2: Set Up Your Organization

Organizations help you manage API keys, team members, and billing:

  1. Navigate to the Organization section in your dashboard
  2. Create a new organization or join an existing one
  3. Invite team members if needed

Step 3: Create a Project

Projects organize your resources by Sui network:

  1. A default Mainnet project is created automatically
  2. Go to Projects in your dashboard to create additional projects
  3. Select the network (Mainnet or Testnet) for each project
  4. Use separate projects for development vs production

Learn more about Projects and how to organize your resources.

Step 4: Generate Your First API Key

API keys are required to access all Inodra services:

  1. Go to the API Keys section in your dashboard
  2. Select your project from the dropdown
  3. Click "Generate New Key"
  4. Provide a descriptive name (e.g., "Development Key")
  5. Choose an expiration date or set it to never expire
  6. Copy and securely store your API key

⚠️ Important: Your API key will only be shown once. Make sure to copy it to a secure location immediately.

Note: API keys are project-specific and will only work with endpoints for that project's network.

🚀 Don't have an account yet? Sign up free - it takes less than a minute.

Step 5: Make Your First Request

Test your setup with a simple API call:

bash
curl -X POST https://api.inodra.com/v1/jsonrpc \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_getLatestCheckpointSequenceNumber",
    "params": []
  }'

Replace YOUR_API_KEY with the API key you generated in Step 4.

Step 6: Explore Interactive Documentation

Visit api.inodra.com/docs to:

  • Browse all REST API endpoints with detailed schemas
  • Try requests directly in your browser with live testing
  • View request/response examples for every endpoint
  • Download the OpenAPI specification for code generation

Step 7: Choose Your Integration Method

Inodra offers multiple ways to interact with the Sui blockchain:

JSON-RPC Gateway

Perfect for existing Sui applications that use RPC calls.

javascript
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 Gateway

Ideal for flexible data querying with a single endpoint.

javascript
const query = `
  query {
    checkpoints(first: 10) {
      nodes {
        sequenceNumber
        timestamp
        transactionCount
      }
    }
  }
`

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 })
})

REST API

Best for applications that need structured, indexed data.

javascript
const response = await fetch('https://api.inodra.com/v1/checkpoints?limit=10', {
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
})

gRPC Gateway

High-performance option for applications requiring low latency. See the gRPC Gateway documentation for setup instructions and the migration guide if you're transitioning from JSON-RPC.

service SuiService {
  rpc GetLatestCheckpoint(GetLatestCheckpointRequest) returns (GetLatestCheckpointResponse);
}

🔜 Official SDKs Coming Early 2026

We're building official SDKs to make integration even easier:

  • TypeScript/JavaScript - Full-featured client library
  • Python - Async-ready Python client
  • Go - High-performance Go library
  • Rust - Native Rust implementation

Expected Release: Early 2026

For now, use our gateways directly with standard HTTP clients.

Next Steps

Now that you have your API key set up, explore these resources:

Need Help?

Ready to build something amazing? Let's go! 🚀

Released under the MIT License.