​
Step 1: Understand OneBalance

Get familiar with how OneBalance simplifies blockchain development through chain abstraction.

What is OneBalance

Learn the core concepts and benefits of chain abstraction

How it Works

Understand the technical architecture behind OneBalance

​
Step 2: Build Your First Chain Abstraction PoC (15 minutes)

Experience the power of OneBalance by building a working proof of concept.

​
Quickstart Path

1

Environment Setup

Follow our setup guide to configure your development environment
2

Make Your First API Call

Test the waters with a simple balance query
3

Execute a Chain-Abstracted Swap

Build a complete chain-abstracted swap in minutes

​
Explore Code Examples

Privy Integration Guide

Complete tutorial with Privy wallet integration

API Reference

Explore all available endpoints and their parameters

Quote Examples

Ready-to-use code snippets for common operations

Contract Calls Examples

Ready-to-use code examples for common DeFi, NFT, and gaming use cases

​
Step 3: Build Your Production App

Choose your stack and configure OneBalance for your specific use case.

​
Choose Your Wallet Provider

Privy

Recommended for most applications

Turnkey

Great for enterprise solutions

Custom

Build your own wallet integration

​
Configure Advanced Features

User Account Management

Set up smart account management for your users

Fee Configuration

Configure monetization strategies and gas sponsorship for your app

Supported Networks

Review supported networks and choose the chains for your app

Asset Configuration

Explore supported assets and configure which tokens your app will support

​
Integration Patterns

Contract Calls

Execute arbitrary smart contract interactions

Transaction Lifecycle

Understand how transactions flow through OneBalance

​
Step 4: Deploy to Production

Launch your app with confidence using OneBalance’s production infrastructure.

​
Production API Key Request

Production Access Required: Use the Intercom chat widget in the bottom right corner or contact our team at support@onebalance.io to receive your production API keys.
When requesting your production API key, provide the following information to ensure proper configuration:
  • Company name and project name
  • Use case description - what you’re building with OneBalance
  • Expected transaction volume - estimated transactions per day/month
  • Preferred chains - which networks you plan to use (see supported networks)
  • Asset preferences - which tokens you need access to (or you can choose from our predefined list)
Our team typically responds within 24 hours with your configured API key.

​
Monetization & Fee Setup

If you want to monetize transactions and collect fees from your users, you’ll need to configure paymaster settings: Required for fee collection:
  • Pimlico API key - for gas sponsorship
  • Pimlico Policy ID - your paymaster policy configuration
  • Beneficiary wallet address - where collected fees will be sent
  • Flat fees per chain - USD amounts for each supported network (e.g., $2 for Ethereum, $0.1 for Arbitrum)
Fee configuration is handled by the OneBalance team. See our fees documentation for detailed information on how monetization works.

​
API Keys & Authentication

  • Implement proper authentication in your app using your production key
  • Contact us if you need higher rate limits for your use case

​
Testing & Monitoring

  • Test your setup: Send a sample transaction using your production API key to verify everything works correctly
  • Implement transaction status monitoring using our status endpoints
  • Set up error handling and logging for production reliability

Enterprise Solutions

Need custom rate limits, dedicated support, or enterprise features? Talk to our sales team about tailored solutions.

​
Launch Benefits

Simplified UX

Users interact with one balance across all chains

Efficient Execution

Optimized routing and gas management

Revenue Growth

Reduced friction drives higher conversion

​
Resources & Support

Developer Support

Use the Intercom chat widget for instant help or email support@onebalance.io

Discord Community

Connect with other developers building on OneBalance
We’re happy to introduce you to our ecosystem partners for complementary services like analytics, security audits, and infrastructure providers.