/messari-deep-research

name: messari-deep-research
description: Async deep-research report workflow using Messari AI. Starts a long-form research job, polls until complete, and returns a comprehensive report on any crypto topic, asset, or protocol. Cost varies; typically $0.50–$2.00 USDC.
tags: [messari, research, ai, deep-research, x402, workflow]

Messari Deep Research Workflow

Goal

Generate a comprehensive, long-form research report on any crypto topic, asset, sector, or question. Uses Messari's async AI deep-research engine which crawls their knowledge graph, on-chain data, and news to produce institutional-quality reports.

**Cost per run: ~$0.50–$2.00 USDC on Base (async, takes 5–15 minutes)**

Trigger phrases

• "Write a deep research report on [topic]"
• "Give me a full analysis of [asset/protocol]"
• "Research the [DeFi/L2/RWA/etc.] sector"
• "Deep dive on [topic]"
• "Generate a research report"

---

Step 0 — Preflight: check balance

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

Ensure at least **$3.00 USDC** on Base.

---

Step 1 — Start deep research job

mp x402 request \
  --method POST \
  --url "https://api.messari.io/ai/v1/deep-research" \
  --body '{
    "query": "<your research question or topic>"
  }' \
  --wallet main \
  --chain base

**Example queries:**

• `"What is the investment thesis for Ethereum restaking protocols in 2025?"`
• `"Analyze the competitive landscape of L2 rollups"`
• `"What are the key risks in the RWA tokenization sector?"`
• `"Deep dive on Solana's DeFi ecosystem"`

**Response:** Returns a job `id` (e.g. `dr_abc123`) and status `pending`.

{
  "id": "dr_abc123",
  "status": "pending",
  "created_at": "2025-..."
}

---

Step 2 — Poll for completion (free, repeat until done)

mp x402 request \
  --method GET \
  --url "https://api.messari.io/ai/v1/deep-research/<JOB_ID>" \
  --wallet main \
  --chain base

**Status values:**

• `pending` — job queued, try again in 60s
• `processing` — actively generating, try again in 60s
• `completed` — report ready, extract `result`
• `failed` — job failed, check `error` field

Polling is free (no payment required). Poll every 30–60 seconds.

---

Step 3 — Retrieve completed report

Once status is `completed`, the response contains the full report:

{
  "id": "dr_abc123",
  "status": "completed",
  "result": {
    "title": "...",
    "summary": "...",
    "sections": [...],
    "sources": [...]
  }
}

---

Full workflow script (with auto-polling)

#!/bin/bash
# messari-deep-research.sh "<research query>"
# Usage: ./messari-deep-research.sh "Analyze the Solana DeFi ecosystem"

QUERY="${1:-What are the top crypto narratives for 2025?}"
WALLET="main"
CHAIN="base"
BASE="https://api.messari.io"
OUT="$HOME/.config/moonpay/research/deep-$(date -u +%Y%m%d-%H%M%S)"
mkdir -p "$(dirname "$OUT")"

echo "Starting deep research: \"$QUERY\""
echo ""

# Step 1: Start job
RESPONSE=$(mp x402 request --method POST \
  --url "${BASE}/ai/v1/deep-research" \
  --body "{\"query\": \"${QUERY}\"}" \
  --wallet "$WALLET" --chain "$CHAIN")
echo "$RESPONSE" > "${OUT}-job.json"

JOB_ID=$(echo "$RESPONSE" | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])" 2>/dev/null)

if [ -z "$JOB_ID" ]; then
  echo "ERROR: Could not extract job ID. Response:"
  echo "$RESPONSE"
  exit 1
fi

echo "Job started: $JOB_ID"
echo "Polling for completion (this takes 5–15 minutes)..."

# Step 2: Poll loop
while true; do
  sleep 30
  STATUS_RESPONSE=$(mp x402 request --method GET \
    --url "${BASE}/ai/v1/deep-research/${JOB_ID}" \
    --wallet "$WALLET" --chain "$CHAIN")

  STATUS=$(echo "$STATUS_RESPONSE" | python3 -c "import sys,json; print(json.load(sys.stdin).get('status','unknown'))" 2>/dev/null)
  echo "  Status: $STATUS ($(date +%H:%M:%S))"

  if [ "$STATUS" = "completed" ]; then
    echo "$STATUS_RESPONSE" > "${OUT}-report.json"
    echo ""
    echo "Report complete! Saved to ${OUT}-report.json"
    break
  elif [ "$STATUS" = "failed" ]; then
    echo "ERROR: Research job failed."
    echo "$STATUS_RESPONSE"
    exit 1
  fi
done

---

Cancel a running job

mp x402 request \
  --method POST \
  --url "https://api.messari.io/ai/v1/deep-research/<JOB_ID>/cancel" \
  --wallet main \
  --chain base

---

List past research jobs

mp x402 request \
  --method GET \
  --url "https://api.messari.io/ai/v1/deep-research" \
  --wallet main \
  --chain base

---

Output format

Present the completed report as:

## Deep Research: [Report Title]
**Job ID:** dr_abc123
**Generated:** [timestamp]
**Cost:** ~$X.XX USDC

### Executive Summary
[2-3 paragraph summary]

### [Section 1 Title]
[content]

### [Section 2 Title]
[content]

...

### Sources
- [source 1]
- [source 2]

---

Good research queries

**Asset deep dives:**

• `"Investment thesis for [TOKEN]: fundamentals, competition, risks, and outlook"`
• `"On-chain health of [TOKEN]: activity, retention, revenue"`

**Sector analysis:**

• `"Competitive landscape of Ethereum L2 rollups in 2025"`
• `"State of RWA tokenization: market size, key players, regulatory risks"`
• `"DeFi lending protocols: risk comparison across Aave, Compound, and Morpho"`

**Narrative research:**

• `"What is the AI x crypto narrative and which projects are best positioned?"`
• `"Is the memecoin supercycle over? Evidence and counterarguments"`

**Macro:**

• `"How does the current macro environment affect crypto market structure?"`

---

Notes

• Deep research is async — start the job, then come back; do not busy-wait
• Report quality is significantly higher than single-shot AI chat
• If polling for >20 minutes with `processing` status, the job may be stuck — cancel and retry
• Payments in USDC on Base (`--chain base`)
• Free polling: Step 2 GET requests do not trigger payment

Related skills

• **messari-x402** — Core endpoint reference and quick AI chat (`/ai/v2/chat/completions`)
• **messar