symbiosis

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Symbiosis

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

支持54条以上区块链的跨链代币兑换，可将任意链上的任意代币兑换为其他任意链上的任意代币。

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

当用户有以下需求时可使用Symbiosis：

在不同链之间桥接或兑换代币（例如将USDC从Base转到Polygon，将ETH从Ethereum转到Arbitrum）
使用Bankr原生支持的5条链之外的其他链（包括Arbitrum、Optimism、BNB Chain、Avalanche、zkSync、Linea、Scroll、Mantle、Blast等40余条链）
兑换转入/转出Bitcoin、TON或Tron链资产
仅获取跨链报价无需执行交易

Quick Start

快速开始

Get a Quote

获取报价

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

Run the quote script:

bash

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

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

运行报价脚本：

bash

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:

bash

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

Bridge 2 USDC from Base to Polygon using Symbiosis

运行兑换脚本：

bash

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 API获取报价，如有需要先进行代币授权，通过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
```
— 人类可读的金额（例如2 USDC填"2"，0.1 ETH填"0.1"）
```
slippage
```
— 可选参数，单位为基点（默认值200 = 2%）
从
```
~/.bankr/config.json
```
读取Bankr API密钥
自动从Bankr获取钱包地址
输出交易哈希和浏览器追踪链接

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>

仅获取报价不执行交易，参数与兑换脚本一致，无需滑点参数。

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

Bankr钱包支持的链

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

链	ID	USDC地址	USDC精度
Base	8453	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913	6
Ethereum	1	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48	6
Polygon	137	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359	6

Additional Chains via Symbiosis

Symbiosis额外支持的链

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

链	ID	USDC地址	USDC精度
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.

原生Gas代币（ETH、POL、BNB、AVAX等）的地址请使用

0x0000000000000000000000000000000000000000

。

参考：完整列表请查看references/chains-and-tokens.md。

Examples

示例

EVM to EVM

bash

undefined

bash

undefined

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

undefined

scripts/symbiosis-swap.py 8453 0x0000000000000000000000000000000000000000 18 0.5 10 0x0000000000000000000000000000000000000000 18

undefined

Cross-ecosystem (Symbiosis-only routes)

跨生态（仅Symbiosis支持的路线）

bash

undefined

bash

undefined

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

undefined

scripts/symbiosis-swap.py 8453 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 6 10 5426 0x0000000000000000000000000000000000000000 9

undefined

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.

用户可能会提出以下需求：

"将5 USDC从Base桥接到Arbitrum"
"将0.1 ETH从Ethereum兑换到Polygon"
"把我的USDC从Base转到Optimism"
"如果我把100 USDC从Base桥接到Avalanche能得到多少？"
"跨链兑换50 USDC，从Polygon转到BNB Chain"
"将ETH从Base桥接到Solana"

处理每个请求时：识别源链+代币、目标链+代币，从上表中查询链ID和代币地址，然后运行对应的脚本即可。

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.

报价：脚本携带代币详情和钱包地址调用Symbiosis API（
```
POST /crosschain/v1/swap
```
）
授权：如果源代币需要授权，脚本通过
```
POST https://api.bankr.bot/agent/submit
```
提交ERC20授权交易
兑换：脚本通过
```
POST https://api.bankr.bot/agent/submit
```
提交兑换交易
追踪：返回浏览器链接用于追踪跨链交易状态

所有交易都通过Bankr Submit API使用用户的Bankr钱包提交，无需额外的钱包或密钥。

Resources

资源

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

浏览器：https://explorer.symbiosis.finance
官网：https://symbiosis.finance
API文档：references/api-reference.md
链与代币列表：references/chains-and-tokens.md