# unknown

> Perform due diligence on crypto assets using the Messari API. Retrieves market data, tokenomics, funding history, upcoming unlocks, recent events, and research reports.

- Author: Charles Peterson
- Repository: clp-agent/messari-diligence
- Version: 20260209135024
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-09
- Source: https://github.com/clp-agent/messari-diligence
- Web: https://mule.run/skillshub/@@clp-agent/messari-diligence~unknown:20260209135024

---

# Messari Diligence Skill

Perform due diligence on crypto assets using the Messari API. Retrieves market data, tokenomics, funding history, upcoming unlocks, recent events, and research reports.

## Triggers

Use when user asks to:
- Research/analyze a crypto asset
- Check tokenomics or vesting schedules
- Find funding history or investors
- Get recent news/events for a token
- Perform due diligence on a cryptocurrency

## Setup

### API Key

1. Get your API key at https://messari.io/account/api
2. Store in workspace credentials:

```bash
mkdir -p ~/.openclaw/credentials
echo "YOUR_API_KEY" > ~/.openclaw/credentials/messari.key
```

Or set environment variable:
```bash
export MESSARI_API_KEY="your_key_here"
```

### Access Tiers

| Tier | Access |
|------|--------|
| Free | MessariAI (10/day) - can query all data types |
| Enterprise | 600/min + direct API access to raw endpoints |

**Note:** The MessariAI endpoint is the recommended approach. It has access to all Messari data (market data, tokenomics, funding, research) through natural language queries.

## Safety: Approval on Failure

**If a query fails or hits the rate limit, STOP and ask for approval before:**
- Retrying the failed query
- Continuing with remaining queries
- Attempting any troubleshooting

This prevents burning through API credits on transient errors. The user must explicitly approve continuation.

The diligence script enforces this interactively. When running queries directly, the agent must follow the same protocol.

## Usage

### Quick Diligence Report

Run the diligence script for a comprehensive report:

```bash
./scripts/diligence.sh <asset_symbol>
# Example: ./scripts/diligence.sh SOL
```

### Manual API Calls

All requests need the API key header:
```bash
-H 'x-messari-api-key: YOUR_API_KEY'
```

#### Get Asset Details
```bash
curl -s "https://api.messari.io/v2/assets?slugs=solana" \
  -H 'x-messari-api-key: YOUR_KEY' | jq
```

#### Get Token Unlocks (Enterprise)
```bash
curl -s "https://api.messari.io/v1/assets/{assetId}/events" \
  -H 'x-messari-api-key: YOUR_KEY' | jq
```

#### Get Funding Rounds (Enterprise)
```bash
curl -s "https://api.messari.io/v1/rounds?projectId={id}" \
  -H 'x-messari-api-key: YOUR_KEY' | jq
```

#### Ask MessariAI
```bash
curl -s "https://api.messari.io/ai/v1/chat/completions" \
  -H 'x-messari-api-key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"messages":[{"role":"user","content":"What are the risks of investing in Solana?"}]}'
```

## Diligence Checklist

When researching a crypto asset, gather:

### 1. Market Overview
- [ ] Current price, market cap, 24h volume
- [ ] All-time high and ROI metrics
- [ ] Circulating vs total supply

### 2. Tokenomics
- [ ] Token distribution (team, investors, community)
- [ ] Vesting schedule and upcoming unlocks
- [ ] Inflation/emission schedule

### 3. Funding & Backers
- [ ] Funding rounds and amounts raised
- [ ] Key investors and VCs
- [ ] Valuation history

### 4. Recent Developments
- [ ] Major protocol events
- [ ] Partnerships and integrations
- [ ] Security incidents

### 5. Social Signals
- [ ] Mindshare trends
- [ ] Sentiment analysis
- [ ] Key influencer activity

### 6. Research
- [ ] Professional analyst reports
- [ ] Protocol comparisons

## Output Format

The skill produces a structured diligence report:

```markdown
# Asset Diligence: [SYMBOL]

## Summary
Brief overview and key takeaways

## Market Data
Price, volume, market cap metrics

## Tokenomics
Supply breakdown, unlock schedule

## Funding History
Rounds, investors, valuations

## Recent Events
Major developments, news

## Risk Factors
Identified concerns

## Research Notes
Analyst insights
```

## References

- [Messari API Reference](./references/messari-api.md)
- [Messari Docs](https://docs.messari.io)