whatisgithub

What is ravnagent?

david-horjet/ravnagent — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · developerComplexity · 4/5Setup · hard

In one sentence

An automated crypto portfolio protection agent that watches wallets across chains and executes trades when risk rules trigger.

Mindmap

mindmap
  root((repo))
    What it does
      Monitors crypto portfolio
      Detects risk signals
      Executes protective trades
    Tech stack
      Node.js
      TypeScript
      Next.js
    Use cases
      Auto-protect a crypto portfolio
      Set drawdown kill switches
      Track alerts on Telegram
    Audience
      Crypto traders
      Developers
    Pipeline
      Signal agent
      Decision agent
      Executor agent
    Policies
      Exposure cap
      Drawdown kill switch
      Chain lock

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically protect a multi-chain crypto portfolio from large drawdowns.

USE CASE 2

Set exposure caps and volatility guards to limit risky trades.

USE CASE 3

Get real-time portfolio alerts pushed to a Telegram bot.

What is it built with?

Node.jsTypeScriptNext.jsExpressSupabase

How does it compare?

david-horjet/ravnagentabhishek-akkal/finovaadan-shahid/ecommerce_website
Stars000
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyhardeasymoderate
Complexity4/51/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires wallet addresses, a Zerion API connection, and Supabase configuration.

So what is it?

Ravn is an automated portfolio protection tool for people holding cryptocurrency across multiple blockchains. You point it at your EVM, meaning Ethereum-compatible, and Solana wallet addresses, set your risk tolerances, and it watches your holdings continuously, executing protective trades on your behalf when your rules are triggered. Every 20 minutes, the default interval, Ravn runs a three-stage pipeline. First, a Signal Agent scans a snapshot of your portfolio and raises alerts when something crosses a threshold: the portfolio has dropped 5% or more from its all-time peak, a single asset now makes up more than 40% of your total value, any position has moved more than 15% in 24 hours, or any position is up 20% or more. Second, a Decision Agent turns those signals into proposed actions, such as a swap, a rebalance, or an alert-only flag for chains where automated trading is not yet supported. Third, an Executor Agent runs each proposal through a Policy Engine, and if every active policy passes, the trade is submitted via the Zerion trading API. The Policy Engine ships with five configurable rules managed from a dashboard: an exposure cap that blocks trades when one asset is too dominant, a drawdown kill switch that halts all trading below a loss threshold, a volatility guard, a chain lock that restricts execution to specific networks, and a spend limit per transaction and per day. If any policy fails, the trade is blocked, since the system is fail closed by design. Activity streams to a web dashboard over WebSocket. Critical alerts are pushed to a Telegram bot. The backend runs on Node.js and TypeScript with Express, using Supabase, which is PostgreSQL, for storage. The frontend is built on Next.js 16.

Copy-paste prompts

Prompt 1
Explain how RavnAgent's Signal, Decision, and Executor agent pipeline works together.
Prompt 2
Help me configure the Policy Engine's exposure cap and drawdown kill switch in RavnAgent.
Prompt 3
Show me how RavnAgent connects to the Zerion trading API to submit trades.

Frequently asked questions

What is ravnagent?

An automated crypto portfolio protection agent that watches wallets across chains and executes trades when risk rules trigger.

What language is ravnagent written in?

Mainly JavaScript. The stack also includes Node.js, TypeScript, Next.js.

How hard is ravnagent to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ravnagent for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.