Crypto Portfolio & Price Alert Monitor

SKILL.md

# crypto-pfolio-alert

Monitor crypto wallet balances and set price alerts for tokens you hold.

## Usage

```
Monitor wallet [ADDRESS] on [NETWORK] for incoming/outgoing tx
Set alert: notify me when [TOKEN] on [NETWORK] crosses [PRICE] USD
Show my portfolio across [NETWORK1], [NETWORK2]
```

## Supported Networks

- Ethereum (ETH)
- Polygon (MATIC)
- BSC (BNB/BEP20)
- Arbitrum (ARB)
- Optimism (OP)
- Base (BASE)
- Scroll (SCROLL)
- zkSync (ZKSYNC)
- Linea (LINEA)
- Gnosis (GNO)
- Avalanche (AVAX)
- Fantom (FTM)

## Configuration

No API key needed — uses free public endpoints:
- Blockscout APIs (no key required)
- CoinGecko API (free tier)

## Features

- **Balance check**: Query native + ERC20 token balances for any wallet
- **Transaction history**: Last 10 txs with timestamp, amount, direction
- **Price alerts**: Monitor token price vs USD threshold, notify when crossed
- **Multi-chain view**: Aggregate portfolio across multiple networks
- **Alert methods**: Log to console, write to file, or notify via configured channel

## Alerts Storage

Alerts are stored in `~/.openclaw/crypto-alerts.json` and checked periodically.

## Notes

- Rate limit: ~100 calls/day on free tier
- Large portfolios may take a few seconds to fetch
- Some networks have inconsistent RPC — fallback to Blockscout