Get quote

Authorizations

x-api-key

string

header

required

The OneBalance API uses API keys to authenticate requests. All API requests require authentication using an API key passed in the x-api-key header:

curl -X 'GET' \
  'https://be.onebalance.io/api/path-to/endpoint' \
  -H 'x-api-key: ${ONEBALANCE_API_KEY}' \
  ...

A public API key is available for testing purposes with limited usage: 42bb629272001ee1163ca0dbbbc07bcbb0ef57a57baf16c4b1d4672db4562c11.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Learn how to generate API access tokens at OneBalance Docs.

Body

application/json

Quote request with support for multiple account types (v3)

from

object

required

Source configuration for the quote

Show child attributes

from.accounts

(Role-based Account · object | Basic Account · object | EIP-7702 Account · object | Solana Account · object)[]

required

Array of account configurations. At least one account is required. Cannot combine multiple accounts of the same chain type.

Required array length: 1 - 10 elements

Account configuration supporting multiple blockchain types.

Account Compatibility Rules:

Cannot combine multiple accounts of the same chain type
Solana accounts can be combined with any EVM account type
Single account operations are supported for any account type

Supported Account Types:

role-based: Traditional EVM account with session/admin addresses
kernel-v3.1-ecdsa: Kernel v3.1 ECDSA smart account
kernel-v3.3-ecdsa: Kernel v3.3 ECDSA smart account with EIP-7702 support
solana: Solana blockchain account

Role-based Account
Basic Account
EIP-7702 Account
Solana Account

Show child attributes

from.accounts.type

enum<string>

required

Account type identifier for role-based accounts

Available options:

role-based

Example:

"role-based"

from.accounts.sessionAddress

string

required

Address associated with user's ECDSA signing key used for session-based operations

Example:

"0x1cBFbFd62a276BF6D79d504eA4CA75a7baDcf5b1"

from.accounts.adminAddress

string

required

Address selected by the user as backup admin. Can perform rage quit and key rotation. Must be different from sessionAddress.

Example:

"0xc162a3cE45ad151eeCd0a5532D6E489D034aB3B8"

from.accounts.accountAddress

string

required

Address of user's smart contract wallet (counterfactual if not yet deployed)

Example:

"0xa8305CAD3ECEA0E4B4a02CE45E240e8687B4C2E0"

Example:

[
  {
    "type": "solana",
    "accountAddress": "J5CCzBULFax899tcirb6wMbenQUd8whbaetG7EfSick5"
  }
]

from.asset

object

required

Asset to quote from. Choose between:

Aggregated assets: Let OneBalance optimize across chains (e.g., "ob:usdc")
Chain-specific assets: Spend from exact tokens on specific chains (e.g., "eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48")

Option 1
Option 2

Show child attributes

from.asset.assetId

string

required

The aggregated asset ID (e.g., ob:usd, ob:eth)

Example:

"ob:eth"

from.amount

string

required

Amount to transfer/swap in the smallest unit of the asset

Example:

"10000000"

Example:

{
  "accounts": [
    {
      "type": "solana",
      "accountAddress": "J5CCzBULFax899tcirb6wMbenQUd8whbaetG7EfSick5"
    }
  ],
  "asset": {
    "assetId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501"
  },
  "amount": "10000000"
}

object

required

Destination configuration for the quote

Show child attributes

to.asset

object

required

Asset to quote to. Choose between:

Aggregated assets: Let OneBalance find optimal destination (e.g., "ob:usdc")
Chain-specific assets: Target exact tokens on specific chains (e.g., "eip155:42161/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831")

Option 1
Option 2

Show child attributes

to.asset.assetId

string

required

The aggregated asset ID (e.g., ob:usd, ob:eth)

Example:

"ob:eth"

to.account

string

Optional recipient account identifier in CAIP-10 format. If not provided, assets will be sent to the first account in the accounts array.

Example:

"eip155:42161:0x895Cf62399bF1F8b88195E741b64278b41EB7F09"

Example:

{
  "asset": {
    "assetId": "eip155:42161/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
  },
  "account": "eip155:42161:0x895Cf62399bF1F8b88195E741b64278b41EB7F09"
}

slippageTolerance

integer

Slippage tolerance in basis points (1/100th of a percent). For example, 50 = 0.5%, 100 = 1%, 1000 = 10%.

Required range: x >= 1

Example:

50

Response

Quote generated successfully

