symbiosis
Cross-chain token swaps across 54+ blockchains via Symbiosis protocol
Install / Use
npx skills add BankrBot/skills --skill symbiosisInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of symbiosis
symbiosis scores 86/100 on our quality scale, 1820th of 2,790 Automation skills we index.
Its SKILL.md is 5.6 KB long, well organised into 25 sections with 8 code examples: a solid amount of guidance for an agent.
With 1,201 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so symbiosis is actively maintained.
- Our last check on 2026-11-03 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
symbiosis compared with similar skills
All 4 of these similar skills score higher than symbiosis; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| symbiosis (this skill)by BankrBot | 86 | 1.2k | 54d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install symbiosis?
- Run
npx skills add BankrBot/skills --skill symbiosis. The install tabs above show the steps for each supported agent. - Which AI agents does symbiosis work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is symbiosis safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is symbiosis still maintained?
- The repository was last updated about 2 months ago, so symbiosis is actively maintained.
Skill content
View source on GitHubname: symbiosis description: Cross-chain token swaps across 54+ blockchains via Symbiosis protocol. Use when the user wants to swap or bridge tokens between any chains — Base, Ethereum, Polygon, Arbitrum, Optimism, BNB Chain, Avalanche, Solana, Bitcoin, TON, Tron, and 40+ more. Supports any-to-any token swaps with automatic routing. Uses Bankr Submit API to execute transactions. metadata: { "clawdbot": { "emoji": "🔀", "homepage": "https://symbiosis.finance", "requires": { "bins": ["python3", "bankr"] }, }, }
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
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
