Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bankrbot avatar

Symbiosis

  • 3 installs
  • 1.2k repo stars
  • Updated August 1, 2026
  • bankrbot/openclaw-skills

symbiosis is a Claude Code skill for cross-chain token swaps and bridging across 54+ blockchains via the Symbiosis protocol, executing transactions through the Bankr Submit API.

About

symbiosis is a Claude skill for cross-chain token swaps and bridging across 54+ blockchains via the Symbiosis protocol. It supports any-to-any token swaps with automatic routing between chains like Base, Ethereum, Polygon, Arbitrum, Solana, Bitcoin, TON, and Tron. It ships quote and swap Python scripts that fetch a route, approve tokens if needed, and submit the swap through the Bankr Submit API. A developer uses it to give an agent cross-chain bridging beyond Bankr's native chains.

  • Cross-chain token swaps and bridging across 54+ blockchains via Symbiosis
  • Any-to-any token swaps with automatic routing, including Bitcoin, TON, and Tron
  • Provides quote and swap Python scripts executed through the Bankr Submit API

Symbiosis by the numbers

  • 3 all-time installs (skills.sh)
  • Ranked #390 of 479 Web3 & Blockchain skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
At a glance

symbiosis capabilities & compatibility

Capabilities
quicknode · hydrex
Runs
Runs locally
Pricing
Bring your own API key
From the docs

What symbiosis says it does

Cross-chain token swaps across 54+ blockchains. Swap any token on any chain to any token on any other chain.
SKILL.md
All transactions are submitted through the Bankr Submit API using the user's Bankr wallet.
SKILL.md
npx skills add https://github.com/bankrbot/openclaw-skills --skill symbiosis

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs3
repo stars1.2k
Last updatedAugust 1, 2026
Repositorybankrbot/openclaw-skills

What it does

Bridge or swap any token across 54+ chains with automatic routing via Symbiosis, executed through the Bankr Submit API.

Who is it for?

Agents bridging or swapping tokens across chains beyond Bankr's native five

Skip if: Same-chain swaps already handled by a native DEX skill

When should I use this skill?

The user wants to bridge or swap tokens between chains, reach chains beyond Bankr's native 5, or get a cross-chain quote

By the numbers

  • 54+ blockchains supported
  • 2 scripts (symbiosis-quote.py, symbiosis-swap.py)
  • default slippage 200 basis points (2%)

Files

SKILL.mdMarkdownGitHub ↗

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

ChainIDUSDC AddressUSDC Dec
Base84530x833589fCD6eDb6E08f4c7C32D4f71b54bdA029136
Ethereum10xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB486
Polygon1370x3c499c542cEF5E3811e1192ce70d8cC03d5c33596

Additional Chains via Symbiosis

ChainIDUSDC AddressUSDC Dec
Arbitrum421610xaf88d065e77c8cC2239327C5EDb3A432268e58316
Optimism100x0b2C639c533813f4Aa9D7837CAf62653d097Ff856
BNB Chain560x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d18
Avalanche431140xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E6

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

1. Quote: Script calls Symbiosis API (POST /crosschain/v1/swap) with token details and wallet address 2. Approve: If source token needs approval, script submits an ERC20 approve transaction via POST https://api.bankr.bot/agent/submit 3. Swap: Script submits the swap transaction via POST https://api.bankr.bot/agent/submit 4. 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

Related skills

FAQ

Which chains are supported?

54+ blockchains including Base, Ethereum, Polygon, Arbitrum, Optimism, BNB Chain, Avalanche, Solana, Bitcoin, TON, and Tron.

How are swaps executed?

The swap script gets a Symbiosis quote, approves the token if needed, and submits the swap via the Bankr Submit API using the user's Bankr wallet.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.