用途:从 Moralis API 查询 Web3 链上数据,适用钱包、代币、NFT、DeFi、价格、区块链与发现等场景。实现前应先阅读对应端点的 rules/{EndpointName}.md,按其中示例响应复制字段结构,注意 snake_case 字段名、数据类型、HTTP 方法与路径。
主要能力:提供 136 个端点(102 个 EVM + 34 个 Solana),按类别分为钱包、代币、NFT、DeFi、实体、价格、区块链、发现与其他工具。例如 getNativeBalance、getWalletTokenBalancesPrice、getWalletNetWorth、getWalletProfitability、getTokenPrice、getNFTMetadata、getDefiPositionsSummary、getLatestBlockNumber、getTrendingTokens、searchTokens、resolveENSDomain 等。
使用方式:EVM 基地址为 https://deep-index.moralis.io/api/v2.2,Solana 为 https://solana-gateway.moralis.io。所有请求需带 X-API-Key: $MORALIS_API_KEY。验证可用 curl "https://deep-index.moralis.io/api/v2.2/YOUR_EVM_ADDRESS/balance?chain=0x1" -H "X-API-Key: $MORALIS_API_KEY"。不要要求用户在聊天中粘贴密钥;先检查 MORALIS_API_KEY 环境变量,未设置时提供 .env 占位符 MORALIS_API_KEY=,并确保 .env 加入 .gitignore;无密钥则无法代为测试。可在 admin.moralis.com/register 免费注册。
关键数据规则:block_number 为十进制(parseInt(x,10)),timestamp 为 ISO 字符串,balance 为字符串(用 BigInt 计算),decimals 为字符串或数字。响应可能是直接数组、{result:[]} 或分页 {page,cursor,result},提取前判断结构。分页使用 limit 与 cursor。
限制:资料未提供具体价格、配额、速率限制与 SLA。部分端点路径不一致,需按规则文件核对;复杂查询(钱包历史、DeFi 持仓)建议 30 秒超时,简单查询 10 秒。大量交易的钱包应使用合理 limit 分页。缺失事实暂未提供。