# OneBalance Docs

## Docs

- [Building with LLMs](https://docs.onebalance.io/ai/building-with-llms.md): Learn how to use OneBalance with LLMs like ChatGPT or Claude. Our docs are AI-ready, making it easy to integrate into your models and dev tools.
- [MCP Example Prompts](https://docs.onebalance.io/ai/mcp-prompts.md): Ready-to-use prompts for OneBalance's MCP, helping you quickly test, explore and ship AI-driven chain abstracted features.
- [MCP Server Setup](https://docs.onebalance.io/ai/mcp-server-setup.md): How to connect the OneBalance Toolkit to your preferred AI tools like Claude and Cursor, using MCP to speed up your development process.
- [Predict address](https://docs.onebalance.io/api-reference/account/predict-address.md): Predicts the address for a new OneBalance smart account based on the provided EVM-compatible signer addresses (session and admin). This allows you to determine the smart account's on-chain address before its actual deployment. This predicted address serves as a primary identifier for the user within the OneBalance ecosystem.
- [List aggregated assets](https://docs.onebalance.io/api-reference/assets/list.md): Retrieves a list of all aggregated assets currently supported and enabled on the OneBalance platform. Each aggregated asset includes details such as its unique ID, symbol, name, decimals, and the underlying individual assets (chain-specific tokens) that constitute it, identified by their CAIP-19 asset types.

Learn more about aggregated assets in our [documentation](https://docs.onebalance.io/concepts/aggregated-assets).

- [Authentication](https://docs.onebalance.io/api-reference/authentication.md): Authenticate your API requests with OneBalance using API keys
- [Get aggregated balance](https://docs.onebalance.io/api-reference/balances/aggregated-balance.md): Fetches the aggregated balance of all supported assets for a given smart account address, with an option to filter by specific assetId`s.
- [Get aggregated balance](https://docs.onebalance.io/api-reference/balances/aggregated-balance-v3.md): Fetches the aggregated balance of assets for given accounts with support for multiple chain types (EVM, Solana, etc.). Returns a unified view with all balances intermixed. Supports filtering by specific aggregated asset IDs.
- [List supported chains](https://docs.onebalance.io/api-reference/chains/list.md): Retrieves a list of all blockchain networks currently integrated with and supported by the OneBalance platform.
- [Cross Origin Resource Sharing](https://docs.onebalance.io/api-reference/cors.md): Information about CORS support in the OneBalance API
- [Error Codes](https://docs.onebalance.io/api-reference/error-codes.md): Learn more about error codes and how to resolve them.
- [Errors](https://docs.onebalance.io/api-reference/errors.md): Complete list of error codes with explanations and troubleshooting tips
- [Introduction](https://docs.onebalance.io/api-reference/introduction.md): Overview of the OneBalance API, versioning, and general conventions
- [Pagination](https://docs.onebalance.io/api-reference/pagination.md): How to work with paginated API responses
- [Execute quote](https://docs.onebalance.io/api-reference/quotes/execute-quote.md): Execute a previously generated quote to transfer funds.
- [Execute quote](https://docs.onebalance.io/api-reference/quotes/execute-quote-v3.md): Execute a previously generated quote to transfer funds with support for multiple blockchain types including Solana.
- [Get call quote](https://docs.onebalance.io/api-reference/quotes/get-call-quote.md): Gets a quote for arbitrary contract call operations on a specific chain. This endpoint handles the execution of pre-signed user operations with typed data signatures, supporting interactions with smart contracts.

- [Get call quote](https://docs.onebalance.io/api-reference/quotes/get-call-quote-v3.md): Gets a quote for arbitrary contract call operations with multi-account support. This V3 endpoint extends the V1 functionality by supporting cross-chain operations with mixed Solana and EVM accounts, and handles the execution of pre-signed user operations with typed data signatures.

**V3 Multi-Account Features:**
- Cross-chain operations with mixed Solana and EVM accounts
- Source asset specification via `fromAggregatedAssetId` for bridging
- EIP-7702 delegation support for EOA-based contract calls
- Multi-account routing for complex cross-chain scenarios    

- [Get quote](https://docs.onebalance.io/api-reference/quotes/get-quote.md): Request a quote for transferring or swapping assets.

**Asset Flexibility:**
- Use aggregated assets (e.g., "ob:usdc") for optimal cross-chain routing
- Use chain-specific assets (e.g., "eip155:42161/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831") for precise control
- Mix and match aggregated and specific assets in the same transaction

- [Get quote](https://docs.onebalance.io/api-reference/quotes/get-quote-v3.md): Request a quote for transferring or swapping assets with support for multiple account types including Solana and EVM accounts.

**Key Capabilities:**
- Multiple accounts in a single request
- Cross-chain operations between Solana and EVM chains
- **Chain-specific token spending** for precise control alongside aggregated assets
- Unified responses for different blockchain types

**Account Requirements:**
- At least one account must be provided in the accounts array
- Cannot combine multiple accounts of the same chain type (e.g., two EVM accounts)
- Can combine Solana account with any EVM account type
- Single account operations are supported (Solana-only or EVM-only)

- [Prepare call quote](https://docs.onebalance.io/api-reference/quotes/prepare-call-quote.md): Prepares the necessary data structure for executing one or more contract calls on a target chain. This endpoint helps construct the appropriate user operation, handles token allowance requirements, and generates a signed quote ready for execution.

- [Prepare call quote](https://docs.onebalance.io/api-reference/quotes/prepare-call-quote-v3.md): Prepares the necessary data structure for executing one or more contract calls on a target chain with multi-account support. This V3 endpoint extends the V1 functionality by supporting cross-chain operations with mixed Solana and EVM accounts.

**V3 Multi-Account Features:**
- Cross-chain operations with mixed Solana and EVM accounts
- Source asset specification via `fromAssetId` for bridging
- EIP-7702 delegation support for EOA-based contract calls
- Multi-account routing for complex cross-chain scenarios        

- [Rate Limits](https://docs.onebalance.io/api-reference/rate-limits.md): Information about API rate limits and how to handle them
- [Get quote status](https://docs.onebalance.io/api-reference/status/get-quote-status.md): Retrieves the execution status of a quote by its quote ID as well as transaction hashes for user operations
- [Get quote status](https://docs.onebalance.io/api-reference/status/get-quote-status-v3.md): Retrieves the execution status of a quote by its quote ID as well as transaction hashes for user operations with support for multiple blockchain types including Solana.
- [Get transaction history](https://docs.onebalance.io/api-reference/status/get-transaction-history.md): Retrieves the transaction history for an address, including the transaction type and token details.
- [Get transaction history](https://docs.onebalance.io/api-reference/status/get-transaction-history-v3.md): Retrieves the transaction history for an address, including the transaction type and token details with support for multiple blockchain types including Solana.
- [Toolkit Changelog](https://docs.onebalance.io/changelog.md): Stay updated with the latest launches, chain integrations, improvements, and fixes in the OneBalance Toolkit.
- [API Changelog](https://docs.onebalance.io/changelog/api.md): Track OneBalance API updates, new endpoints, breaking changes, and feature releases with detailed migration guides
- [Account Models](https://docs.onebalance.io/concepts/accounts.md): Learn about our different account types, including 4337 and 7702 and how to choose the right setup for your app.
- [Aggregated Assets](https://docs.onebalance.io/concepts/aggregated-assets.md): Learn how OneBalance aggregates assets across chains into a unified balance, simplifying cross-chain token management and tracking.
- [Fees & Monetization](https://docs.onebalance.io/concepts/fees.md): Understand OneBalance's fee and monetization model, including how fees are calculated and how apps earn revenue through OneBalance transactions.
- [Resource Locks](https://docs.onebalance.io/concepts/resource-locks.md): How Resource Locks enable fast cross-chain transactions by eliminating finality wait times and preventing double-spending
- [Signing](https://docs.onebalance.io/concepts/signing.md): Learn how to sign transactions and operations with OneBalance across different account types and blockchains
- [Transaction Lifecycle](https://docs.onebalance.io/concepts/transaction-lifecycle.md): Learn the full lifecycle of a OneBalance transaction, from quote generation and signing to execution and final confirmation.
- [FAQ](https://docs.onebalance.io/faq.md): Frequently asked questions about OneBalance, with quick answers on features, support, and developer resources.
- [FAQ: AI](https://docs.onebalance.io/faq/ai.md): AI-focused FAQs covering how LLMs and MCP integrate with the OneBalance Toolkit for automated, AI-driven API interactions.
- [FAQ: API](https://docs.onebalance.io/faq/api.md): Common questions about OneBalance API usage, authentication, rate limits, error handling, and integration patterns
- [FAQ: General](https://docs.onebalance.io/faq/general.md): General FAQs about the OneBalance Toolkit, covering product usage, integration steps, troubleshooting, and developer support details.
- [FAQ: Signing](https://docs.onebalance.io/faq/signing.md): Common questions about transaction signing across different account types, blockchains, and integration patterns
- [FAQ: Solana](https://docs.onebalance.io/faq/solana.md): Frequently asked questions about Solana integration with OneBalance, covering token support, API configuration, limitations, and troubleshooting.
- [Chain-Abstracted Swap](https://docs.onebalance.io/getting-started/chain-abstracted-swap.md): Learn how a cross-chain token swap works with OneBalance and Privy, eliminating manual bridging, gas fees, and network switching.
- [Your First API Call](https://docs.onebalance.io/getting-started/first-api-call.md): Learn to make your first OneBalance API call by setting up a smart contract account for chain-abstracted, gasless, cross-chain transactions.
- [Introduction](https://docs.onebalance.io/getting-started/introduction.md): Learn how to get started with the OneBalance Toolkit to begin removing onchain complexity like chains, bridges and gas in your app.
- [Set Up Your Environment](https://docs.onebalance.io/getting-started/setup.md): Set up your development environment with OneBalance and Privy by configuring keys and settings for an enhanced embedded wallet experience.
- [Building cross-chain swaps with OneBalance and Privy Tutorial](https://docs.onebalance.io/guides/chain-abstracted-swap-with-privy.md): Learn the key concepts for building a production-ready chain-abstracted token swap interface using OneBalance API and Privy embedded wallets.
- [Advanced Contract Call Patterns](https://docs.onebalance.io/guides/contract-calls/advanced-patterns.md): Explore advanced cross-chain contract call patterns in OneBalance, including multi-step flows and production optimizations.
- [Allowances & Approvals](https://docs.onebalance.io/guides/contract-calls/allowances-and-approvals.md): Learn how OneBalance manages token allowances and approvals, ensuring secure and gas-efficient transactions automatically.
- [Contract Call Examples](https://docs.onebalance.io/guides/contract-calls/examples.md): Explore OneBalance Toolkit contract call examples for DeFi, NFT, and payments, showing how cross-chain smart contract operations work.
- [How to Execute Smart Contract Calls](https://docs.onebalance.io/guides/contract-calls/getting-started.md): Learn to execute smart contract calls with OneBalance by preparing call data, signing, and submitting transactions across chains.
- [Contract Calls Overview](https://docs.onebalance.io/guides/contract-calls/overview.md): Overview of OneBalance smart contract calls, enabling cross-chain execution with gas abstraction and unified asset management.
- [Troubleshooting Contract Calls](https://docs.onebalance.io/guides/contract-calls/troubleshooting.md): Solutions to common issues in cross-chain contract calls with OneBalance, including debugging and error-handling best practices.
- [Getting Started with EIP-7702](https://docs.onebalance.io/guides/eip-7702/getting-started.md): Implement cross-chain contract calls using EIP-7702 delegation
- [EIP-7702 Overview](https://docs.onebalance.io/guides/eip-7702/overview.md): Enable EOAs to delegate execution to smart contracts for cross-chain operations
- [EIP-7702 Troubleshooting](https://docs.onebalance.io/guides/eip-7702/troubleshooting.md): Handle multi-input limitations and edge cases
- [Guides Overview](https://docs.onebalance.io/guides/overview.md): Learn how to use the OneBalance Toolkit with guides, code snippets and examples to help you with your integration journey.
- [Quote Examples](https://docs.onebalance.io/guides/quotes/examples.md): Explore OneBalance API quote request examples for transfers and swaps, showing how to structure cross-chain API calls.
- [Quotes Overview](https://docs.onebalance.io/guides/quotes/overview.md): Overview of OneBalance's quoting system: what quotes are, how they're generated, and how to use them in cross-chain operations.
- [Understanding Quote Refund Reasons](https://docs.onebalance.io/guides/quotes/refund-reasons.md): Learn about the different reasons why quotes get refunded and how to handle them in your application.
- [Slippage Tolerance Examples](https://docs.onebalance.io/guides/slippage/examples.md): Working code examples for implementing slippage tolerance across different OneBalance operations and asset types.
- [Slippage Tolerance Overview](https://docs.onebalance.io/guides/slippage/overview.md): Learn how slippage tolerance works in OneBalance to reduce quote refunds and improve transaction success rates.
- [Slippage Tolerance Troubleshooting](https://docs.onebalance.io/guides/slippage/troubleshooting.md): Common issues and solutions when implementing slippage tolerance in OneBalance integrations.
- [Solana Contract Calls](https://docs.onebalance.io/guides/solana/contract-calls.md): Execute smart contract calls on EVM chains using Solana assets as funding source
- [Solana Examples](https://docs.onebalance.io/guides/solana/examples.md): Working code examples for Solana integration with OneBalance, including transaction signing and cross-chain operations
- [Solana Getting Started](https://docs.onebalance.io/guides/solana/getting-started.md): Get your first Solana cross-chain swap working in 5 minutes with this complete working example
- [Solana Overview](https://docs.onebalance.io/guides/solana/overview.md): Learn how to aggregate both EVM and Solana balances for chain abstraction, enabling unified operations across all supported blockchains.
- [Solana Troubleshooting](https://docs.onebalance.io/guides/solana/troubleshooting.md): Common issues and solutions when integrating Solana with OneBalance
- [Turnkey Integration](https://docs.onebalance.io/guides/turnkey-integration.md): Learn how to integrate Turnkey with OneBalance API
- [OneBalance Documentation](https://docs.onebalance.io/index.md): A documentation for OneBalance - guides, API reference, tutorials, and resources to build chain-abstracted applications with ease
- [How OneBalance Works](https://docs.onebalance.io/overview/how-onebalance-works.md): Learn how the OneBalance toolkit integrates with your application to enable simple one-click interactions on any blockchain, action, or token.
- [Onboarding Checklist](https://docs.onebalance.io/overview/onboarding-checklist.md): Step-by-step onboarding checklist for building with OneBalance, from your first API call to deploying an app in production.
- [Welcome to OneBalance Toolkit](https://docs.onebalance.io/overview/what-is-onebalance.md): The OneBalance Toolkit is the simplest and most reliable way to bring your users onchain. We offer an all-in-one API platform that lets you build one-click crypto products.
- [Explore All Products](https://docs.onebalance.io/products.md): Explore all the OneBalance products from our Toolkit API, consumer app and our innovative cross-chain technology Resource Locks.
- [Benchmarks & Stress Tests](https://docs.onebalance.io/resources/benchmarks.md): Explore our regularly updated OneBalance Toolkit performance benchmarks and stress test results, for reliable cross-chain transactions.
- [Glossary](https://docs.onebalance.io/resources/glossary.md): A complete glossary of OneBalance-specific and chain abstraction topics, with clear definitions to support developers using our documentation.
- [Community & Support](https://docs.onebalance.io/resources/support.md): How to get support and connect with other builders using the OneBalance Toolkit building chain abstracted apps.
- [Supported Networks](https://docs.onebalance.io/resources/supported-networks.md): A full list of blockchains supported by the OneBalance Toolkit, including all major EVM networks, Solana, and soon Bitcoin.


## Optional

- [Get API Key](https://docs.onebalance.io/api-reference/authentication)
- [API Reference](https://docs.onebalance.io/api-reference/introduction)
- [Support](mailto:support@onebalance.io)