zerion

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Zerion

Unified API + CLI for crypto wallets across 14 EVM chains and Solana. The

zerion

binary ships from npm; this skill is the entry point for install, authentication, and routing to specific capability skills.

面向14条EVM链和Solana的统一加密钱包API + CLI工具。

zerion

二进制包可通过npm获取；此技能是安装、认证以及路由到特定功能技能的入口。

Setup

安装设置

Skills shell out to the

zerion

binary. Don't pre-install — try the command first. If a

zerion

invocation fails with

command not found

, install once:

bash

npm install -g zerion-cli

Requires Node.js ≥ 20. The npm package is

zerion-cli

; the installed binary is

zerion

技能会调用

zerion

二进制程序。无需预先安装——先尝试执行命令。如果

zerion

调用返回

command not found

错误，执行以下命令安装一次：

bash

npm install -g zerion-cli

要求Node.js版本≥20。npm包名为

zerion-cli

，安装后的二进制程序名为

zerion

。

Authentication

认证方式

Three modes. Pick one for analytics; trading always uses an API key.

三种模式。分析功能可任选其一；交易功能始终需要API密钥。

A) API key (recommended)

A) API密钥（推荐）

bash

export ZERION_API_KEY="zk_dev_..."

Get yours at dashboard.zerion.io. Dev keys begin with

zk_dev_

. Limits: 120 req/min, 5K req/day.

bash

export ZERION_API_KEY="zk_dev_..."

可前往dashboard.zerion.io获取密钥。开发密钥以

zk_dev_

开头。限制：每分钟120次请求，每天5000次请求。

B) x402 pay-per-call (no signup, analytics only)

B) x402按次付费（无需注册，仅支持分析功能）

Pays $0.01 USDC per request via the x402 protocol. EVM (Base) or Solana.

bash

export WALLET_PRIVATE_KEY="0x..."     # EVM (Base) — 0x-prefixed hex
export WALLET_PRIVATE_KEY="5C1y..."   # Solana — base58 keypair
zerion portfolio <address> --x402

通过x402协议每次请求支付0.01 USDC。支持EVM（Base链）或Solana链。

bash

export WALLET_PRIVATE_KEY="0x..."     # EVM（Base链）——以0x开头的十六进制字符串
export WALLET_PRIVATE_KEY="5C1y..."   # Solana——base58格式密钥对
zerion portfolio <address> --x402

Or enable globally

或全局启用

export ZERION_X402=true


Both chains at once:
```bash
export EVM_PRIVATE_KEY="0x..."
export SOLANA_PRIVATE_KEY="5C1y..."
export ZERION_X402_PREFER_SOLANA=true   # optional

export ZERION_X402=true


同时启用两条链：
```bash
export EVM_PRIVATE_KEY="0x..."
export SOLANA_PRIVATE_KEY="5C1y..."
export ZERION_X402_PREFER_SOLANA=true   # 可选

C) MPP pay-per-call (analytics only, EVM Tempo)

C) MPP按次付费（仅支持分析功能，EVM Tempo链）

Pays $0.01 USDC per request via MPP on Tempo.

bash

export TEMPO_PRIVATE_KEY="0x..."      # or reuse WALLET_PRIVATE_KEY
zerion portfolio <address> --mpp

通过Tempo链上的MPP每次请求支付0.01 USDC。

bash

export TEMPO_PRIVATE_KEY="0x..."      # 或复用WALLET_PRIVATE_KEY
zerion portfolio <address> --mpp

Or enable globally

或全局启用

export ZERION_MPP=true


> Trading commands (`swap`, `bridge`, `send`) always use the API key + an agent token, regardless of `ZERION_X402` / `ZERION_MPP`.

export ZERION_MPP=true


> 交易命令（`swap`、`bridge`、`send`）始终使用API密钥 + Agent代币，不受`ZERION_X402` / `ZERION_MPP`设置影响。

Which skill for which task

任务对应技能

Intent	Skill
What's in this wallet? portfolio, positions, history, PnL, watchlist	`zerion-analyze`
Swap / bridge / send tokens	`zerion-trading`
Sign a message or EIP-712 typed data (no broadcast)	`zerion-sign`
Create / import / list / backup / delete wallets	`zerion-wallet`
Set up agent tokens + policies for autonomous trading	`zerion-agent-management`

需求	技能
查看钱包资产？投资组合、持仓、历史记录、盈亏、关注列表	`zerion-analyze`
代币兑换/跨链桥接/转账	`zerion-trading`
签署消息或EIP-712类型数据（不广播）	`zerion-sign`
创建/导入/列出/备份/删除钱包	`zerion-wallet`
设置Agent代币 + 自主交易策略	`zerion-agent-management`

