mcpField

learn-moralis

github.com/moralisweb3数据与数据库80 次安装
代码仓库

关于 learn-moralis

面向 Moralis Web3 数据平台用户的入门与路由技能，介绍 Data API 和 Streams API 的用途、支持链及设置方式，并引导用户选择相应技术技能。

主要功能

  1. 01介绍 Moralis 数据产品
  2. 02区分 Data API 与 Streams API
  3. 03说明支持的区块链网络
  4. 04指导设置 MORALIS_API_KEY
  5. 05按需求引导至技术技能

适用场景

  1. 01选择钱包与 NFT 数据查询方式
  2. 02决定如何获取实时链上事件通知
  3. 03了解平台支持的区块链网络
  4. 04开始配置 Moralis API

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/moralisweb3/onchain-skills --skill learn-moralis

安装后在 Claude Code 中输入/learn-moralis确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
FAQ.md
ProductComparison.md
UseCaseGuide.md

详细介绍

了解 Moralis

行为

如果用户在没有提出问题的情况下调用 /learn-moralis（或只是说“learn moralis”），请友好地概述平台。引导他们了解：

  1. Moralis 是什么（企业级 Web3 数据平台）
  2. 两种可用技能及其适用场景：
    • @moralis-data-api（136 个端点）——查询钱包余额、代币、NFT、DeFi 仓位、价格、交易和分析数据。适用于“当前／历史状态如何？”
    • @moralis-streams-api（20 个端点，仅限 EVM）——通过 Webhook 实时监控 EVM 事件。适用于“发生某事时通知我”
  3. 支持的链：两种技能均支持 40 多条 EVM 链；Data API 还支持 Solana
  4. 如何开始：在 .env 中设置 MORALIS_API_KEY，然后使用符合需求的技能

保持对话式且简洁——像“新手入门介绍”，而不是“倾倒文档”。最后询问他们想构建什么，以便为他们推荐合适的技能。

如果用户在提出具体问题的情况下调用 /learn-moralis，请根据以下知识直接回答问题，然后引导他们使用合适的技术技能。

什么是 Moralis？

Moralis 是企业级 Web3 数据基础设施平台，提供：

  • Data APIs——查询钱包余额、代币、NFT、DeFi 仓位、价格和交易
  • Streams——通过 Webhook 实时监控 EVM 事件（仅限 EVM 链，不支持 Solana）
  • Datashare——将历史数据导出到 Snowflake、BigQuery、S3
  • Data Indexer——定制化企业级索引管道
  • RPC Nodes——直接访问区块链节点

**关键数据：**支持 1 亿多名终端用户、每月 20 亿多次 API 请求、支持 50 多条链。

引导至技术技能

回答一般性问题后，将用户引导至合适的技能：

用户需求引导至
查询钱包数据（余额、代币、NFT、历史记录）@moralis-data-api
获取代币价格、元数据、分析数据@moralis-data-api
查询 NFT 元数据、特征、地板价@moralis-data-api
获取 DeFi 仓位、协议数据@moralis-data-api
查询区块、交易@moralis-data-api
实时监控钱包（EVM）@moralis-streams-api
实时监控合约事件（EVM）@moralis-streams-api
通过 Webhook 获取 EVM 链上事件@moralis-streams-api
实时追踪 EVM 转账@moralis-streams-api

经验法则：

  • Data API = “当前／历史状态如何？”
  • Streams = “发生某事时通知我”

快速功能参考

Moralis 能做到吗？
问题答案技能
获取钱包代币余额？可以，包含 USD 价格@moralis-data-api
获取钱包 NFT？可以，包含元数据@moralis-data-api
获取钱包交易历史？可以，已解码@moralis-data-api
获取代币价格？可以，实时价格及 OHLCV@moralis-data-api
获取 NFT 地板价？可以（ETH、Base、Sei）@moralis-data-api
获取 DeFi 仓位？可以（主要链）@moralis-data-api
实时监控钱包？可以（仅限 EVM）@moralis-streams-api
实时追踪合约事件？可以（仅限 EVM）@moralis-streams-api
获取历史事件？使用 Data API 查询@moralis-data-api
查询 ENS／Unstoppable 域名？可以@moralis-data-api
获取代币安全评分？可以@moralis-data-api
检测狙击者／机器人？可以@moralis-data-api
获取热门代币？可以@moralis-data-api
获取市值排名靠前的代币？可以@moralis-data-api
按名称／代号搜索代币？可以@moralis-data-api
Moralis 无法做到的事情
  • 执行交易（API 仅支持读取）
  • 提供私有节点访问权限（需单独使用 RPC Nodes 产品）
  • 为自定义智能合约编制索引（需使用 Data Indexer 产品）
  • 存储用户数据（由你负责存储）
  • 提供测试网价格数据（仅提供主网价格）

支持的链

