Prepare call 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

Details of the accounts, calls, and token requirements.

V3 prepare call request with multi-account support for cross-chain contract calls

accounts

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

required

Array of account configurations. Each account type must be unique. Supports mixed Solana and EVM accounts for cross-chain operations.

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

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": "EB8Hi4LoqUVCGUPJ2y9MsHbEsJQJvmpQRUWrLpjEZxC6"
  },
  {
    "type": "kernel-v3.3-ecdsa",
    "accountAddress": "0xDb69A4Ded06AaD92C69c42232b691CFD8bF347e8",
    "signerAddress": "0xDb69A4Ded06AaD92C69c42232b691CFD8bF347e8",
    "deploymentType": "EIP7702"
  }
]

targetChain

string

required

Target chain in CAIP-2 notation (e.g. "eip155:42161" for Arbitrum).

Example:

"eip155:42161"

calls

object[]

required

Array of contract calls to be executed on the target chain.

Minimum array length: 1

Show child attributes

calls.data

string

required

Hex-encoded call data.

Example:

"0x095ea7b3000000000000000000000000Bbef1E2dEA96c1c2001Eb48136e513A855F460970000000000000000000000000000000000000000000000000000000000000001"

calls.to

string

required

Address of the contract to be called.

Example:

"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"

calls.value

string

required

Amount of native currency (e.g. ETH) sent along with the call. Hex or decimal string.

Example:

"0"

Example:

[
  {
    "to": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "data": "0xa9059cbb0000000000000000000000004EbcFae0C3e747C95504CA7c79c46f725Cb4c7520000000000000000000000000000000000000000000000000000000000000001",
    "value": "0x0"
  }
]

tokensRequired

object[]

required

Array of tokens needed for these calls on the target chain.

Show child attributes

tokensRequired.assetType

string

required

CAIP-19 identifier for the required token

Example:

"eip155:1/erc20:0x6b175474e89094c44da98b954eedeac495271d0f"

tokensRequired.amount

string

required

Required amount of the token in its smallest unit (considering token decimals). For example, if a token has 6 decimals, "1" token is represented as "1000000"

Example:

"1000000000000000000"

Example:

[
  {
    "assetType": "eip155:42161/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "10000"
  }
]

allowanceRequirements

object[]

Optional array of token approvals required for the calls. Approvals need to be explicitly defined. Any approval passed as a call would result in a failing request.

Show child attributes

allowanceRequirements.assetType

string

required

CAIP-19 identifier for the required token

Example:

"eip155:1/erc20:0x6b175474e89094c44da98b954eedeac495271d0f"

allowanceRequirements.amount

string

required

Required amount of the token in its smallest unit (considering token decimals). For example, if a token has 6 decimals, "1" token is represented as "1000000"

Example:

"1000000000000000000"

allowanceRequirements.spender

string

The address that is approved to transfer a specific amount on behalf of the user.

Example:

"0x1234567890123456789012345678901234567890"

Example:

[
  {
    "assetType": "eip155:42161/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "10000",
    "spender": "0xDb69A4Ded06AaD92C69c42232b691CFD8bF347e8"
  }
]

overrides

object[]

Optional state overrides (e.g., fake balances for simulation).

Show child attributes

overrides.address

string

required

Address whose balance/storage is being overridden.

Example:

"0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B"

overrides.balance

string

required

Hex-encoded balance override, e.g. "0x1", "0x5F5E100" for 100000000 in decimal.

Example:

"0x1"

Example:

[
  {
    "address": "0xDb69A4Ded06AaD92C69c42232b691CFD8bF347e8",
    "balance": "0x1"
  }
]

validAfter

string

Permit valid after value in block timestamp.

Example:

"1686239400"

validUntil

string

Permit valid until value in block timestamp.

Example:

"1686339400"

fromAssetId

string

Source asset identifier to spend from for bridging to target chain. Can be either aggregated asset ID (e.g., "ob:usdc") or CAIP-19 asset type (e.g., "eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"). This field enables cross-chain spending from specific assets in multi-account setups.