Output contract

输出约定

All commands emit JSON to stdout (default — agent-friendly). Errors emit structured JSON to stderr:

json

{ "error": { "code": "missing_api_key", "message": "..." } }

Flags:

--json

(default),

--pretty

(auto-enabled for TTY),

--quiet

所有命令默认向标准输出（stdout）输出JSON格式内容（适合Agent处理）。错误信息以结构化JSON格式输出到标准错误（stderr）：

json

{ "error": { "code": "missing_api_key", "message": "..." } }

可选参数：

--json

（默认）、

--pretty

（终端环境自动启用）、

--quiet

。

Supported chains

支持的链

ethereum

base

arbitrum

optimism

polygon

binance-smart-chain

avalanche

gnosis

scroll

linea

zksync-era

zora

blast

solana

Solana supports same-chain swaps and bidirectional bridging to/from EVM chains. Cross-format bridges (Solana ↔ EVM) require an explicit destination via

--to-wallet <name>

--to-address <addr>

matching the target chain's format.

Command shapes:

Same-chain swap:

zerion swap <chain> <amount> <from-token> <to-token>

Cross-chain bridge:

zerion bridge <from-chain> <from-token> <amount> <to-chain> <to-token>

See

zerion-trading

for the full flag reference.

Use

zerion chains

for the live catalog with metadata.

ethereum

base

arbitrum

optimism

polygon

binance-smart-chain

avalanche

gnosis

scroll

linea

zksync-era

zora

blast

solana

Solana支持同链兑换，以及与EVM链之间的双向跨链桥接。跨格式桥接（Solana ↔ EVM）需要通过

--to-wallet <name>

或

--to-address <addr>

明确指定目标链格式匹配的接收方。

命令格式：

同链兑换：

zerion swap <chain> <amount> <from-token> <to-token>

跨链桥接：

zerion bridge <from-chain> <from-token> <amount> <to-chain> <to-token>

完整参数说明请查看

zerion-trading

技能。

执行

zerion chains

命令可查看包含元数据的实时链列表。

Common error codes

常见错误码

Code	Cause	Fix
`missing_api_key`	No `ZERION_API_KEY` set	Set env var or use `--x402` for analytics
`no_agent_token`	No agent token for trading/signing	See `zerion-agent-management` skill
`no_wallet`	No wallet specified, no default	`--wallet <name>` or set `defaultWallet` config
`wallet_not_found`	Wallet not in local vault	`zerion wallet list` to check
`unsupported_chain`	Invalid `--chain` value	`zerion chains` for valid IDs
`api_error` 401	Invalid API key	Check key at dashboard.zerion.io
`api_error` 429	Rate limited	Wait, lower frequency, or switch to x402

错误码	原因	解决方法
`missing_api_key`	未设置 `ZERION_API_KEY`	设置环境变量，或使用 `--x402` 模式进行分析
`no_agent_token`	交易/签名无Agent代币	查看 `zerion-agent-management` 技能
`no_wallet`	未指定钱包，且无默认钱包	使用 `--wallet <name>` 参数，或在配置中设置 `defaultWallet`
`wallet_not_found`	钱包不在本地密钥库中	执行 `zerion wallet list` 查看已有钱包
`unsupported_chain`	`--chain` 参数值无效	执行 `zerion chains` 查看有效链ID
`api_error` 401	API密钥无效	在dashboard.zerion.io检查密钥
`api_error` 429	请求频率超限	等待一段时间、降低请求频率，或切换到x402模式

Key management

密钥管理

Wallets are encrypted with AES-256-GCM via the Open Wallet Standard (OWS) vault at

~/.ows/

. Private keys never leave the device; signing happens locally. The Zerion API never sees keys.

~/.zerion/config.json

(mode 0o600) stores agent tokens, default wallet, default chain, and slippage.

钱包通过Open Wallet Standard (OWS)密钥库（路径

~/.ows/

）使用AES-256-GCM加密。私钥永远不会离开设备；签名操作在本地完成。Zerion API不会接触到密钥。

~/.zerion/config.json

（权限0o600）存储Agent代币、默认钱包、默认链和滑点设置。

Resources

资源

API docs: developers.zerion.io
Dashboard: dashboard.zerion.io
x402 protocol: x402.org
CLI source: github.com/zeriontech/zerion-cli

API文档：developers.zerion.io
控制台：dashboard.zerion.io
x402协议：x402.org
CLI源码：github.com/zeriontech/zerion-cli