完整的 API 支持
链Chain ID备注
Ethereum0x1支持所有 API，包括地板价
Base0x2105支持所有 API，包括地板价
Polygon0x89仅缺少地板价
BSC0x38不支持盈利能力分析和地板价
Arbitrum0xa4b1不支持盈利能力分析和地板价
Optimism0xa不支持盈利能力分析和地板价
Avalanche0xa86a不支持盈利能力分析和地板价
Sei0x531几乎完整（不支持盈利能力分析），包括地板价
Monad0x8f新链，支持良好
也支持

Linea、Fantom、Cronos、Gnosis、Chiliz、Moonbeam、Moonriver、Flow、Ronin、Lisk、Pulse

Solana

仅通过 @moralis-data-api 支持 Mainnet 和 Devnet。Streams 不支持 Solana。请使用带有 __solana 后缀的端点。

即将推出

Blast、zkSync、Mantle、opBNB、Polygon zkEVM、Zetachain

定价概览

套餐每月 CU 数吞吐量价格
Free40K/天1,000 CU/s$0
Starter2M1,000 CU/s$49/月
Pro100M2,000 CU/s$199/月
Business500M5,000 CU/s$490/月
Enterprise自定义自定义联系我们

计算单元（CUs）： 每次 API 调用都会根据复杂度消耗 CUs。简单查询约消耗 1-5 CUs，复杂查询约消耗 10-50 CUs。

超额费用： Starter $11.25/M，Pro $5/M，Business $4/M

免费套餐包含： 所有 API（钱包、代币、NFT、价格、DeFi、区块链、Streams）

开始使用

  1. 注册： https://admin.moralis.com/register
  2. 获取 API 密钥： Dashboard → API Keys
  3. 设置 .env： 将 MORALIS_API_KEY=your_key 添加到 .env 文件中（该技能会帮助你创建）
  4. 使用技能： 说出你想构建的内容 — 该技能会检查你的密钥并为你提供指导

常见使用场景

钱包/投资组合追踪器

需求： 显示用户的代币、NFT、余额和交易历史。

解决方案： @moralis-data-api 端点：

  • getWalletTokenBalancesPrice - 带价格的代币余额
  • getWalletNFTs - NFT 持仓
  • getWalletHistory - 解码后的交易历史
  • getWalletNetWorth - 投资组合总价值
加密货币税务/合规

需求： 导出含成本基础的交易历史。

解决方案： @moralis-data-api 端点：

  • getWalletHistory - 解码所有交易
  • getWalletProfitability - 已实现收益/亏损
NFT 市场

需求： 显示 NFT 元数据、特征、价格和所有权。

解决方案： @moralis-data-api 端点：

  • getNFTMetadata - 完整元数据和特征
  • getNFTFloorPriceByContract - 地板价
  • getNFTOwners - 当前持有者
  • getNFTTrades - 销售历史
DeFi 仪表板

需求： 显示用户在各协议中的 DeFi 持仓。

解决方案： @moralis-data-api 端点：

  • getDefiPositionsSummary - 所有持仓
  • getDefiPositionsByProtocol - 特定协议的数据
交易机器人/提醒

需求： 实时响应链上事件。

解决方案： @moralis-streams-api：

  • 使用目标事件的 topic0 创建流
  • 事件发生时接收 webhook
  • 处理并使用数据采取行动
代币分析平台

需求： 代币价格、持有者、交易量和安全评分。

解决方案： @moralis-data-api 端点：

  • getTokenPrice - 当前价格
  • getTokenAnalytics - 交易量、流动性
  • getTokenHolders - 持有者分布
  • getTokenScore - 安全分析

Data API 与 Streams：何时使用

场景使用
显示当前钱包余额Data API
余额变化时发出提醒Streams
显示交易历史Data API
记录每笔新交易Streams
获取 NFT 元数据Data API
NFT 转移时通知Streams
查询代币价格Data API
实时追踪 DEX 兑换Streams

性能预期

大多数 Data API 端点的响应速度都很快。不过，响应时间可能会因以下因素而异：

  • 查询复杂度：简单查询（余额、价格）最快。已解码的端点（钱包历史记录、DeFi 仓位）需要进行更多处理。
  • 钱包规模：交易历史记录较多的钱包需要更长时间。对于巨鲸或高级用户的钱包，请使用较小的分页限制。
  • 链：不同链的响应时间有所不同。有些链本身就比其他链慢。
建议的超时时间

对于生产应用，请将客户端超时时间设为 30s，以应对特殊情况。大多数请求的返回速度都快得多，但大型钱包或较慢的链偶尔可能需要更长时间。

如需了解详细的优化指南，请参阅 @moralis-data-api → references/PerformanceAndLatency.md。

参考文档

如需了解详细信息：

支持资源

后续步骤

回答问题后，始终建议用户采取下一步操作：

  1. 如果用户需要查询数据：“使用 @moralis-data-api——确保已在 .env 文件中设置 MORALIS_API_KEY，然后我可以帮助你获取数据。”

  2. 如果用户需要实时事件：“使用 @moralis-streams-api——确保已在 .env 文件中设置 MORALIS_API_KEY，并准备好 Webhook URL，然后我可以帮助你设置数据流。”

  3. **如果用户正在探索：**根据其使用场景推荐具体端点。

评论

支持 Markdown