Research Templates

Krawl includes 8 research templates — pre-built query patterns with variable substitution. Templates specify the query structure, research mode, and required variables.

List Templates

curl -H "X-API-Key: your-key" https://api.krawl.sh/templates

Execute a Template

curl -N -X POST https://api.krawl.sh/templates/token-due-diligence/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{"variables": {"token": "Ethereum"}}'

Returns an SSE stream (same as /research).

Available Templates

`token-due-diligence`

Comprehensive analysis of a crypto token.

Variables: token (token name or ticker) Mode: deep Tags: crypto, investment

Generated query:

Perform due diligence on {token}. Cover: tokenomics, team background, technology, competitive landscape, on-chain metrics, community sentiment, risk factors, and investment thesis.

curl -N -X POST https://api.krawl.sh/templates/token-due-diligence/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{"variables": {"token": "SOL"}}'

`protocol-comparison`

Compare two DeFi protocols.

Variables: protocol_a, protocol_b Mode: deep Tags: crypto, defi

Generated query:

Compare {protocol_a} vs {protocol_b}. Cover: TVL, revenue, user growth, security track record, governance, ecosystem, developer activity, and competitive moat.

curl -N -X POST https://api.krawl.sh/templates/protocol-comparison/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{"variables": {"protocol_a": "Uniswap", "protocol_b": "Curve"}}'

`market-narrative`

Analyze an emerging market narrative.

Variables: narrative Mode: deep Tags: crypto, market

Generated query:

Research the {narrative} narrative. Cover: key projects, catalysts, timeline, risks, social sentiment on X/Twitter and Reddit, smart money positioning, and potential impact on the broader market.

curl -N -X POST https://api.krawl.sh/templates/market-narrative/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{"variables": {"narrative": "AI x Crypto"}}'

`security-audit-review`

Review security posture of a protocol/project.

Variables: project Mode: deep Tags: crypto, security

Generated query:

Review the security posture of {project}. Cover: audit history, known vulnerabilities, bug bounty program, smart contract architecture, admin key risks, upgrade mechanisms, and incident response history.

`company-research`

Deep dive on a company.

Variables: company Mode: deep Tags: business

Generated query:

Research {company} comprehensively. Cover: founding story, business model, revenue, funding, leadership team, competitive landscape, product roadmap, market position, strengths, weaknesses, and outlook.

curl -N -X POST https://api.krawl.sh/templates/company-research/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{"variables": {"company": "Anthropic"}}'

`technology-landscape`

Map a technology category.

Variables: technology, year (default: "2026") Mode: deep Tags: technology

Generated query:

Map the {technology} landscape in {year}. Cover: key players, open source projects, adoption trends, technical architecture patterns, pros/cons of different approaches, and where the field is heading.

`quick-summary`

Fast overview of any topic.

Variables: topic Mode: quick Tags: general

Generated query:

Give me a comprehensive overview of {topic}. Cover the key facts, recent developments, and what matters most.

curl -N -X POST https://api.krawl.sh/templates/quick-summary/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{"variables": {"topic": "MCP protocol"}}'

`person-profile`

Research a public figure.

Variables: person Mode: deep Tags: people

Generated query:

Research {person}. Cover: background, career history, notable achievements, public positions, social media presence, controversies, and current activities.

Template Structure

Each template has:

Field	Type	Description
`id`	string	Unique identifier
`name`	string	Human-readable name
`description`	string	Short description
`query_template`	string	Template string with `{variable}` placeholders
`mode`	string	Research mode
`variables`	array	Variable definitions with `name`, `label`, `placeholder`, optional `default`
`tags`	string[]	Categorization tags

Variable Substitution

Missing variables use their default value if defined. If no default exists and the variable is not provided, the API returns a 422 error.

{
  "variables": {
    "technology": "ZK proofs"
  }
}

The year variable in technology-landscape has a default of "2026", so it's optional.

Research Templates

On this page