Example:

"ob:usdc"

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

Call quote prepared successfully

V3 response from prepare-call-quote containing all necessary data to execute contract calls with multi-account support

accounts

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

required

Array of account configurations involved in the operation

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": "EB8Hi4LoqUVCGUPJ2y9MsHbEsJQJvmpQRUWrLpjEZxC6"
  },
  {
    "type": "kernel-v3.3-ecdsa",
    "accountAddress": "0xDb69A4Ded06AaD92C69c42232b691CFD8bF347e8",
    "signerAddress": "0xDb69A4Ded06AaD92C69c42232b691CFD8bF347e8",
    "deploymentType": "EIP7702"
  }
]

chainOperation

object

required

Operation (including userOp and typed data) to be executed on the target chain

Show child attributes

chainOperation.userOp

object

required

User Operation data (serialized).

Show child attributes

chainOperation.userOp.sender

string

required

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

Example:

"0xb8e4b017f4a8870e3eb4eb15c5e180d2a34d877b"

chainOperation.userOp.nonce

string

required

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

Example:

"1120126849530..."

chainOperation.userOp.callData

string

required

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

Example:

"0xe9ae5c530100000000000000000000000000..."

chainOperation.userOp.callGasLimit

string

required

Gas limit for executing the callData portion.

Example:

"737280"

chainOperation.userOp.verificationGasLimit

string

required

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

Example:

"3076170"

chainOperation.userOp.preVerificationGas

string

required

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

Example:

"0"

chainOperation.userOp.maxFeePerGas

string

required

Maximum fee (in wei) per gas unit.

Example:

"0"

chainOperation.userOp.maxPriorityFeePerGas

string

required

Priority fee (tip) per gas unit.

Example:

"0"

chainOperation.userOp.paymaster

string

required

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

Example:

"0xa784e6482bd5edbfe5991b18cbd545ebd46e1cc4"

chainOperation.userOp.paymasterVerificationGasLimit

string

required

Gas limit for the paymaster verification step.

Example:

"19219"

chainOperation.userOp.paymasterPostOpGasLimit

string

required

Additional gas limit for the paymaster post-operation.

Example:

"0"

chainOperation.userOp.paymasterData

string

required

Additional data used by the paymaster, if any.

Example:

"0x"

chainOperation.userOp.signature

string

required

Signature for the entire user operation.

Example:

"0x8cbd9df26744e2a02cde9fb8832d2b5f..."

chainOperation.userOp.factory

string

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

Example:

"0xd703aae79538628d27099b8c4f621be4ccd142d5"

chainOperation.userOp.factoryData

string

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

Example:

"0xc5265d5d000000000000000000000000..."

chainOperation.typedDataToSign

object

required

Typed data to sign (EIP-712).

Show child attributes

chainOperation.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"
}

chainOperation.typedDataToSign.types

object

required

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

Example:

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

chainOperation.typedDataToSign.primaryType

string

required

Primary type string from the types object.

Example:

"Approve"

chainOperation.typedDataToSign.message

object

required

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

Example:

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

chainOperation.assetType

string

required

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

Example:

"eip155:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"

chainOperation.amount

string

required

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

Example:

"8000000"

chainOperation.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

chainOperation.delegation.contractAddress

string

required

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

Example:

"0xd6CEDDe84be40893d153Be9d467CD6aD37875b28"

chainOperation.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

chainOperation.delegation.signature

object

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

Show child attributes

chainOperation.delegation.signature.chainId

integer

required

Chain ID where delegation occurs

Required range: x >= 1

Example:

10

chainOperation.delegation.signature.contractAddress

string

required

Contract address being delegated to (must match delegation contractAddress)

Example:

"0xd6CEDDe84be40893d153Be9d467CD6aD37875b28"

chainOperation.delegation.signature.nonce

integer

required

Delegation nonce (must match delegation nonce)

Required range: x >= 0

Example:

0

