Prepare call quote

curl --request POST \
  --url https://be.onebalance.io/api/quotes/prepare-call-quote \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "account": {
    "accountAddress": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B",
    "adminAddress": "0x8FA09fc75bC2619e594cCb720096627DCaA7c5C4",
    "sessionAddress": "0xBbef1E2dEA96c1c2001Eb48136e513A855F46097"
  },
  "targetChain": "eip155:10",
  "calls": [
    {
      "data": "0x095ea7b3000000000000000000000000Bbef1E2dEA96c1c2001Eb48136e513A855F460970000000000000000000000000000000000000000000000000000000000000001",
      "to": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
      "value": "0x0"
    }
  ],
  "allowanceRequirements": [
    {
      "assetType": "eip155:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
      "amount": "8000000",
      "spender": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B"
    }
  ],
  "tokensRequired": [
    {
      "assetType": "eip155:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
      "amount": "8000000"
    }
  ],
  "overrides": [
    {
      "address": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B",
      "balance": "0x1"
    }
  ]
}
'

{
  "account": {
    "accountAddress": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B",
    "adminAddress": "0x8FA09fc75bC2619e594cCb720096627DCaA7c5C4",
    "sessionAddress": "0xBbef1E2dEA96c1c2001Eb48136e513A855F46097"
  },
  "chainOperation": {
    "userOp": {
      "sender": "0xb8e4b017f4a8870e3eb4eb15c5e180d2a34d877b",
      "nonce": "1120126849530300722547379539971600052481264750391572034956634531672621056",
      "factory": "0xd703aae79538628d27099b8c4f621be4ccd142d5",
      "factoryData": "0x",
      "callData": "0xe9ae5c530100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000b2c639c533813f4aa9d7837caf62653d097ff85000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000004ebcfae0c3e747c95504ca7c79c46f725cb4c752000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000",
      "callGasLimit": "737280",
      "verificationGasLimit": "3076170",
      "preVerificationGas": "0",
      "maxFeePerGas": "0",
      "maxPriorityFeePerGas": "0",
      "paymaster": "0xa784e6482bd5edbfe5991b18cbd545ebd46e1cc4",
      "paymasterVerificationGasLimit": "19219",
      "paymasterPostOpGasLimit": "0",
      "paymasterData": "0x",
      "signature": "0x"
    },
    "typedDataToSign": {
      "domain": {
        "name": "RoleBasedECDSAValidator",
        "version": "1.4.3",
        "chainId": 10,
        "verifyingContract": "0xA24bD06230f3F54e5bf266AE7A41750eE3b789FA"
      },
      "types": {
        "Approve": [
          {
            "name": "callDataAndNonceHash",
            "type": "bytes32"
          }
        ]
      },
      "primaryType": "Approve",
      "message": {
        "callDataAndNonceHash": "0xaab2ddac63e4a7e25b7d339cacdff2f9280025cef27699ffe5f5e9e9625b15eb"
      }
    },
    "assetType": "eip155:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "amount": "8000000"
  },
  "tamperProofSignature": "0x1eeb521fc3ffd61cb3fa44526b3933155ed774d5c599491bd6dca1366bb8eaed4004f311351ed7ca2f9777e8e561556f546a32bc2b45df7fe303c709613ead541b"
}

POST

quotes

prepare-call-quote

curl --request POST \
  --url https://be.onebalance.io/api/quotes/prepare-call-quote \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "account": {
    "accountAddress": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B",
    "adminAddress": "0x8FA09fc75bC2619e594cCb720096627DCaA7c5C4",
    "sessionAddress": "0xBbef1E2dEA96c1c2001Eb48136e513A855F46097"
  },
  "targetChain": "eip155:10",
  "calls": [
    {
      "data": "0x095ea7b3000000000000000000000000Bbef1E2dEA96c1c2001Eb48136e513A855F460970000000000000000000000000000000000000000000000000000000000000001",
      "to": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
      "value": "0x0"
    }
  ],
  "allowanceRequirements": [
    {
      "assetType": "eip155:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
      "amount": "8000000",
      "spender": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B"
    }
  ],
  "tokensRequired": [
    {
      "assetType": "eip155:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
      "amount": "8000000"
    }
  ],
  "overrides": [
    {
      "address": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B",
      "balance": "0x1"
    }
  ]
}
'

