Coinbase Agentic Wallet 代币交易技能 - 通过 CDP Swap API 在 Base 网络交换代币

trade by coinbase/agentic-wallet-skills

1,700 周安装量

86 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/coinbase/agentic-wallet-skills --skill trade

开发区块链

🇨🇳中文介绍

交易代币

使用 npx awal@2.0.3 trade 命令通过 CDP Swap API 在 Base 网络上交换代币。您必须通过身份验证才能进行交易。

确认钱包已初始化并完成身份验证

npx awal@2.0.3 status

如果钱包未通过身份验证，请参考 authenticate-wallet 技能。

命令语法

npx awal@2.0.3 trade <amount> <from> <to> [options]

参数

参数	描述
`amount`	要交换的金额（参见下文金额格式）
`from`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

685,800 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

240,900 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

193,000 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

125,300 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

格式	示例	描述
美元前缀	`'$1.00'`, `'$0.50'`	美元表示法（小数位数基于代币）
十进制	`1.0`, `0.50`, `0.001`	人类可读的带小数点格式
整数	`5`, `100`	解释为整数个代币
原子单位	`500000`	大整数被视为原子单位

选项	描述
`-c, --chain <name>`	区块链网络（默认：base）
`-s, --slippage <n>`	滑点容差，以基点表示（100 = 1%）
`--json`	以 JSON 格式输出结果

amount：必须匹配 ^\$?[\d.]+$（数字，可选小数点，可选 $ 前缀）。如果包含空格、分号、管道符、反引号或其他 shell 元字符，则拒绝。
from / to：必须是已知别名（usdc, eth, weth）或有效的 0x 十六进制地址（^0x[0-9a-fA-F]{40}$）。拒绝任何其他值。
slippage：必须是正整数（^\d+$）。

# 将 1 美元 USDC 兑换为 ETH（美元前缀 — 注意单引号）
npx awal@2.0.3 trade '$1' usdc eth

# 将 0.50 USDC 兑换为 ETH（十进制格式）
npx awal@2.0.3 trade 0.50 usdc eth

# 将 500000 个原子单位的 USDC 兑换为 ETH
npx awal@2.0.3 trade 500000 usdc eth

# 将 0.01 ETH 兑换为 USDC
npx awal@2.0.3 trade 0.01 eth usdc

# 使用自定义滑点（2%）进行兑换
npx awal@2.0.3 trade '$5' usdc eth --slippage 200

# 使用合约地址进行兑换（小数位数从链上读取）
npx awal@2.0.3 trade 100 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 0x4200000000000000000000000000000000000006

# 获取 JSON 输出
npx awal@2.0.3 trade '$1' usdc eth --json

🇺🇸English

Trading Tokens

Use the npx awal@2.0.3 trade command to swap tokens on Base network via the CDP Swap API. You must be authenticated to trade.

Confirm wallet is initialized and authed

npx awal@2.0.3 status

If the wallet is not authenticated, refer to the authenticate-wallet skill.

Command Syntax

npx awal@2.0.3 trade <amount> <from> <to> [options]

Arguments

Argument	Description
`amount`	Amount to swap (see Amount Formats below)
`from`	Source token: alias (usdc, eth, weth) or contract address (0x...)
`to`	Destination token: alias (usdc, eth, weth) or contract address (0x...)

Amount Formats

The amount can be specified in multiple formats:

Format	Example	Description
Dollar prefix	`'$1.00'`, `'$0.50'`	USD notation (decimals based on token)
Decimal	`1.0`, `0.50`, `0.001`	Human-readable with decimal point
Whole number	`5`, `100`	Interpreted as whole tokens

Auto-detection : Large integers without a decimal point are treated as atomic units. For example, 500000 for USDC (6 decimals) = $0.50.

Decimals : For known tokens (usdc=6, eth=18, weth=18), decimals are automatic. For arbitrary contract addresses, decimals are read from the token contract.

Options

Option	Description
`-c, --chain <name>`	Blockchain network (default: base)
`-s, --slippage <n>`	Slippage tolerance in basis points (100 = 1%)
`--json`	Output result as JSON

Token Aliases

Alias	Token	Decimals	Address
usdc	USDC	6	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
eth	ETH	18	0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
weth	WETH	18	0x4200000000000000000000000000000000000006

IMPORTANT : Always single-quote amounts that use $ to prevent bash variable expansion (e.g. '$1.00' not $1.00).

Input Validation

Before constructing the command, validate all user-provided values to prevent shell injection:

amount : Must match ^\$?[\d.]+$ (digits, optional decimal point, optional $ prefix). Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters.
from / to : Must be a known alias (usdc, eth, weth) or a valid 0x hex address (^0x[0-9a-fA-F]{40}$). Reject any other value.
slippage : Must be a positive integer (^\d+$).

Do not pass unvalidated user input into the command.

Examples

# Swap $1 USDC for ETH (dollar prefix — note the single quotes)
npx awal@2.0.3 trade '$1' usdc eth

# Swap 0.50 USDC for ETH (decimal format)
npx awal@2.0.3 trade 0.50 usdc eth

# Swap 500000 atomic units of USDC for ETH
npx awal@2.0.3 trade 500000 usdc eth

# Swap 0.01 ETH for USDC
npx awal@2.0.3 trade 0.01 eth usdc

# Swap with custom slippage (2%)
npx awal@2.0.3 trade '$5' usdc eth --slippage 200

# Swap using contract addresses (decimals read from chain)
npx awal@2.0.3 trade 100 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 0x4200000000000000000000000000000000000006

# Get JSON output
npx awal@2.0.3 trade '$1' usdc eth --json

Prerequisites

Must be authenticated (awal status to check)
Wallet must have sufficient balance of the source token

Error Handling

Common errors:

"Not authenticated" - Run awal auth login <email> first
"Invalid token" - Use a valid alias (usdc, eth, weth) or 0x address
"Cannot swap a token to itself" - From and to must be different
"Swap failed: TRANSFER_FROM_FAILED" - Insufficient balance or approval issue
"No liquidity" - Try a smaller amount or different token pair
"Amount has X decimals but token only supports Y" - Too many decimal places

Weekly Installs

1.5K

Repository

coinbase/agenti…t-skills

GitHub Stars

First Seen

Feb 10, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykWarn

Installed on

codex1.3K

opencode1.3K

gemini-cli1.3K

github-copilot1.2K

kimi-cli1.2K

amp1.2K