Quote response with support for multiple blockchain types (v3)

string

required

Unique quote identifier

Example:

"0xcd3a5cfe80d1b84db755bfb8ebe0a617ff153cc48ab6d5ab28436386f06ce100"

accounts

(Role-based Account · object | Basic Account · object | EIP-7702 Account · object | Solana Account · object)[]

required

Array of accounts used in this quote

Minimum array length: 1

Account configuration supporting multiple blockchain types.

Account Compatibility Rules:

Cannot combine multiple accounts of the same chain type
Solana accounts can be combined with any EVM account type
Single account operations are supported for any account type

Supported Account Types:

role-based: Traditional EVM account with session/admin addresses
kernel-v3.1-ecdsa: Kernel v3.1 ECDSA smart account
kernel-v3.3-ecdsa: Kernel v3.3 ECDSA smart account with EIP-7702 support
solana: Solana blockchain account

Role-based Account
Basic Account
EIP-7702 Account
Solana Account

Show child attributes

accounts.type

enum<string>

required

Account type identifier for role-based accounts

Available options:

role-based

Example:

"role-based"

accounts.sessionAddress

string

required

Address associated with user's ECDSA signing key used for session-based operations

Example:

"0x1cBFbFd62a276BF6D79d504eA4CA75a7baDcf5b1"

accounts.adminAddress

string

required

Address selected by the user as backup admin. Can perform rage quit and key rotation. Must be different from sessionAddress.

Example:

"0xc162a3cE45ad151eeCd0a5532D6E489D034aB3B8"

accounts.accountAddress

string

required

Address of user's smart contract wallet (counterfactual if not yet deployed)

Example:

"0xa8305CAD3ECEA0E4B4a02CE45E240e8687B4C2E0"

Example:

[
  {
    "type": "solana",
    "accountAddress": "J5CCzBULFax899tcirb6wMbenQUd8whbaetG7EfSick5"
  }
]

originChainsOperations

object[]

required

Array of blockchain operations to execute, supporting both EVM and Solana

Chain operation containing user operation data, typed data to sign, and optional EIP-7702 delegation.

When EIP-7702 delegation is required, the delegation field will be present and must be signed before submission.

Option 1
Option 2

Show child attributes

originChainsOperations.userOp

object

required

User Operation data (serialized).

Show child attributes

originChainsOperations.userOp.sender

string

required

The address of the sender (EOA or Smart Contract).

Example:

"0xb8e4b017f4a8870e3eb4eb15c5e180d2a34d877b"

originChainsOperations.userOp.nonce

string

required

Nonce for the UserOp, ensures uniqueness. Incremented for each operation.

Example:

"1120126849530..."

originChainsOperations.userOp.callData

string

required

Hex-encoded data representing the actual call to be made.

Example:

"0xe9ae5c530100000000000000000000000000..."

originChainsOperations.userOp.callGasLimit

string

required

Gas limit for executing the callData portion.

Example:

"737280"

originChainsOperations.userOp.verificationGasLimit

string

required

Gas limit for the verification step (signature checks, etc.).

Example:

"3076170"

originChainsOperations.userOp.preVerificationGas

string

required

Gas used for overhead, e.g., hashing, EVM overhead, etc.

Example:

"0"

originChainsOperations.userOp.maxFeePerGas

string

required

Maximum fee (in wei) per gas unit.

Example:

"0"

originChainsOperations.userOp.maxPriorityFeePerGas

string

required

Priority fee (tip) per gas unit.

Example:

"0"

originChainsOperations.userOp.paymaster

string

required

Address of the paymaster that will sponsor or pay for gas.

Example:

"0xa784e6482bd5edbfe5991b18cbd545ebd46e1cc4"

originChainsOperations.userOp.paymasterVerificationGasLimit

string

required

Gas limit for the paymaster verification step.

Example:

"19219"

originChainsOperations.userOp.paymasterPostOpGasLimit

string

required

Additional gas limit for the paymaster post-operation.

Example:

"0"

originChainsOperations.userOp.paymasterData

string

required

Additional data used by the paymaster, if any.

Example:

"0x"

originChainsOperations.userOp.signature

string

required

Signature for the entire user operation.

Example:

"0x8cbd9df26744e2a02cde9fb8832d2b5f..."

originChainsOperations.userOp.factory

string

The address of the factory that may be used to create an account contract (optional for deployed accounts).

Example:

"0xd703aae79538628d27099b8c4f621be4ccd142d5"

originChainsOperations.userOp.factoryData

string

Hex-encoded data for the factory (optional, if needed to deploy or initialize an account).

Example:

"0xc5265d5d000000000000000000000000..."

originChainsOperations.typedDataToSign

object

required

Typed data to sign (EIP-712).

Show child attributes

originChainsOperations.typedDataToSign.domain

object

required

EIP-712 domain separator data (e.g. name, version, chainId, verifyingContract).

Example:

{
  "name": "RoleBasedECDSAValidator",
  "version": "1.4.3",
  "chainId": 10,
  "verifyingContract": "0xA24bD06230f3F54e5bf266AE7A41750eE3b789FA"
}

originChainsOperations.typedDataToSign.types

object

required

EIP-712 type definitions for the message. Must include at least the primary type.

Example:

{
  "Approve": [
    {
      "name": "callDataAndNonceHash",
      "type": "bytes32"
    }
  ]
}

originChainsOperations.typedDataToSign.primaryType

string

required

Primary type string from the types object.

Example:

"Approve"

originChainsOperations.typedDataToSign.message

object

required

Data to be signed (structured according to the types).

Example:

{
  "callDataAndNonceHash": "0xaab2ddac63e4a7e25b7d339cacdff2f9..."
}

originChainsOperations.assetType

string

required

CAIP-19/CAIP-20 asset type, or e.g. "eth", "erc20:0x..." etc.

Example:

"eip155:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"

originChainsOperations.amount

string

required

Amount in the smallest unit (wei for ETH, or token decimals).

Example:

"8000000"

originChainsOperations.delegation

object

EIP-7702 delegation object (present only if account needs delegation on this chain).

Must be signed using wallet's signAuthorization method before submission.

Show child attributes

originChainsOperations.delegation.contractAddress

string

required

Address of the Kernel v3.3 smart account contract to delegate to

Example:

"0xd6CEDDe84be40893d153Be9d467CD6aD37875b28"

originChainsOperations.delegation.nonce

integer

required

Delegation nonce for preventing replay attacks. Must match the current nonce for the account on the target chain.

Required range: x >= 0

Example:

0

originChainsOperations.delegation.signature

object

