Moralis Data API

What it does

When your agent uses it

• User asks about wallet data (balances
• Transaction history
• Token data (prices
• Security scores)

Example prompts

• “/moralis-data-api”

Requirements

• A credential in MORALIS_API_KEY
• Compatibility (from SKILL.md): Requires curl for API calls. Requires MORALIS_API_KEY env var for authentication.
• Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Read rules/{EndpointName}.md
2. 2Find "Example Response" section
3. 3Copy the EXACT JSON structure
4. 4Note field names (snake_case), data types, HTTP method, path, wrapper structure

What it can do on your machine

Read from SKILL.md and the folder at commit e5199b5. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash
  • Read
  • Grep
  • Glob

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • curl
  • jq

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • deep-index.moralis.io
  • solana-gateway.moralis.io

  Also links to:

  • admin.moralis.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • MORALIS_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Requires curl for API calls. Requires MORALIS_API_KEY env var for authentication.

  From compatibility in the SKILL.md frontmatter.

Context cost

Moralis Data API loads about 5.9k tokens when it runs, and up to ~20k if it reads all its reference files. Until then it costs about 139 tokens; SKILL.md has 1,669 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~139

When it runs · the whole SKILL.md, loaded when a task matches

~5.9k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~20k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:47

  2. If not set, offer to create the `.env` file with an empty placeholder: `MORALIS_API_KEY=`

• NoteMentions a .env fileSKILL.md:48

  3. Tell the user to open the `.env` file and paste their key there themselves.

• NoteMentions a .env fileSKILL.md:55

  The `.env` file location depends on how skills are installed:

• NoteMentions a .env fileSKILL.md:57

  Create the `.env` file in the project root (same directory the user runs Claude Code from). Make sure `.env` is in `.git

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Bash, Read, Grep, Glob

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 1,669 words, ~5,861 tokens.

name

moralis-data-api

description

Query Web3 blockchain data from Moralis API. Use when user asks about wallet data (balances, tokens, NFTs, transaction history, profitability, net worth), token data (prices, metadata, DEX pairs, analytics, security scores), NFT data (metadata, transfers, traits, rarity, floor prices), DeFi positions, entity/label data for exchanges and funds, or block and transaction data. Supports EVM chains (Ethereum, Polygon, BSC, Arbitrum, Base, Optimism, Avalanche, etc.) and Solana. NOT for real-time streaming - use moralis-streams-api instead.

allowed-tools

Bash, Read, Grep, Glob

compatibility

Requires curl for API calls. Requires MORALIS_API_KEY env var for authentication.

version

1.3.1

license

MIT

metadata.author

MoralisWeb3

metadata.homepage

https://docs.moralis.com

metadata.repository

https://github.com/MoralisWeb3/onchain-skills

curl "https://deep-index.moralis.io/api/v2.2/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balance?chain=0x1" \
  -H "X-API-Key: $MORALIS_API_KEY"

block_number: 12386788; // number - use directly
block_number: "12386788"; // string - parseInt(block_number, 10)

"2021-05-07T11:08:35.000Z"; // → new Date(timestamp).getTime()

balance: "1000000000000000000";
// → (Number(BigInt(balance)) / 1e18).toFixed(6)

// Safe extraction
const data = Array.isArray(response) ? response : response.result || [];

token_address → tokenAddress
from_address_label → fromAddressLabel
block_number → blockNumber
receipt_status: "1" → success, "0" → failed
possible_spam: "true"/"false" → boolean check

# First request
curl "...?limit=100" -H "X-API-Key: $KEY"

# Next page
curl "...?limit=100&cursor=<cursor_from_response>" -H "X-API-Key: $KEY"

ADDRESS="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
CHAIN="0x1"

# Wallet Balance
curl "https://deep-index.moralis.io/api/v2.2/${ADDRESS}/balance?chain=${CHAIN}" \
  -H "X-API-Key: $MORALIS_API_KEY"

# Token Price
curl "https://deep-index.moralis.io/api/v2.2/erc20/0x6B175474E89094C44Da98b954EedeAC495271d0F/price?chain=${CHAIN}" \
  -H "X-API-Key: $MORALIS_API_KEY"

# Wallet Transactions (note result wrapper)
curl "https://deep-index.moralis.io/api/v2.2/${ADDRESS}?chain=${CHAIN}&limit=5" \
  -H "X-API-Key: $MORALIS_API_KEY" | jq '.result'

© LeoYeAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 152 other files (references) in skills/moralis-data-api of LeoYeAI/openclaw-master-skills.

• SKILL.md
• _meta.json
• references/CommonPitfalls.md
• references/DataTransformations.md
• references/DefiProtocols.md
• references/FilteredTokens.md
• references/NftMarketplaces.md
• references/Pagination.md
• references/PerformanceAndLatency.md
• references/ResponsePatterns.md
• references/SupportedApisAndChains.md
• references/SupportedDexs.md
• references/TokenHoldersFaq.md
• references/TokenSearch.md
• references/WalletHistory.md
• rules/ApiResponseCodes.md
• rules/SpamDetection.md
• rules/balance__solana.md
• rules/getAggregatedTokenPairStats__evm.md
• … and 134 more

Open the folder on GitHubat commit e5199b5