/messari-token-research

name: messari-token-research
description: Full token research workflow using Messari x402 API. Fetches asset fundamentals, price history, sentiment signals, and news, then synthesizes a research brief via Messari AI. Total cost ~$1.00–$1.50 USDC per run.
tags: [messari, research, tokens, signals, x402, workflow]

Messari Token Research Workflow

Goal

Given a token slug (e.g. `bitcoin`, `ethereum`, `solana`), run a 5-step research workflow that pulls fundamentals, price action, signals, news, and finishes with an AI-synthesized brief.

**Total cost per run: ~$1.00–$1.50 USDC on Base**

Trigger phrases

• "Research [token]"
• "Give me a brief on [token]"
• "What's the outlook on [token]?"
• "Deep dive on [token]"

---

Step 0 — Preflight: check balance

mp token balance list --wallet main --chain base --json

Ensure at least **$2.00 USDC** on Base before starting. If low:

# Bridge USDC from Ethereum to Base
mp token bridge \
  --wallet main \
  --from-chain ethereum \
  --to-chain base \
  --token usdc \
  --amount 10

---

Step 1 — Asset fundamentals (~$0.05)

Replace `{slug}` with the token identifier (e.g. `bitcoin`, `solana`):

mp x402 request \
  --method GET \
  --url "https://api.messari.io/v2/assets/details?assets={slug}" \
  --wallet main \
  --chain base

Extract: name, symbol, market cap, circulating supply, max supply, category, description, ATH, current price.

---

Step 2 — Price timeseries (~$0.18)

mp x402 request \
  --method GET \
  --url "https://api.messari.io/v1/assets/timeseries/{slug}?granularity=daily&start_date=$(date -d "30 days ago" +%Y-%m-%d 2>/dev/null || date -v-30d +%Y-%m-%d)&end_date=$(date +%Y-%m-%d)" \
  --wallet main \
  --chain base

Extract: 30-day price trend, volatility pattern, notable pumps/dumps.

---

Step 3 — Sentiment signals (~$0.35)

mp x402 request \
  --method GET \
  --url "https://api.messari.io/signal/v1/assets?assetSlug={slug}" \
  --wallet main \
  --chain base

Extract: mindshare score, sentiment direction, social volume trend.

---

Step 4 — Recent news (~$0.55)

mp x402 request \
  --method GET \
  --url "https://api.messari.io/news/v1/news/feed?assets={slug}&limit=10" \
  --wallet main \
  --chain base

Extract: top 5 headlines, publication dates, sentiment of coverage.

---

Step 5 — AI research synthesis (~$0.25)

Feed all data from Steps 1–4 into Messari AI for a structured brief:

mp x402 request \
  --method POST \
  --url "https://api.messari.io/ai/v2/chat/completions" \
  --body '{
    "model": "messari",
    "messages": [
      {
        "role": "system",
        "content": "You are a crypto research analyst. Given asset data, price action, signals, and news, produce a structured research brief with: 1) Summary, 2) Key metrics, 3) Bullish/bearish factors, 4) Risk factors, 5) Outlook."
      },
      {
        "role": "user",
        "content": "Research brief for {slug}. Fundamentals: {step1_output}. Price trend (30d): {step2_summary}. Signals: {step3_output}. News: {step4_headlines}"
      }
    ]
  }' \
  --wallet main \
  --chain base

---

Full workflow script

#!/bin/bash
# messari-research.sh <slug>
# Usage: ./messari-research.sh bitcoin

SLUG="${1:-bitcoin}"
WALLET="main"
CHAIN="base"
BASE="https://api.messari.io"
OUT="$HOME/.config/moonpay/research/messari-${SLUG}-$(date -u +%Y%m%d-%H%M%S)"
mkdir -p "$(dirname "$OUT")"

echo "=== [1/4] Asset Fundamentals ==="
FUNDAMENTALS=$(mp x402 request --method GET \
  --url "${BASE}/v2/assets/details?assets=${SLUG}" \
  --wallet "$WALLET" --chain "$CHAIN")
echo "$FUNDAMENTALS" > "${OUT}-fundamentals.json"

echo "=== [2/4] Price Timeseries (30d) ==="
TIMESERIES=$(mp x402 request --method GET \
  --url "${BASE}/v1/assets/timeseries/${SLUG}?granularity=daily" \
  --wallet "$WALLET" --chain "$CHAIN")
echo "$TIMESERIES" > "${OUT}-timeseries.json"

echo "=== [3/4] Signals ==="
SIGNALS=$(mp x402 request --method GET \
  --url "${BASE}/signal/v1/assets?assetSlug=${SLUG}" \
  --wallet "$WALLET" --chain "$CHAIN")
echo "$SIGNALS" > "${OUT}-signals.json"

echo "=== [4/4] News ==="
NEWS=$(mp x402 request --method GET \
  --url "${BASE}/news/v1/news/feed?assets=${SLUG}&limit=10" \
  --wallet "$WALLET" --chain "$CHAIN")
echo "$NEWS" > "${OUT}-news.json"

echo ""
echo "Research data saved to ${OUT}-*.json"
echo "Total cost: ~\$1.13 USDC"
echo ""
echo "Next: pass this data to Messari AI for synthesis (Step 5)"

---

Output format

Present the final brief to the user as:

## [TOKEN] Research Brief
**Date:** [today]
**Cost:** ~$1.13 USDC

### Summary
[2-3 sentence overview]

### Key Metrics
- Price: $X (ATH: $Y, -Z% from ATH)
- Market Cap: $X (rank #N)
- 30d Performance: +/-X%
- Mindshare Score: X (trend: ↑/↓)

### Bullish Factors
- [factor 1]
- [factor 2]

### Bearish / Risk Factors
- [factor 1]
- [factor 2]

### Outlook
[1-2 sentence assessment]

---

Notes

• Slug format: lowercase, hyphenated — `bitcoin`, `ethereum`, `solana`, `chainlink`
• For very new tokens, Steps 2–3 may return empty — skip gracefully
• AI synthesis (Step 5) can use all saved JSON files if running interactively
• Payments are in USDC on Base — ensure ETH on Base for gas

Related skills

• **messari-x402** — Core endpoint reference
• **messari-alpha-scout** — Find trending tokens before researching them
• **messari-deep-research** — Deeper async report (10–15 min, more comprehensive)
• **moonpay-swap-tokens** — Act on research by swapping tokens
• **moonpay-check-wallet** — Verify USDC balance before running