用途:通过 Trust Wallet Amber 聚合器获取同链与跨链代币兑换的报价和可执行交易数据。基础地址为 https://tws.trustwallet.com,认证方式为 HMAC-SHA256。
主要能力:聚合 10+ DEX 与跨链桥提供商及内置 LiquidMesh 路由引擎。同链 DEX 提供商包括 1inch、KyberSwap、0x、Jupiter、THORChain;跨链桥提供商包括 Stargate Finance、Synapse Protocol、Squid Router、Rango Exchange、SWFT Bridgers。链通过 domain ID 标识,如 ethereum、bsc、polygon、arbitrum、optimism、base、avalanche、solana、bitcoin、tron。EVM 原生代币地址使用 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE,Solana 原生 SOL 使用 So11111111111111111111111111111111111111112。
使用方式:先调用 GET /amber-api/v1/route 获取路由与报价,返回按输出金额排序的一条或多条路由;再对每个步骤调用 POST /amber-api/v1/route/step 获取可执行交易数据。请求字段含 fromAsset、fromAddress、fromDomain、amount(最小单位)、toAsset、toDomain 等,可选字段有 toAddress、slippage(默认 "1")、sortBy("outcome" 或 "fee")、contractCall、preferredProviders、ignoredProviders、thorchain。步骤类型有 STEP_TYPE_SWAP、STEP_TYPE_BRIDGE、STEP_TYPE_WRAP、STEP_TYPE_UNWRAP。执行时若有 revokeApproval 先发送并等待确认,再有 approve 则发送授权并等待确认,最后发送主交易;跨链兑换可能含多步骤,需按顺序执行。
适用场景:需要跨链或同链兑换报价、路由比较与交易构建的场景。
限制:资料未提供费用、价格、速率限制及具体错误处理说明;说明中 slippage 为百分比字符串,slippage(百分比如 "1")未说明具体含义,需谨慎使用。