@cryptodevops/n8n-nodes-moralis/README.md

n8n node for Moralis Web3 API

# n8n-nodes-moralis

Custom n8n node for Moralis Web3 API integration. This node allows you to interact with Moralis's comprehensive Web3 API to access blockchain data, NFTs, DeFi positions, and more.

## Features

- **Wallet Operations**: Get native balance, token balances, NFTs, transaction history, and portfolio
- **Token Operations**: Get token metadata, prices, and transfer history
- **NFT Operations**: Get NFT metadata, owners, transfers, and collection statistics
- **Transaction Operations**: Get transaction details and decode transactions
- **Block Operations**: Get block data and convert dates to block numbers
- **DeFi Operations**: Get DeFi positions and pair reserves
- **Multi-Chain Support**: Ethereum, Polygon, BSC, Avalanche, Arbitrum, Base, Optimism
- **Comprehensive API Coverage**: 19 different operations across all major Web3 data types

## Installation

```bash
npm install n8n-nodes-moralis
```

## Configuration

1. Get your Moralis API Key from your [Moralis dashboard](https://admin.moralis.io/web3apis)
2. In n8n, create new credentials for "Moralis API"
3. Enter your API Key

## Supported Operations

### Wallet Operations
- **Get Native Balance**: Get native token balance for a wallet
- **Get Token Balances**: Get ERC20 token balances for a wallet
- **Get NFTs**: Get NFTs owned by a wallet
- **Get Transaction History**: Get transaction history for a wallet
- **Get Wallet Portfolio**: Get wallet portfolio with token prices

### Token Operations
- **Get Token Metadata**: Get metadata for ERC20 tokens
- **Get Token Price**: Get current price for a token
- **Get Token Transfers**: Get transfer history for a token

### NFT Operations
- **Get NFT Metadata**: Get metadata for a specific NFT
- **Get NFT Owners**: Get owners of an NFT collection
- **Get NFT Transfers**: Get transfer history for NFTs
- **Get Collection Stats**: Get statistics for an NFT collection

### Transaction Operations
- **Get Transaction**: Get details of a specific transaction
- **Decode Transaction**: Get decoded transaction details

### Block Operations
- **Get Block**: Get block data by block number
- **Get Latest Block**: Get the latest block
- **Date to Block**: Convert a date to block number

### DeFi Operations
- **Get DeFi Positions**: Get DeFi positions for a wallet
- **Get Pair Reserves**: Get reserves for a liquidity pair

## Supported Chains

- Ethereum (eth)
- Polygon (polygon)
- Binance Smart Chain (bsc)
- Avalanche (avalanche)
- Arbitrum (arbitrum)
- Base (base)
- Optimism (optimism)

## Examples

### Get Wallet Token Balances
```json
{
  "resource": "wallet",
  "operation": "getTokenBalances",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain": "eth",
  "additionalFields": {
    "limit": 10
  }
}
```

### Get NFT Metadata
```json
{
  "resource": "nft",
  "operation": "getNFTMetadata",
  "nftAddress": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
  "tokenId": "1",
  "chain": "eth"
}
```

### Get Token Price
```json
{
  "resource": "token",
  "operation": "getTokenPrice",
  "tokenAddress": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "chain": "eth"
}
```

## API Documentation

For more information about the Moralis API, visit the [official documentation](https://docs.moralis.io/).

## Testing

All 19 routes have been thoroughly tested and are fully functional:
- ✅ 19/19 routes working (100% success rate)
- ✅ All supported chains tested
- ✅ Error handling implemented
- ✅ Rate limiting respected

## License

MIT

## Support

For issues and questions, please visit our [GitHub repository](https://github.com/your-username/n8n-nodes-moralis).