Delegation signature (populated after signing with wallet's signAuthorization method)

Show child attributes

originChainsOperations.delegation.signature.chainId

integer

required

Chain ID where delegation occurs

Required range: x >= 1

Example:

10

originChainsOperations.delegation.signature.contractAddress

string

required

Contract address being delegated to (must match delegation contractAddress)

Example:

"0xd6CEDDe84be40893d153Be9d467CD6aD37875b28"

originChainsOperations.delegation.signature.nonce

integer

required

Delegation nonce (must match delegation nonce)

Required range: x >= 0

Example:

0

originChainsOperations.delegation.signature.r

string

required

ECDSA signature r value

Example:

"0x129b258b9d85f91dab87e488dea08e2803e88a96bb6a967d16fe158a09d95d0d"

originChainsOperations.delegation.signature.s

string

required

ECDSA signature s value

Example:

"0x52adbaca42ea5b316df5ac0a6ae5f544f5eb450d94c76164e27252101e22d3c3"

originChainsOperations.delegation.signature.v

string

required

ECDSA signature v value (recovery ID)

Example:

"0x1b"

originChainsOperations.delegation.signature.yParity

enum<integer>

required

Y parity of the signature point (0 or 1)

Available options:

0,

1

Example:

0

originChainsOperations.delegation.signature.type

enum<string>

required

Signature type identifier indicating the signature has been completed

Available options:

Signed

Example:

"Signed"

Example:

[
  {
    "type": "solana",
    "instructions": [
      {
        "keys": [
          {
            "pubkey": "J5CCzBULFax899tcirb6wMbenQUd8whbaetG7EfSick5",
            "isSigner": true,
            "isWritable": true
          }
        ],
        "programId": "11111111111111111111111111111111",
        "data": "020000008096980000000000"
      }
    ],
    "recentBlockHash": "2UoZifqUWTS8vZF25LrpJJUwabdDrfRqXSLMScDh4WDp",
    "feePayer": "6roz4r5VGs67YdDvjNdALSQgXZecwqUzpqvmKTdmjXyH",
    "assetType": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501",
    "amount": "10000000",
    "dataToSign": "gAIABQ1XDQTmmqW/djyUx9QxVovp4LBhd9nKW9lbKmZgBJpASP2prCGRAhJ2LZxv7WJqmNSI35tMGa1fy+dTOYTdb2um"
  }
]

originToken

object

required

Show child attributes

originToken.aggregatedAssetId

string

required

The aggregated asset ID (e.g., ob:usd)

Example:

"ob:eth"

originToken.amount

string

required

The amount of the token

Example:

"1000000000000000000"

originToken.assetType

string[]

required

The type of the individual assets (e.g., eip155:1/erc20:... or eip155:1/slip44:...)

Example:

[
  "eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7",
  "eip155:1/slip44:60"
]

originToken.fiatValue

object[]

required

The fiat values of the individual asset types

Show child attributes

originToken.fiatValue.assetType

string

required

The CAIP-19 asset type identifier (e.g., eip155:1/erc20:... or eip155:1/slip44:...).

Example:

"eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7"

originToken.fiatValue.fiatValue

string

required

The fiat value of the individual asset in USD

Example:

"100"

Example:

[
  {
    "assetType": "eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7",
    "fiatValue": "1800.00"
  },
  {
    "assetType": "eip155:1/slip44:60",
    "fiatValue": "1800.00"
  }
]

destinationToken

object

required

Show child attributes

destinationToken.aggregatedAssetId

string

required

The aggregated asset ID (e.g., ob:usd)

Example:

"ob:usdc"

destinationToken.amount

string

required

The amount of the token

Example:

"100000000"

destinationToken.assetType

string

required

The type of the individual asset (e.g., eip155:1/erc20:... or eip155:1/slip44:...)

Example:

"eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7"

destinationToken.fiatValue

string

required

The fiat value of the individual asset in USD

Example:

"100"

destinationToken.minimumAmount

string

The minimum amount of the token

Example:

"100"

destinationToken.minimumFiatValue

string

The minimum fiat value of the token

Example:

"100"

destinationToken.symbol

string

The token symbol (e.g., USDC, ETH)

Example:

"USDC"

destinationToken.name

string

The human-readable name of the token

Example:

"USDC"

destinationToken.decimals

integer

The number of decimal places for the token

Example:

18

destinationToken.recipientAccount

string

The recipient account address with chain identifier where the destination tokens will be received

Example:

"eip155:42161:0x895Cf62399bF1F8b88195E741b64278b41EB7F09"

expirationTimestamp

string

required

Unix timestamp when the quote expires

Example:

"1752673847"

tamperProofSignature

string

required

Cryptographic signature to verify quote integrity

Example:

"0x1ae7e61279f297d5e6bd702388db0069a3cc2b5168eecd91b53ea0b8bbdf7c412742dd8f0ab778c9a3faa7be38031ce6279b65c202b920c65632840accf01d021c"

slippage

object

Slippage information for origin and destination

Show child attributes

slippage.origin

object

Show child attributes

slippage.origin.percent

string

Slippage percentage

Example:

"3.57"

slippage.origin.usd

string

Slippage amount in USD

Example:

"0.059593"

slippage.origin.value

string

Slippage amount in asset units

Example:

"59761"

Example:

{
  "percent": "3.57",
  "usd": "0.059593",
  "value": "59761"
}

slippage.destination

object

Show child attributes

slippage.destination.percent

string

Slippage percentage

Example:

"3.45"

slippage.destination.usd

string

Slippage amount in USD

Example:

"0.054180"

slippage.destination.value

string

Slippage amount in asset units

Example:

"54279"

Example:

{
  "percent": "3.45",
  "usd": "0.054180",
  "value": "54279"
}

Example:

{
  "origin": {
    "percent": "3.57",
    "usd": "0.059593",
    "value": "59761"
  },
  "destination": {
    "percent": "3.45",
    "usd": "0.054180",
    "value": "54279"
  }
}

fees

object

Fee breakdown by asset type

Show child attributes

fees.assets

object

Fee amounts by asset type

Show child attributes

fees.assets.{key}

string

Fee amount in the asset's smallest unit

Example:

{
  "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501": "183581",
  "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": "93373"
}

fees.cumulativeUSD

string

Total fees in USD

Example:

"0.12"

Example:

{
  "assets": {
    "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501": "183581",
    "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": "93373"
  },
  "cumulativeUSD": "0.12"
}

API Reference

EVM Operations

Multi-Chain Operations

Platform Data

Authorizations

Body

Response