{
  "account": {
    "accountAddress": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B",
    "adminAddress": "0x8FA09fc75bC2619e594cCb720096627DCaA7c5C4",
    "sessionAddress": "0xBbef1E2dEA96c1c2001Eb48136e513A855F46097"
  },
  "chainOperation": {
    "userOp": {
      "sender": "0xb8e4b017f4a8870e3eb4eb15c5e180d2a34d877b",
      "nonce": "1120126849530300722547379539971600052481264750391572034956634531672621056",
      "factory": "0xd703aae79538628d27099b8c4f621be4ccd142d5",
      "factoryData": "0x",
      "callData": "0xe9ae5c530100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000b2c639c533813f4aa9d7837caf62653d097ff85000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000004ebcfae0c3e747c95504ca7c79c46f725cb4c752000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000",
      "callGasLimit": "737280",
      "verificationGasLimit": "3076170",
      "preVerificationGas": "0",
      "maxFeePerGas": "0",
      "maxPriorityFeePerGas": "0",
      "paymaster": "0xa784e6482bd5edbfe5991b18cbd545ebd46e1cc4",
      "paymasterVerificationGasLimit": "19219",
      "paymasterPostOpGasLimit": "0",
      "paymasterData": "0x",
      "signature": "0x"
    },
    "typedDataToSign": {
      "domain": {
        "name": "RoleBasedECDSAValidator",
        "version": "1.4.3",
        "chainId": 10,
        "verifyingContract": "0xA24bD06230f3F54e5bf266AE7A41750eE3b789FA"
      },
      "types": {
        "Approve": [
          {
            "name": "callDataAndNonceHash",
            "type": "bytes32"
          }
        ]
      },
      "primaryType": "Approve",
      "message": {
        "callDataAndNonceHash": "0xaab2ddac63e4a7e25b7d339cacdff2f9280025cef27699ffe5f5e9e9625b15eb"
      }
    },
    "assetType": "eip155:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "amount": "8000000"
  },
  "tamperProofSignature": "0x1eeb521fc3ffd61cb3fa44526b3933155ed774d5c599491bd6dca1366bb8eaed4004f311351ed7ca2f9777e8e561556f546a32bc2b45df7fe303c709613ead541b"
}

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 account, calls, and token requirements.

account

Role-based Account · object

required

Account details (smart account / EOA and related addresses).

Role-based Account
Basic Account
EIP-7702 Account

Show child attributes

account.type

enum<string>

required

Account type identifier for role-based accounts

Available options:

role-based

Example:

"role-based"

account.sessionAddress

string

required

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

Example:

"0x1cBFbFd62a276BF6D79d504eA4CA75a7baDcf5b1"

account.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"

account.accountAddress

string

required

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

Example:

"0xa8305CAD3ECEA0E4B4a02CE45E240e8687B4C2E0"

targetChain

string

required

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

Example:

"eip155:10"

calls

object[]

required

Array of calls to be executed.

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:

[
  {
    "data": "0xa9059cbb0000000000000000000000004ebcfae0c3e747c95504ca7c79c46f725cb4c752000000000000000000000000000000000000000000000000000000000000000100000000",
    "to": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "value": "0"
  }
]

allowanceRequirements

object[]

required

Array of approvals required for the call. Approvals need to be explicitly defined. Any approval pased as call would result into 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:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "amount": "8000000",
    "spender": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B"
  }
]

tokensRequired

object[]

required

Array of tokens needed for these calls.

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:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "amount": "8000000"
  }
]

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": "0xb8e4b017f4a8870E3eB4eb15c5e180D2a34D877B",
    "balance": "0x1"
  }
]

validAfter

string

Permit valid after value in block timestamp.

Example:

"1686239400"

validUntil

string

Permit valid until value in block timestamp.

Example:

"1686339400"

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

Response from prepare-call-quote containing all necessary data to execute contract calls on the target chain

account

Role-based Account · object

required

Account configuration for the operation

Role-based Account
Basic Account
EIP-7702 Account

Show child attributes

account.type

enum<string>

required

Account type identifier for role-based accounts

Available options:

role-based

Example:

"role-based"

account.sessionAddress

string

required

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

Example:

"0x1cBFbFd62a276BF6D79d504eA4CA75a7baDcf5b1"

account.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"

account.accountAddress

string

required

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

Example:

"0xa8305CAD3ECEA0E4B4a02CE45E240e8687B4C2E0"

chainOperation

object

required

Operation (including userOp and typed data) to be executed on-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

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 for source assets 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:10/erc20:0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "balance": "8000000",
    "decimals": 6,
    "fiatValue": 8
  }
]

Execute quote Get call quote

⌘I

API Reference

EVM Operations

Multi-Chain Operations

Platform Data

Authorizations

Body

Response