Overview

OneBalance enables applications to monetize their services through transparent and flexible fee structures. This page explains how fees work, who pays them, and how to configure them for your application.

User pays one consolidated fee to the app, Toolkit helps app to handle the underlying gas & paymaster costs.

Fee Types and Responsibilities

CategoryFee TypeWho PaysDescription
Gas FeesSame-Chain ExecutionApplicationThe app pays the bill to the paymaster service in USD for same-chain execution routes
Gas FeesCross-Chain SourceApplicationThe app pays the source chain gas cost to the paymaster service in USD
Gas FeesCross-Chain DestinationUserThis fee is included in the quote the solver provides for execution
MonetizationSwaps & TransfersUserApp configures the fees and collects them to a dedicated address. The fee is paid in the input token and delivered with every user transaction
MonetizationFunction CallsUserApp calculates the fee it is willing to take and encodes this into the desired calldata to be executed as a transfer

Monetization Fees for Swaps and Transfers

Our transactional API lets you monetize every on-chain action initiated by your end users. Each time an end user sends a transaction through your application one transparent service fee is calculated, composed of:

  1. Percentage fee – a fixed percentage of the asset amount
  2. Network fee – a flat USD-denominated amount that offsets per-chain operational costs

Fee Parameters

FieldTypeDescription
percentageBpsuint16Fee in basis points (1 bp = 0.01%)
usdBaseMultiplieruint8Multiplier applied to the operational cost table
beneficiarystringThe EVM address that collects the fees. Once non-EVM chains are supported, additional addresses will be added

Chain-Specific Fee Configuration

The following table shows a config example of base costs for different chains. These values are multiplied by the usdBaseMultiplier to calculate the final network fee.

ChainCAIP-2 IDBase Cost (USD)
Ethereumeip155:1$3.00
Avalancheeip155:43114$0.20
BNB Smart Chaineip155:56$0.10
Lineaeip155:59144$0.5
Baseeip155:8453$0.02
Arbitrumeip155:42161$0.02
Polygon PoSeip155:137$0.02
Blasteip155:81457$0.02
Optimismeip155:10$0.02

How Fees Are Calculated

ComponentFormula
Percent componentpercentFee = (amount × percentageBps) / 10,000
USD componentusdFee = Σ(chainCostUsd[chain] × usdBaseMultiplier)
ConversionUSD fee is converted to the input asset using a live price feed
Total feetotalFee = percentFee + usdFeeAssetEquivalent

Example Calculation

1 ETH to USDC Swap on Arbitrum

Given:

  • percentageBps = 30 (0.3%)
  • usdBaseMultiplier = 2
  • 1 ETH = 2,500 USDC
percentFee = 1 ETH × 0.3% = 0.003 ETH
usdFee     = 0.03 USD × 2 = 0.06 USD0.000024 ETH
------------------------------------------------
totalFee   = 0.003024 ETH

Fee Settlement

  • Fees are transferred to the beneficiary address in the same token used for the transaction
  • For bridge + swap operations, network fees are summed across all chains involved

Managing Fee Configuration

  1. Fee configuration updates are necessary to reflect significant shifts in gas prices or native token values.
  2. To update the configuration app needs to contact OneBalance team.

Coming Soon

  1. Dynamic Fee Adjustment - Fees will automatically adjust to market shifts based on average gas prices and native token prices in real-time
  2. Self-Service Updates - Configuration will be updatable via APIs or through the admin dashboard UI

Custom Fee Structures: Need specialized pricing models or volume discounts? Contact our sales team to discuss custom fee arrangements for your business.