Research Modes

All 9 research modes — deep, quick, crypto, token-analysis, protocol-research, whale-tracking, narrative, risk-assessment, yield-strategy

Krawl supports 9 research modes. The mode determines which tools are prioritized, how the query is processed, and what the report focuses on.

Modes Overview

Mode	Engine	Best For
`deep`	Recursive tree search	General research, comprehensive analysis
`quick`	Flat agent loop	Fast overviews, simple questions
`crypto`	Recursive tree search	General crypto/DeFi research
`token-analysis`	Recursive tree search	Single token deep dive
`protocol-research`	Recursive tree search	DeFi protocol analysis
`whale-tracking`	Recursive tree search	Smart money and institutional flows
`narrative`	Recursive tree search	Market narratives and sentiment
`risk-assessment`	Recursive tree search	Security and risk analysis
`yield-strategy`	Recursive tree search	Yield farming and APY optimization

`deep`

The default mode. Full recursive breadth×depth tree search with STORM perspectives, learning extraction, gap detection, and multi-pass synthesis.

curl -N -X POST https://api.krawl.sh/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "query": "What is the current state of quantum computing?",
    "mode": "deep",
    "breadth": 4,
    "depth_levels": 3
  }'

`quick`

Uses the flat agent loop instead of recursive tree search. The LLM iteratively picks tools (tool_choice='required') up to MAX_STEPS (40). Faster but less thorough.

curl -N -X POST https://api.krawl.sh/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "query": "What is MCP protocol?",
    "mode": "quick"
  }'

`crypto`

General crypto research mode. Automatically includes crypto tools (cryptoData, cryptoChart, defiRanking, etc.) alongside standard web and X/Twitter search.

curl -N -X POST https://api.krawl.sh/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "query": "What is happening in the Solana ecosystem?",
    "mode": "crypto"
  }'

`token-analysis`

Deep dive on a single token. Prioritizes cryptoData, cryptoChart, tokenRiskAssessment, smartMoneyTracker, and X/Twitter sentiment.

curl -N -X POST https://api.krawl.sh/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "query": "Comprehensive analysis of Ethereum",
    "mode": "token-analysis"
  }'

`protocol-research`

Focused on DeFi protocol analysis. Prioritizes defiRanking, protocolDeepDive, governanceMonitor, and smart contract code review.

curl -N -X POST https://api.krawl.sh/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "query": "Analyze Aave v3 protocol mechanics and governance",
    "mode": "protocol-research"
  }'

`whale-tracking`

Tracks smart money and institutional flows. Prioritizes smartMoneyTracker, onchainAnalytics, and derivativesAnalysis.

curl -N -X POST https://api.krawl.sh/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "query": "Where is smart money flowing in DeFi?",
    "mode": "whale-tracking"
  }'

`narrative`

Analyzes market narratives and social sentiment. Prioritizes narrativeTracker, X/Twitter search, and community sources (Reddit, Hacker News).

curl -N -X POST https://api.krawl.sh/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "query": "What is the AI x Crypto narrative?",
    "mode": "narrative"
  }'

`risk-assessment`

Security and risk analysis. Prioritizes tokenRiskAssessment, audit history, exploit research, and smart contract vulnerability scanning.

curl -N -X POST https://api.krawl.sh/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "query": "Risk assessment of bridging protocols",
    "mode": "risk-assessment"
  }'

`yield-strategy`

Yield farming and APY optimization research. Prioritizes yieldFinder, defiRanking, and protocol analysis tools.

curl -N -X POST https://api.krawl.sh/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "query": "Best stablecoin yield strategies in 2025",
    "mode": "yield-strategy"
  }'

Source Type Filtering

Regardless of mode, you can control which source types are available:

{
  "query": "...",
  "mode": "deep",
  "sources": ["exa", "x", "academic"]
}

Available source types: exa, x, github, crypto, web, academic, media, community

Each source type maps to specific tools. See Architecture for the full tool-to-source mapping.

Research Modes

On this page