Guides Dexter

Automate Financial Research with the OpenClaw of Stocks

Set up Dexter as a single-purpose stock research agent for filings, earnings, market data, and recurring watchlist checks.

intermediate 6 steps

Introduction

In this guide, you will learn how to set up Dexter, an open-source financial research agent that works like OpenClaw for stock research. Dexter can read earnings reports, interpret SEC filings, pull up-to-date market data, and help you turn a messy company question into a source-backed research brief.

Step-by-step 6 steps

Instructions

  1. Step 1 of 6

    Set Up a VPS for Dexter

    In the demo, we used Hostinger VPS hosting and picked a basic VPS plan. Once the server is ready, Hostinger gives you an SSH command that looks like this:

    Prompt
    ssh root@[YOUR_SERVER_IP]

    > Pro tip: You can run Dexter locally, but a VPS is cleaner for this kind of agent. It keeps the browser, terminal, and long-running tasks off your main laptop. If setting up a VPS is new for you, start with our Launch Your OpenClaw From Scratch course. It walks through the same basic server setup pattern you will use here.

    Open a new Codex or Claude Code project, open the terminal, and connect to the server with that SSH command. The nice part is that your coding agent can watch the terminal with you and help debug installs, missing packages, or environment variables.

    Hostinger VPS setup
    Hostinger VPS setup

    In the demo, AlmaLinux worked, but Debian would be the safer pick next time.

  2. Step 2 of 6

    Install Dexter From GitHub

    Open the Dexter GitHub repo and follow the install instructions there. The setup is mostly a few terminal commands: install Bun, clone the repo, install dependencies, add environment variables, and start Dexter.

    The general flow looks like this:

    Prompt
    # install Bun if you do not already have it
    curl -fsSL https://bun.sh/install | bash
    
    # clone Dexter and install dependencies
    git clone https://github.com/virattt/dexter.git
    cd dexter
    bun install
    
    # start Dexter
    bun start

    When Dexter starts for the first time, it should walk you through the variables it needs. Treat those variables like passwords. Do not paste them into a public recording, shared doc, or screenshot.

    After setup, the command you will use most often is:

    Prompt
    cd dexter
    bun start

    That reopens the Dexter interface from the folder where it lives on your VPS.

  3. Step 3 of 6

    Add Your Model and Financial Data Keys

    Now give Dexter the two things that make it useful: a model and stock-market data.

    For the model, use whichever API key you already prefer: OpenRouter, OpenAI, or Anthropic. In the demo, OpenRouter was useful because it can route to OpenAI, Anthropic, and other models from one account.

    Inside Dexter, open the model picker with:

    Prompt
    /models

    Choose your provider, then paste or type the model name carefully. In the demo, straight pasting a model name caused issues, so typing it out was the safer move.

    Dexter provider picker
    Dexter provider picker

    Next, add a Financial Datasets API key. This is the key that lets Dexter pull company data, earnings reports, SEC filings, stock prices, and other financial context instead of relying only on web search.

    Financial Datasets API key
    Financial Datasets API key

    Financial Datasets charges per use, and the demo notes that the minimum credit load is about $20 to get started.

    If you want web search, add a Perplexity API key and configure search inside Dexter with:

    Prompt
    /search

    If you want Twitter/X sentiment later, add an xAI API key too.

  4. Step 4 of 6

    Run the First Research Prompt

    Start with a narrow research question. Dexter works better when you give it a concrete company and decision context instead of asking it to "tell me about this stock."

    Use this prompt:

    Prompt
    Create a source-backed research brief on GOOGL.
    
    Focus on:
    - what the company does
    - recent catalysts
    - public financial or operating signals
    - key risks
    - competitive context
    - what I should investigate next
    
    Use an iterative research process.
    Validate important claims before finalizing the brief.
    Save intermediate research so the workflow can continue without losing context.

    You can also ask faster questions while testing the setup:

    Prompt
    What's the stock price of GOOGL?

    or:

    Prompt
    How did GOOGL do on its last earnings? How did that compare to META's last earnings?

    In the demo, Dexter pulled market data, read filing and earnings fields, then returned a quick comparison of revenue, EPS, and growth. That is the workflow you want to verify before trusting bigger research prompts: ask a concrete question, watch which data sources Dexter calls, and make sure the answer cites the right kind of evidence.

  5. Step 5 of 6

    Set Up a Heartbeat Watchlist

    Once a manual run works, use Dexter's heartbeat feature for recurring checks.

    Use a prompt like this:

    Prompt
    Set up a heartbeat to check [TICKER] every [TIME_WINDOW].
    
    When you check it, report:
    - current price movement
    - any major earnings or filing updates
    - relevant market news
    - whether anything needs deeper research

    In the demo, the heartbeat request was a simple six-hour stock price check. Dexter added it to its heartbeat checklist so the agent could keep checking that stock on a schedule.

    This is where Dexter starts to feel different from a normal chatbot. You are not opening a new thread every time you want a quick check. You are giving a single-purpose finance agent one recurring job.

    > Pro tip: Prove the manual workflow before you automate it. If the first GOOGL answer is noisy, fix the model, data, or prompt before you ask Dexter to monitor anything.

  6. Step 6 of 6

    Skip WhatsApp Until the Core Workflow Works

    Dexter also has gateway instructions for WhatsApp-style access, but that part did not work cleanly in the demo. The setup required exiting Dexter with Ctrl+C, returning to the normal terminal, and trying:

    Prompt
    bun gateway login

    The gateway setup had more friction than the core stock research workflow. Treat that as optional for now.

    The stronger first use is simple:

    1. Run Dexter on a VPS. 2. Add the right model and market data keys. 3. Ask source-backed questions. 4. Check the data sources it used. 5. Add /heartbeat only after the answers are useful.

    That keeps Dexter focused on what it is already good at: stock research, market data, filings, earnings context, and recurring watchlist checks.

