Zapper API
Query DeFi portfolios, NFTs, and transactions across 50+ chains using Zapper's GraphQL API.
Setup
- 1. Get API key from Zapper Dashboard (free tier available)
- Configure in
~/.config/zapper/addresses.json:
CODEBLOCK0
Or set environment variable: INLINECODE1
Commands
| Command | Description | Example |
|---|
| INLINECODE2 | Token + DeFi totals | INLINECODE3 |
| INLINECODE4 |
Detailed token holdings |
zapper.py tokens 0x123... |
|
apps <address> | DeFi positions (LPs, lending, staking) |
zapper.py apps 0x123... |
|
nfts <address> | NFT holdings by value |
zapper.py nfts 0x123... |
|
tx <address> | Recent transactions (30 days) |
zapper.py tx 0x123... |
|
price <symbol> | Token price lookup |
zapper.py price ETH |
|
claimables <address> | Unclaimed rewards |
zapper.py claimables 0x123... |
|
config | Show configuration |
zapper.py config |
Options
| Flag | Commands | Description |
|---|
| INLINECODE18 | portfolio, tokens | Show 24h price changes |
| INLINECODE19 |
portfolio | Output only total value |
|
--per-wallet | portfolio | Show each configured wallet separately |
|
--json | all | Output raw JSON |
|
--limit N | most | Max items to display |
Usage
CODEBLOCK1
Wallet Labels
Use configured wallet labels instead of addresses:
CODEBLOCK2
Supported Tokens (price command)
ETH, WETH, USDC, USDT, DAI, WBTC, LINK, UNI, AAVE, MKR
Supported Chains
Ethereum, Base, Arbitrum, Optimism, Polygon, Solana, BNB Chain, Avalanche, zkSync, Linea, Scroll, Blast, and 40+ more.
Notes
- - Free tier API key available at zapper.xyz/developers
- Rate limits apply - avoid rapid repeated requests
- NFT valuations based on floor prices
- Transaction history limited to 30 days
References
Zapper API
使用 Zapper 的 GraphQL API 查询 50 多条链上的 DeFi 投资组合、NFT 和交易。
设置
- 1. 从 Zapper Dashboard 获取 API 密钥（提供免费套餐）
- 在 ~/.config/zapper/addresses.json 中配置：
json
{
apiKey: your-api-key,
wallets: [
{label: Main, address: 0x...},
{label: DeFi, address: 0x...}
]
}
或者设置环境变量：export ZAPPERAPIKEY=your-api-key
命令
| 命令 | 描述 | 示例 |
|---|
| portfolio <address> | 代币 + DeFi 总计 | zapper.py portfolio 0x123... |
| tokens <address> |
详细代币持仓 | zapper.py tokens 0x123... |
| apps
| DeFi 仓位（流动性池、借贷、质押） | zapper.py apps 0x123... |
| nfts | 按价值排序的 NFT 持仓 | zapper.py nfts 0x123... |
| tx | 近期交易（30 天） | zapper.py tx 0x123... |
| price | 代币价格查询 | zapper.py price ETH |
| claimables | 未领取奖励 | zapper.py claimables 0x123... |
| config | 显示配置 | zapper.py config |
选项
| 标志 | 适用命令 | 描述 |
|---|
| --24h | portfolio, tokens | 显示 24 小时价格变化 |
| --short |
portfolio | 仅输出总价值 |
| --per-wallet | portfolio | 分别显示每个已配置钱包 |
| --json | 所有命令 | 输出原始 JSON |
| --limit N | 大多数命令 | 最大显示条目数 |
用法
bash
投资组合摘要
python3 scripts/zapper.py portfolio 0xADDRESS
带 24 小时价格变化
python3 scripts/zapper.py portfolio 0xADDRESS --24h
仅总价值
python3 scripts/zapper.py portfolio 0xADDRESS --short
按钱包细分
python3 scripts/zapper.py portfolio --per-wallet
代币持仓及价格
python3 scripts/zapper.py tokens 0xADDRESS --24h
DeFi 仓位
python3 scripts/zapper.py apps 0xADDRESS
NFT 持仓
python3 scripts/zapper.py nfts 0xADDRESS
近期交易
python3 scripts/zapper.py tx 0xADDRESS
代币价格
python3 scripts/zapper.py price ETH
未领取奖励
python3 scripts/zapper.py claimables 0xADDRESS
JSON 输出
python3 scripts/zapper.py portfolio 0xADDRESS --json
钱包标签
使用已配置的钱包标签代替地址：
bash
python3 scripts/zapper.py portfolio Main
python3 scripts/zapper.py tokens DeFi
支持代币（price 命令）
ETH, WETH, USDC, USDT, DAI, WBTC, LINK, UNI, AAVE, MKR
支持链
Ethereum, Base, Arbitrum, Optimism, Polygon, Solana, BNB Chain, Avalanche, zkSync, Linea, Scroll, Blast 以及 40 多条其他链。
注意事项
参考
