mcpField

learn-moralis

github.com/moralisweb3データ・データベース80 回インストール
リポジトリ

learn-moralis について

Moralis Web3 データプラットフォームの利用者向けに、Data API と Streams API の用途、対応チェーン、設定方法を案内し、適切な技術スキルへ誘導します。

主な機能

  1. 01Moralis のデータ製品を紹介
  2. 02Data API と Streams API の使い分け
  3. 03対応ブロックチェーンの説明
  4. 04MORALIS_API_KEY の設定案内
  5. 05技術スキルへの振り分け

活用シーン

  1. 01ウォレットや NFT のデータ取得方法を選ぶ
  2. 02オンチェーンイベント通知の方法を決める
  3. 03対応するブロックチェーンを確認する
  4. 04Moralis 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. 利用できる 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
EVM のオンチェーンイベント用 Webhook@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 サポート
チェーンチェーン 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カスタムカスタムお問い合わせ

コンピュートユニット（CU）： 各 API 呼び出しの CU 消費量は、複雑さに応じて異なります。単純なクエリは約 1～5 CU、複雑なクエリは約 10～50 CU です。

超過料金： Starter $11.25/M、Pro $5/M、Business $4/M

無料プランに含まれるもの： すべての API（Wallet、Token、NFT、Price、DeFi、Blockchain、Streams）

はじめに

  1. 登録： https://admin.moralis.com/register
  2. API キーを取得： Dashboard → API Keys
  3. .env を設定： .env ファイルに MORALIS_API_KEY=your_key を追加します（スキルが作成をサポートします）
  4. スキルを使用： 作りたいものを尋ねてください。スキルが API キーの有無を確認し、使い方を案内します

よくあるユースケース

ウォレット／ポートフォリオトラッカー

必要なこと： ユーザーのトークン、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 対応