sardis-balance

# Sardis Balance - Read-Only Wallet Analytics

Safe, read-only skill for checking wallet balances, spending summaries, and transaction history. Perfect for monitoring without payment execution risk.

## Capabilities

- **Balance Checking**: Real-time wallet balance across all supported chains
- **Spending Summary**: Daily, weekly, monthly spending analytics
- **Transaction History**: Complete audit trail with filters
- **Budget Tracking**: Remaining daily/weekly/monthly limits
- **Multi-Wallet**: Check balances across multiple agent wallets

## Security Model

**READ-ONLY**: This skill cannot execute payments or modify wallet state. Safe for unrestricted use.

## Quick Setup

```bash
export SARDIS_API_KEY=sk_your_key_here
```

Note: No WALLET_ID required - can query any wallet you have access to.

## API Endpoint Patterns

Base URL: `https://api.sardis.sh/v2`

### Check Wallet Balance

```bash
# Get current balance for a specific wallet
curl -X GET https://api.sardis.sh/v2/wallets/{wallet_id}/balance \
  -H "Authorization: Bearer $SARDIS_API_KEY"

# Example response:
# {
#   "wallet_id": "wallet_abc123",
#   "balances": {
#     "base": {"USDC": "1250.00", "EURC": "500.00"},
#     "polygon": {"USDC": "750.00"}
#   },
#   "total_usd": "2500.00"
# }
```

### Spending Summary

```bash
# Get spending summary for a time period
curl -X GET "https://api.sardis.sh/v2/wallets/{wallet_id}/spending/summary?period=day" \
  -H "Authorization: Bearer $SARDIS_API_KEY"

# Available periods: hour, day, week, month, year
```

### Transaction History

```bash
# List recent transactions with filters
curl -X GET "https://api.sardis.sh/v2/wallets/{wallet_id}/transactions?limit=20&status=completed" \
  -H "Authorization: Bearer $SARDIS_API_KEY"

# Filters:
# - limit: Number of transactions (default 10, max 100)
# - status: completed, pending, failed
# - from_date: ISO 8601 timestamp
# - to_date: ISO 8601 timestamp
# - min_amount: Minimum transaction amount
# - max_amount: Maximum transacti...