Skip to main content
Supertransaction API enables developers to build end-to-end DeFi, stablecoin and yield workflows without writing smart contracts, auditing or manually integrating bridges, swap providers or intent solvers. All workflows are executed gaslessly, with a single user signature - even if they span multiple blockchains.

​
What does it mean for you?

10x Faster Shipping

Replace manual bridge & swap provider integrations or writing/auditing contracts with a single API call.

Impossibly Smooth UX

Your users sign only once to execute any number of function calls across any number of chains.

Gas Abstraction

All flows are gas abstracted by default. Users can either pay in 10k+ ERC-20 tokens or you can sponsor their gas.

​
How does it work?

The Supertransaction API works by composing flows of instructions together via a single API call. You can chain multiple operations across different chains and protocols with just one user signature.
The API supports four types of instructions that can be combined in your flows:
  • build
  • build-raw
  • intent
  • intent-simple
Custom Smart Contract CallsExecute specific contract calls with function signatures and arguments. Supports runtime balance injection for dynamic amounts. Perfect for most custom logic needs.
type: '/instructions/build'

​
Composing Multiple Actions

Based on these four instruction types, developers can use composeFlows to combine one or more instructions into a single workflow. Use composeFlows in your /v1/quote request to chain multiple operations together - combining swaps, bridges, and custom calls into a single workflow with one signature. 
// Example: Swap across chains, then stake in one transaction
const quote = await fetch('https://api.biconomy.io/v1/quote', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    mode: 'smart-account',
    ownerAddress: '0x742d35cc...',
    composeFlows: [
      {
        type: '/instructions/intent-simple',
        data: {
          srcChainId: 8453,
          dstChainId: 10,
          srcToken: '0x833589...',
          dstToken: '0x94b008...',
          amount: '1000000000',
          slippage: 0.01
        }
      },
      {
        type: '/instructions/build',
        data: {
          functionSignature: 'function stake(uint256 amount)',
          args: ['1000000'],
          to: '0x1111111...',
          chainId: 10
        }
      }
    ]
  })
});

​
Execution Engine

The execution engine for all workflows done through the Supertransaction API is the Biconomy Modular Execution Environment (MEE). It’s a multi-chain, trustless network of Relayers (called MEE Nodes) which can execute Supertransactions.
A Supertransaction is a data model which can represent multiple EVM function calls across multiple chains with a single hash. By signing this hash, the user can approve an entire workflow with a single signature.
Biconomy MEE has built in retry mechanisms, high reliability, low latency and high throughput. It’s able to serve all clients — from one-person startups to large enterprises.

​
Industry-Leading Security

The Supertransaction API stack has been audited by four independent auditors:

Cyfrin

Spearbit

Zenith

Pashov

​
Platform Metrics

70M+

Processed TransactionsTotal transactions processed through our infrastructure

10M+

Total UsersTotal lifetime infra users

$3.5B+

Volume ProcessedTotal transaction volume handled

4.5M+

Smart AccountsSmart accounts created

​
Features

Workflow Composer

Chain together swaps, bridges, lending, staking, and more into one user action.

Single-Signature

No matter how many actions or chains your workflow spans, your user always signs once.

Gas Abstraction

Abstract gas; your users can pay for execution in thousands of ERC-20 tokens.

Multi-Chain Support

Supports 16+ chains

Safe by Design

Battle-tested infrastructure and audited integrations.

Drop-in Integration

Works with embedded wallets, external wallets (e.g., MetaMask), or custody.

Never worry about gas again

We handle gas sponsorship and settlement so your users don’t need native tokens.

Add protocols in minutes

Use our prebuilt actions or compose your own multi-step flows.