You're done

That's the whole workflow

Mark it complete to save your progress. Background and answers to common questions follow below.

Keep going

Keep learning with Rundown Pro

A guide shows you one workflow. Pro opens the full course library, so you can learn the whole system behind it.

  • Every on-demand course
  • Certifications on completion
  • Group office hours and member perks

$29/mo, cancel anytime

Overview Back to the steps

Background and context

Who This Is Useful For

  • Investors and analysts who want a faster first pass on earnings, filings, stock prices, and company context.
  • Founders and operators who need company research before sales calls, diligence, partnerships, or competitor reviews.
  • Agent builders who want to see how a narrow, single-purpose agent can be easier to trust than a general-purpose assistant.

What You Will Build

You will set up Dexter as an always-on command-line analyst for the stock market. Once it is running, you can ask plain-English questions about a company, ticker, earnings report, filing, competitor, or market move, and Dexter will pull the research it needs before answering.

Dexter earnings comparison
Dexter earnings comparison

Use it to compare stocks, read SEC filings, summarize earnings, pull current market data, and run follow-up research without opening a new browser tab every time. You can also leave it running with /heartbeat, which turns it into a 24/7 analyst for recurring watchlist checks.

What You Need To Get Started

  • A VPS or spare computer where Dexter can run without slowing down your main machine
  • A terminal-based agent such as Codex or Claude Code to help with setup
  • The Dexter GitHub repo
  • An API key from OpenRouter, OpenAI, or Anthropic
  • A Financial Datasets API key; expect to add about $20 to get started
  • Optional: a Perplexity API key for web search and an xAI API key if you want Twitter/X sentiment

Going Further

Connect Dexter to X so it can add Twitter sentiment to the research brief. A good next prompt would be:

Prompt
Add Twitter/X sentiment to this research workflow for [COMPANY_NAME].

Use it only as one signal. Compare sentiment against filings, earnings, market data, and recent news before drawing conclusions.

Return:
- the strongest positive sentiment themes
- the strongest negative sentiment themes
- whether the market data supports or contradicts the sentiment
- what I should verify before acting on it

You can also adapt the same setup for earnings prep, competitor monitoring, diligence, or sales research. Keep the same pattern: ask a narrow question, make Dexter pull evidence, inspect the sources, then automate only the checks you actually want repeated.

$29 billed monthly · cancel anytime
Go Pro