moralis-openapi-skill

Moralis Web3 Data API Skill

Use this skill to run Moralis EVM data operations through uxc + OpenAPI.

Reuse the uxc skill for shared execution, auth, and error-handling guidance.

Prerequisites

• uxc is installed and available in PATH.
• Network access to https://deep-index.moralis.io/api/v2.2.
• Access to the curated OpenAPI schema URL:
  • https://raw.githubusercontent.com/holon-run/uxc/main/skills/moralis-openapi-skill/references/moralis-evm.openapi.json
• A Moralis API key.

Scope

This skill covers a read-first wallet intelligence surface:

• native balance lookup
• wallet token balances
• wallet history
• wallet swaps
• wallet net worth
• ERC-20 metadata lookup
• ERC-20 token price lookup

This skill does not cover:

• write or transaction submission flows
• Solana, Streams, or NFT-specific surfaces
• the full Moralis API

Authentication

Moralis uses X-API-Key header auth.

Configure one API-key credential and bind it to deep-index.moralis.io/api/v2.2:

uxc auth credential set moralis \
  --auth-type api_key \
  --api-key-header X-API-Key \
  --secret-env MORALIS_API_KEY

uxc auth binding add \
  --id moralis \
  --host deep-index.moralis.io \
  --path-prefix /api/v2.2 \
  --scheme https \
  --credential moralis \
  --priority 100

Validate the active mapping when auth looks wrong:

uxc auth binding match https://deep-index.moralis.io/api/v2.2

Core Workflow

1. Use the fixed link command by default:

   • command -v moralis-openapi-cli
   • If missing, create it: uxc link moralis-openapi-cli https://deep-index.moralis.io/api/v2.2 --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/moralis-openapi-skill/references/moralis-evm.openapi.json
   • moralis-openapi-cli -h

2. Inspect operation schema first:

   • moralis-openapi-cli get:/{address}/balance -h
   • moralis-openapi-cli get:/wallets/{address}/tokens -h
   • moralis-openapi-cli get:/erc20/{address}/price -h