Symbiosis

Cross-chain token swaps across 54+ blockchains. Swap any token on any chain to any token on any other chain.

When To Use

Use Symbiosis when the user wants to:

Bridge or swap tokens between different chains (e.g., USDC from Base to Polygon, ETH from Ethereum to Arbitrum)
Access chains beyond Bankr's native 5 (Arbitrum, Optimism, BNB Chain, Avalanche, zkSync, Linea, Scroll, Mantle, Blast, and 40+ more)
Swap to/from Bitcoin, TON, or Tron
Get a cross-chain quote without executing

Quick Start

Get a Quote

How much USDC will I get on Polygon if I bridge 10 USDC from Base?

Run the quote script:

scripts/symbiosis-quote.py 8453 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 6 10 137 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 6

Execute a Swap

Bridge 2 USDC from Base to Polygon using Symbiosis

Run the swap script:

scripts/symbiosis-swap.py 8453 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 6 2 137 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 6

Script Usage

symbiosis-swap.py

Executes a full cross-chain swap: gets quote from Symbiosis API, approves token if needed, submits swap transaction via Bankr Submit API.

scripts/symbiosis-swap.py <src_chain_id> <src_token_address> <src_decimals> <amount> <dst_chain_id> <dst_token_address> <dst_decimals> [slippage]

amount — human-readable (e.g., "2" for 2 USDC, "0.1" for 0.1 ETH)
slippage — optional, in basis points (default: 200 = 2%)
Reads Bankr API key from ~/.bankr/config.json
Automatically gets wallet address from Bankr
Outputs transaction hash and Explorer tracking link

symbiosis-quote.py

Gets a quote without executing. Same arguments, no slippage parameter.

scripts/symbiosis-quote.py <src_chain_id> <src_token_address> <src_decimals> <amount> <dst_chain_id> <dst_token_address> <dst_decimals>

Common Chains and Tokens

Bankr Wallet Chains

Chain	ID	USDC Address	USDC Dec
Base	8453	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913	6
Ethereum	1	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48	6
Polygon	137	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359	6

Additional Chains via Symbiosis

Chain	ID	USDC Address	USDC Dec
Arbitrum	42161	0xaf88d065e77c8cC2239327C5EDb3A432268e5831	6
Optimism	10	0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85	6
BNB Chain	56	0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d	18
Avalanche	43114	0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E	6

Native Tokens

Use 0x0000000000000000000000000000000000000000 as address for native gas tokens (ETH, POL, BNB, AVAX, etc.).

Reference: references/chains-and-tokens.md for the full list.

Examples

EVM to EVM

# 5 USDC: Base -> Arbitrum
scripts/symbiosis-swap.py 8453 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 6 5 42161 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 6

# 0.01 ETH: Ethereum -> Base
scripts/symbiosis-swap.py 1 0x0000000000000000000000000000000000000000 18 0.01 8453 0x0000000000000000000000000000000000000000 18

# 10 USDC: Polygon -> BNB Chain
scripts/symbiosis-swap.py 137 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 6 10 56 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d 18

# 0.5 ETH: Base -> Optimism
scripts/symbiosis-swap.py 8453 0x0000000000000000000000000000000000000000 18 0.5 10 0x0000000000000000000000000000000000000000 18

Cross-ecosystem (Symbiosis-only routes)

# 10 USDC: Base -> Solana
# Note: Solana chain ID in Symbiosis is 5426
# Solana USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (but use Symbiosis synthetic address)
scripts/symbiosis-swap.py 8453 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 6 10 5426 0x0000000000000000000000000000000000000000 9

Prompt Examples

Users might say:

"Bridge 5 USDC from Base to Arbitrum"
"Swap 0.1 ETH from Ethereum to Polygon"
"Move my USDC from Base to Optimism"
"How much will I get if I bridge 100 USDC from Base to Avalanche?"
"Cross-chain swap 50 USDC from Polygon to BNB Chain"
"Bridge ETH from Base to Solana"

For each request: identify source chain + token, destination chain + token, look up chain IDs and token addresses from the tables above, and run the appropriate script.

How It Works

Quote: Script calls Symbiosis API (POST /crosschain/v1/swap) with token details and wallet address
Approve: If source token needs approval, script submits an ERC20 approve transaction via POST https://api.bankr.bot/agent/submit
Swap: Script submits the swap transaction via POST https://api.bankr.bot/agent/submit
Track: Returns an Explorer link for cross-chain status tracking

All transactions are submitted through the Bankr Submit API using the user's Bankr wallet. No additional wallets or keys needed.

Resources

Explorer: https://explorer.symbiosis.finance
Website: https://symbiosis.finance
API Docs: references/api-reference.md
Chains & Tokens: references/chains-and-tokens.md