| name | emblem-token-swap |
| description | Execute token swaps across 6 blockchains via EmblemAI. Automatic route optimization and cross-chain bridging via ChangeNow. Use when the user wants to swap tokens, exchange crypto, convert between currencies, or bridge assets cross-chain.
|
| license | MIT |
| compatibility | Requires Node.js >= 18.0.0, @emblemvault/agentwallet CLI, and internet access. Works on Claude Code, Cursor, Codex, OpenClaw, and other agents following the Agent Skills spec.
|
| metadata | {"author":"EmblemAI","version":"1.1.0","homepage":"https://emblemvault.ai","docs":"https://emblemvault.ai/docs","docs-interactive":"https://emblemvault.dev"} |
Emblem Token Swap
Guided token swapping powered by EmblemAI. Swap tokens on Solana, Ethereum, Base, BSC, Polygon, and Hedera with automatic routing. Cross-chain bridging via ChangeNow.
Requires: npm install -g @emblemvault/agentwallet
What This Skill Can Do
| Chain | Quote Tool | Swap Tool | Balance Tool | Token Search |
|---|
| Solana | splBuyIntent (quote mode) | splBuyIntent (swap mode) | solanaBalances | findSolanaSwapToken |
| Ethereum | ethSwapQuote | ethSwap | ethGetBalances | searchCryptoByName |
| Base | baseSwapQuote | baseSwap | baseGetBalances | searchEvmTokensBirdeye |
| BSC | bscSwapQuote | bscSwap | bscGetBalances | searchEvmTokensBirdeye |
| Polygon | polygonSwapQuote | polygonSwap | polygonGetBalances | searchEvmTokensBirdeye |
| Hedera | hederaTokensSwapQuote | hederaTokensSwap | hederaGetBalances | hederaFindTokens |
| Cross-chain | getChangeNowSwapQuote | swapUsingChangeNow | — | getChangeNowSupportedCurrencies |
Notes
- Solana uses
splBuyIntent for both quotes and execution — it handles token lookup by name/symbol/CA and flexible amounts ($USD, SOL, or token quantity)
- EVM chains (Ethereum, Base, BSC, Polygon) route through automatic DEX aggregation
- Cross-chain bridges via ChangeNow support 500+ currencies
- Bitcoin has balance support (
getBTCBalances) but no on-chain swap tools — use ChangeNow for BTC bridges
Quick Start
npm install -g @emblemvault/agentwallet
emblemai --agent --profile default -m "Use splBuyIntent to swap 5 SOL for USDC on Solana"
emblemai --agent --profile default -m "Use getChangeNowSwapQuote to get a quote for bridging 0.05 ETH from Ethereum to SOL on Solana"
Trigger phrases:
- "Swap SOL to USDC"
- "Exchange ETH for USDT"
- "Convert my tokens"
- "Bridge tokens to Base"
Workflow: Safe Token Swap
Step 1: Check Balance
Confirm you have enough of the source token.
emblemai --agent --profile default -m "Use solanaBalances to show my Solana token balances"
Step 2: Get a Quote
Preview the swap before executing.
emblemai --agent --profile default -m "Use splBuyIntent to get a quote for swapping 5 SOL to USDC"
Step 3: Execute the Swap
emblemai --agent --profile default -m "Use splBuyIntent to swap 5 SOL for USDC on Solana"
Safe mode requires your confirmation before executing.
Step 4: Verify
Confirm the new balance.
emblemai --agent --profile default -m "Use solanaBalances to show my updated balances"
Swap Patterns
Solana Swaps
emblemai --agent --profile default -m "Use splBuyIntent to swap 0.5 SOL for USDC"
emblemai --agent --profile default -m "Use splBuyIntent to swap $20 of SOL for JUP"
emblemai --agent --profile default -m "Use splBuyIntent to swap 100 USDC for BONK"
EVM Swaps
emblemai --agent --profile default -m "Use ethSwapQuote to get a quote for swapping 0.01 ETH to USDC, then use ethSwap to execute"
emblemai --agent --profile default -m "Use baseSwapQuote to quote 0.005 ETH to USDC on Base"
emblemai --agent --profile default -m "Use bscSwapQuote to quote 0.1 BNB to USDT on BSC"
emblemai --agent --profile default -m "Use polygonSwapQuote to quote 10 POL to USDC on Polygon"
Hedera Swaps
emblemai --agent --profile default -m "Use hederaTokensSwapQuote to get a quote for 100 HBAR to USDC, then use hederaTokensSwap to execute"
Cross-Chain Bridge
emblemai --agent --profile default -m "Use getChangeNowSwapQuote to quote bridging 0.1 ETH to SOL"
emblemai --agent --profile default -m "Use getChangeNowSupportedCurrencies to show available bridge currencies"
Communication Rules
Always include these in swap requests:
- Tool name — specify the exact tool for reliable routing
- Amount — dollar value or token quantity
- Source token — what you're swapping from
- Target token — what you're swapping to
| Bad | Good |
|---|
"swap sol usdc" | "Use splBuyIntent to swap 5 SOL for USDC" |
"buy eth" | "Use ethSwap to swap 100 USDC to ETH on Ethereum" |
"bridge" | "Use getChangeNowSwapQuote to bridge 0.05 ETH to SOL" |
Safety
All swaps require explicit user confirmation (safe mode). The agent will:
- Show you the swap details (amount, route, estimated output)
- Wait for your approval before executing
- Report the transaction result
Never bypasses confirmation for any value-moving operation.
Helper Script
bash scripts/swap-helper.sh
See scripts/swap-helper.sh for an interactive swap walkthrough.
Links
