Skip to main content
skill CX Codex

emblem-token-swap — Claude Code skill: token swaps and setup

The emblem-token-swap skill swaps tokens on six blockchains and bridges assets across networks. It previews the route and waits for approval before moving funds.

MIT 8,600 installs ★ 13 updated 2026-05-15

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add EmblemCompany/Agent-skills --skill emblem-token-swap -a claude-code
Open on GitHub

What emblem-token-swap does

emblem-token-swap handles swaps on Solana, Ethereum, Base, BSC, Polygon, and Hedera. EVM transactions use automatic DEX aggregation, while cross-chain transfers go through ChangeNow. Bitcoin balances can be checked, but BTC swaps use ChangeNow rather than on-chain swap tools.

The skill combines quote, execution, balance, and token-search tools. On Solana, splBuyIntent serves both quoting and execution and accepts dollar values, SOL amounts, or token quantities. An interactive walkthrough is available through scripts/swap-helper.sh.

You need Node.js >= 18.0.0, the @emblemvault/agentwallet CLI, and internet access before running it. Without those requirements, the skill will not start. Safe mode shows the amount, route, and estimated output, then asks for explicit confirmation before execution.

What it helps with

  • swap SOL for USDC on Solana
  • get a quote for Ethereum or Base tokens
  • bridge assets between chains with ChangeNow
  • check balances before sending a swap

Example prompts for the agent

  • Use splBuyIntent to swap 5 SOL for USDC on Solana.
  • Get a quote for 0.01 ETH to USDC on Ethereum with ethSwapQuote, then execute it with ethSwap.
  • Use getChangeNowSwapQuote to price bridging 0.05 ETH from Ethereum to SOL on Solana.

How to install emblem-token-swap

1Skills CLI (Vercel)

npx skills add EmblemCompany/Agent-skills --skill emblem-token-swap -a claude-code

2Manually: put the files in place

~/.claude/skills/emblem-token-swap/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/emblem-token-swap/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about emblem-token-swap

How do I install emblem-token-swap in Claude Code?

Run npx skills add EmblemCompany/Agent-skills --skill emblem-token-swap -a claude-code, then check ~/.claude/skills/emblem-token-swap/SKILL.md.

What does emblem-token-swap do?

It quotes and executes token swaps on Solana, Ethereum, Base, BSC, Polygon, and Hedera. It also bridges assets across networks through ChangeNow.

What does the skill require?

You need Node.js >= 18.0.0, the @emblemvault/agentwallet CLI, and internet access. Every value-moving operation requires user confirmation.

Source text

SKILL.md · MIT
---
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

```bash
npm install -g @emblemvault/agentwallet

# Solana swap (uses splBuyIntent)
emblemai --agent --profile default -m "Use splBuyIntent to swap 5 SOL for USDC on Solana"

# Cross-chain bridge (uses ChangeNow)
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.
```bash
emblemai --agent --profile default -m "Use solanaBalances to show my Solana token balances"
```

### Step 2: Get a Quote
Preview the swap before executing.
```bash
emblemai --agent --profile default -m "Use splBuyIntent to get a quote for swapping 5 SOL to USDC"
```

### Step 3: Execute the Swap
```bash
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.
```bash
emblemai --agent --profile default -m "Use solanaBalances to show my updated balances"
```

---

## Swap Patterns

### Solana Swaps
```bash
# By token amount
emblemai --agent --profile default -m "Use splBuyIntent to swap 0.5 SOL for USDC"

# By dollar amount
emblemai --agent --profile default -m "Use splBuyIntent to swap $20 of SOL for JUP"

# By token name
emblemai --agent --profile default -m "Use splBuyIntent to swap 100 USDC for BONK"
```

### EVM Swaps
```bash
# Ethereum
emblemai --agent --profile default -m "Use ethSwapQuote to get a quote for swapping 0.01 ETH to USDC, then use ethSwap to execute"

# Base
emblemai --agent --profile default -m "Use baseSwapQuote to quote 0.005 ETH to USDC on Base"

# BSC
emblemai --agent --profile default -m "Use bscSwapQuote to quote 0.1 BNB to USDT on BSC"

# Polygon
emblemai --agent --profile default -m "Use polygonSwapQuote to quote 10 POL to USDC on Polygon"
```

### Hedera Swaps
```bash
emblemai --agent --profile default -m "Use hederaTokensSwapQuote to get a quote for 100 HBAR to USDC, then use hederaTokensSwap to execute"
```

### Cross-Chain Bridge
```bash
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:**
1. **Tool name** — specify the exact tool for reliable routing
2. **Amount** — dollar value or token quantity
3. **Source token** — what you're swapping from
4. **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:
1. Show you the swap details (amount, route, estimated output)
2. Wait for your approval before executing
3. Report the transaction result

Never bypasses confirmation for any value-moving operation.

---

## Helper Script

```bash
bash scripts/swap-helper.sh
```

See [scripts/swap-helper.sh](scripts/swap-helper.sh) for an interactive swap walkthrough.

---

## Links

- [Agent Wallet CLI](https://www.npmjs.com/package/@emblemvault/agentwallet)
- [EmblemVault Docs — canonical](https://emblemvault.ai/docs)
- [EmblemVault Docs — interactive](https://emblemvault.dev)

© EmblemAI · MIT · EmblemCompany/Agent-skills

Similar skills

All skills for Finance and business →

From the same set9

emblem-market-research emblem-market-research pulls crypto market data into your agent: trending tokens, derivatives, smart money flows. Handy when you need a token breakdown or whale positioning. CX Codex +1 8,900installs emblem-portfolio-tracker emblem-portfolio-tracker tracks crypto balances across seven blockchains via EmblemAI, shows trade P&L, and inspects DeFi positions via Nansen. Useful for checking multi-chain assets without leaving your terminal. CX Codex +1 8,900installs emblem-ai-react emblem-ai-react — a React skill that wires authentication across wallets, email, and social login plus EmblemAI hooks. Triggered when you need EmblemAuthProvider, connect buttons, or chat components. CX Codex +1 8,800installs emblem-ai-prompt-examples emblem-ai-prompt-examples is a Claude Code skill with curated prompt patterns for EmblemAI workflows across DeFi and prediction markets, using quote-only requests and approval gating. CX Codex +1 8,800installs emblem-ai-agent-wallet emblem-ai-agent-wallet — a skill that connects your agent to EmblemVault for wallet operations on Solana, Ethereum, Base, BSC, Polygon, Hedera, and Bitcoin. CX Codex +1 8,800installs emblem-memecoin-scout emblem-memecoin-scout discovers memecoins across Solana, Base, and Hedera through EmblemAI. Flags rug-pull risks via Rugcheck and tracks smart money wallet trades. CX Codex +1 8,700installs emblem-defi-yield emblem-defi-yield — a skill for researching DeFi yields, checking positions through Nansen, and entering liquid staking via swaps on Solana, Ethereum, Base, BSC, Polygon and Hedera. CX Codex +1 8,700installs emblem-ai emblem-ai adds wallet, email or social sign-in to your app and gives every user a wallet-enabled account, plus drop-in chat components and live app debugging. CX Codex +1 8,700installs

Project sponsors

Companies that keep this analytics open