chainOperation.delegation.signature.r

string

required

ECDSA signature r value

Example:

"0x129b258b9d85f91dab87e488dea08e2803e88a96bb6a967d16fe158a09d95d0d"

chainOperation.delegation.signature.s

string

required

ECDSA signature s value

Example:

"0x52adbaca42ea5b316df5ac0a6ae5f544f5eb450d94c76164e27252101e22d3c3"

chainOperation.delegation.signature.v

string

required

ECDSA signature v value (recovery ID)

Example:

"0x1b"

chainOperation.delegation.signature.yParity

enum<integer>

required

Y parity of the signature point (0 or 1)

Available options:

0,

1

Example:

0

chainOperation.delegation.signature.type

enum<string>

required

Signature type identifier indicating the signature has been completed

Available options:

Signed

Example:

"Signed"

tamperProofSignature

string

required

Tamper-proof signature for the entire call request

Example:

"0x0e1f9f56bb4072894a24ebc6fe6e41e15f8b9c8ce7bc1d9d88e9a46b85353d55238f0e7a75fbeb71249292e2206887adc894849488d8d8c23a5a17542d5ab2511b"

callType

enum<string>

Type of operation indicating the routing strategy for multi-account operations

Available options:

same_chain_exclude_solver,

cross_chain_with_solver,

same_chain_with_solver,

cross_chain_with_solver_and_swaps

Example:

"cross_chain_with_solver"

sourceAssetBalances

object[]

Available balances across all accounts that could be used for this operation

Show child attributes

sourceAssetBalances.assetType

string

required

CAIP-19/CAIP-20 asset type identifier

Example:

"eip155:42161/erc20:0xaf88d065e77c8cc2239327c5edb3a432268e5831"

sourceAssetBalances.balance

string

required

Available balance in the smallest unit (wei for ETH, token decimals for ERC20)

Example:

"20476622"

sourceAssetBalances.decimals

integer

required

Number of decimal places for the asset

Required range: 0 <= x <= 18

Example:

6

sourceAssetBalances.fiatValue

number

required

Current fiat value of the balance in USD

Required range: x >= 0

Example:

20.52074709722842

Example:

[
  {
    "assetType": "eip155:42161/erc20:0xaf88d065e77c8cc2239327c5edb3a432268e5831",
    "balance": "20476622",
    "decimals": 6,
    "fiatValue": 20.52074709722842
  }
]

delegation

object

EIP-7702 delegation object that needs to be signed before execution. Only present when using EIP-7702 accounts that require delegation.

Show child attributes

delegation.contractAddress

string

required

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

Example:

"0xd6CEDDe84be40893d153Be9d467CD6aD37875b28"

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

delegation.signature

object

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

Show child attributes

delegation.signature.chainId

integer

required

Chain ID where delegation occurs

Required range: x >= 1

Example:

10

delegation.signature.contractAddress

string

required

Contract address being delegated to (must match delegation contractAddress)

Example:

"0xd6CEDDe84be40893d153Be9d467CD6aD37875b28"

delegation.signature.nonce

integer

required

Delegation nonce (must match delegation nonce)

Required range: x >= 0

Example:

0

delegation.signature.r

string

required

ECDSA signature r value

Example:

"0x129b258b9d85f91dab87e488dea08e2803e88a96bb6a967d16fe158a09d95d0d"

delegation.signature.s

string

required

ECDSA signature s value

Example:

"0x52adbaca42ea5b316df5ac0a6ae5f544f5eb450d94c76164e27252101e22d3c3"

delegation.signature.v

string

required

ECDSA signature v value (recovery ID)

Example:

"0x1b"

delegation.signature.yParity

enum<integer>

required

Y parity of the signature point (0 or 1)

Available options:

0,

1

Example:

0

delegation.signature.type

enum<string>

required

Signature type identifier indicating the signature has been completed

Available options:

Signed

Example:

"Signed"

API Reference

EVM Operations

Multi-Chain Operations

Platform Data

Authorizations

Body

Response