> ## Documentation Index
> Fetch the complete documentation index at: https://docs.biconomy.io/llms.txt
> Use this file to discover all available pages before exploring further.
# About
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?
Replace manual bridge & swap provider integrations or writing/auditing contracts with a single API call.
Your users sign only once to execute any number of function calls across any number of chains.
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:
**Custom Smart Contract Calls**
Execute specific contract calls with function signatures and arguments. Supports runtime balance injection for dynamic amounts. Perfect for most custom logic needs.
```typescript theme={null}
type: '/instructions/build'
```
**Pre-encoded Contract Calls**
Execute contract calls using pre-encoded calldata. Ideal when you already have encoded data or need exact control over calldata format. Does not support runtime balance injection.
```typescript theme={null}
type: '/instructions/build-raw'
```
**Complex DeFi Intents**
Handle complex multi-input/output DeFi actions like depositing USDC from Optimism to a Morpho pool on Base, or other sophisticated yield strategies.
```typescript theme={null}
type: '/instructions/intent'
```
**Simple Intents**
Perfect for straightforward operations like swapping WETH on Base to USDC on Arbitrum, or other single-purpose DeFi actions.
```typescript theme={null}
type: '/instructions/intent-simple'
```
## 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.
```typescript theme={null}
// 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
**Processed Transactions**
Total transactions processed through our infrastructure
**Total Users**
Total lifetime infra users
**Volume Processed**
Total transaction volume handled
**Smart Accounts**
Smart accounts created
## Features
Chain together swaps, bridges, lending, staking, and more into one user action.
No matter how many actions or chains your workflow spans, your user always signs once.
Abstract gas; your users can pay for execution in thousands of ERC-20 tokens.
**Supports 16+ chains**
Battle-tested infrastructure and audited integrations.
Works with embedded wallets, external wallets (e.g., MetaMask), or custody.
We handle gas sponsorship and settlement so your users don't need native tokens.
Use our prebuilt actions or compose your own multi-step flows.