Learn Moralis

Behavior

If the user invokes /learn-moralis with no question (or just says "learn moralis"), respond with a friendly platform overview. Walk them through:

1. What Moralis is (enterprise Web3 data platform)
2. The two skills available and when to use each:
   • @moralis-data-api (136 endpoints) — query wallet balances, tokens, NFTs, DeFi positions, prices, transactions, analytics. Use for "what is the current/historical state?"
   • @moralis-streams-api (20 endpoints, EVM only) — real-time EVM event monitoring via webhooks. Use for "notify me when something happens"
3. Supported chains: 40+ EVM chains for both skills, Solana for Data API only
4. How to get started: set MORALIS_API_KEY in .env, then use the skill that fits their need

Keep it conversational and concise — think "onboarding tour", not "dump the docs". End by asking what they'd like to build so you can point them to the right skill.

If the user invokes /learn-moralis with a specific question, answer that question directly using the knowledge below, then route them to the appropriate technical skill.

What is Moralis?

Moralis is an enterprise-grade Web3 data infrastructure platform providing:

• Data APIs - Query wallet balances, tokens, NFTs, DeFi positions, prices, transactions
• Streams - Real-time EVM event monitoring via webhooks (EVM chains only, no Solana)
• Datashare - Export historical data to Snowflake, BigQuery, S3
• Data Indexer - Custom enterprise indexing pipelines
• RPC Nodes - Direct blockchain node access

Key Stats: Powers 100M+ end users, 2B+ monthly API requests, 50+ supported chains.

Routing to Technical Skills

After answering a general question, route users to the appropriate skill:

Rule of thumb:

• Data API = "What is the current/historical state?"
• Streams = "Notify me when something happens"

Quick Capability Reference

Can Moralis Do This?

What Moralis Cannot Do

• Execute transactions (read-only APIs)
• Provide private node access (use RPC Nodes product separately)
• Index custom smart contracts (use Data Indexer product)
• Store user data (you handle storage)
• Provide testnet price data (only mainnet prices)

Supported Chains

Full API Support

Also Supported

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

Solana

Mainnet and Devnet supported via @moralis-data-api only. Streams does not support Solana. Use __solana suffix endpoints.

Coming Soon

Blast, zkSync, Mantle, opBNB, Polygon zkEVM, Zetachain

Pricing Overview

Compute Units (CUs): Each API call costs CUs based on complexity. Simple queries ~1-5 CUs, complex queries ~10-50 CUs.

Overages: Starter $11.25/M, Pro $5/M, Business $4/M

Free tier includes: All APIs (Wallet, Token, NFT, Price, DeFi, Blockchain, Streams)

Getting Started

1. Sign up: https://admin.moralis.com/register
2. Get API key: Dashboard → API Keys
3. Set up .env: Add MORALIS_API_KEY=your_key to your .env file (the skill will help you create it)
4. Use skill: Ask what you want to build — the skill will check for your key and guide you

Common Use Cases

Wallet/Portfolio Tracker

Need: Display user's tokens, NFTs, balances, and transaction history.

Solution: @moralis-data-api endpoints:

• getWalletTokenBalancesPrice - Token balances with prices
• getWalletNFTs - NFT holdings
• getWalletHistory - Decoded transaction history
• getWalletNetWorth - Total portfolio value

Crypto Tax/Compliance

Need: Export transaction history with cost basis.

Solution: @moralis-data-api endpoints:

• getWalletHistory - All transactions decoded
• getWalletProfitability - Realized gains/losses

NFT Marketplace

Need: Display NFT metadata, traits, prices, and ownership.

Solution: @moralis-data-api endpoints:

• getNFTMetadata - Full metadata + traits
• getNFTFloorPriceByContract - Floor price
• getNFTOwners - Current holders
• getNFTTrades - Sale history

DeFi Dashboard

Need: Show user's DeFi positions across protocols.

Solution: @moralis-data-api endpoints:

• getDefiPositionsSummary - All positions
• getDefiPositionsByProtocol - Protocol-specific data

Trading Bot / Alerts

Need: React to on-chain events in real-time.

Solution: @moralis-streams-api:

• Create stream with topic0 for target events
• Receive webhook when event occurs
• Process and act on data

Token Analytics Platform

Need: Token prices, holders, trading volume, security scores.

Solution: @moralis-data-api endpoints:

• getTokenPrice - Current price
• getTokenAnalytics - Volume, liquidity
• getTokenHolders - Holder distribution
• getTokenScore - Security analysis

Data API vs Streams: When to Use

Performance Expectations

Most Data API endpoints respond quickly. However, response times can vary based on:

• Query complexity: Simple lookups (balance, price) are fastest. Decoded endpoints (wallet history, DeFi positions) do more processing.
• Wallet size: Wallets with large transaction histories take longer. Use pagination with smaller limits for whale/power-user wallets.
• Chain: Response times vary across chains. Some chains are inherently slower than others.

Recommended Timeouts

For production applications, set client-side timeouts to 30s to handle edge cases. Most requests return much faster, but large wallets or slower chains can occasionally take longer.

For detailed optimization guidance, see @moralis-data-api → references/PerformanceAndLatency.md.

Reference Documentation

For detailed information:

• references/FAQ.md - Common questions and answers
• references/ProductComparison.md - Detailed feature comparison
• references/UseCaseGuide.md - Implementation patterns by use case

Support Resources

• Docs: https://docs.moralis.com
• Discord: Community support
• Forum: https://forum.moralis.io
• Stack Overflow: Tag moralis

Next Steps

After answering a question, always suggest the next action:

1. If user needs to query data: "Use @moralis-data-api — make sure your MORALIS_API_KEY is set in your .env file, then I can help you fetch the data."

2. If user needs real-time events: "Use @moralis-streams-api — make sure your MORALIS_API_KEY is set in your .env file and have your webhook URL ready, then I can help set up the stream."

3. If user is exploring: Suggest specific endpoints based on their use case.