gitwtfhub

wtf is oddly?

korroai/oddly — explained in plain English

Analysis updated 2026-05-18

11PythonAudience · pm founderComplexity · 2/5LicenseSetup · easy

TL;DR

A tool and Claude Code skill that scans SEC filings for odd-lot stock buyback offers retail investors can profit from.

Mindmap

mindmap
  root((Oddly))
    What it does
      Scans SEC filings
      Finds odd-lot tender offers
      Applies 11 gates
    Tech stack
      Python
      Claude Code skill
      SEC EDGAR API
    Use cases
      Find buyback opportunities
      Track positions
      Backtest strategy
    Audience
      Retail investors
      Founders
    License
      AGPL 3.0
      Personal use allowed
      No commercial use

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

Why would anyone build with this?

REASON 1

Scan SEC EDGAR for active odd-lot tender offers that pass all 11 verification gates.

REASON 2

Run the Claude Code skill to get a step by step verdict on whether a filing is worth acting on.

REASON 3

Record and track odd-lot buy and sell positions through the command line.

REASON 4

Backtest the odd-lot tender arbitrage strategy against 30 historical trades.

What's in the stack?

PythonClaude Code SkillSEC EDGAR API

How it stacks up

korroai/oddly2arons/llm-cliadzza/guardium-dns
Stars111111
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencepm founderdevelopergeneral

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

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires Python 3.10 or newer, no API keys needed, but a brokerage account is required to act on opportunities.

Free for personal use, but commercial proprietary use is prohibited under the AGPL 3.0 license.

Wtf does this do

Oddly is a Python tool that scans SEC filings to find a specific kind of stock buyback called an odd-lot tender offer. These are corporate offers where shareholders who own 99 shares or fewer of a company get priority to sell their shares back at a fixed price, with no reductions or partial fills. A rule written to protect small shareholders ends up creating a situation that only individual investors, not large funds, can take advantage of, and Oddly automates the work of finding it. The tool scans SEC EDGAR filings and checks each one against 11 verification gates in sequence, such as whether the offer is still active, whether it explicitly states an odd-lot provision, whether the payment is fully in cash, whether the price premium is above 10 percent, and whether the deadline falls within 60 days. If a filing fails any gate, it is rejected and evaluation stops there. Most filings do get rejected. When a filing passes every gate, the tool shows the ticker, company, filing type, tender price, market price, premium, and expected profit. Oddly ships as a Claude Code skill. Typing a single command runs the whole pipeline: scanning EDGAR, downloading filings, applying the 11 gates, and presenting a verdict with supporting quotes from the filing text. If an opportunity passes, the skill explains exactly what to do, including how many shares to buy and how to request the tender through a regular broker like Fidelity, Schwab, or Vanguard, since no special account is needed. The project also includes a command line interface for scanning, viewing a portfolio, recording buy and sell positions, and running a backtest against past trades using historical price data. A research paper included in the repository documents the regulatory background and a 30 trade backtest of this kind of arbitrage. It requires Python 3.10 or newer and no API keys. The license is GNU AGPL 3.0, which allows personal use but prohibits commercial proprietary use.

Yoink these prompts

Prompt 1
Run the oddly Claude Code skill and explain any tender offers that pass all 11 gates.
Prompt 2
Walk me through buying and tendering shares for a passed odd-lot opportunity found by oddly.
Prompt 3
Use oddly's backtest module to show historical results for odd-lot tender arbitrage.
Prompt 4
Set up oddly and configure my available capital and minimum premium threshold.

Frequently asked questions

wtf is oddly?

A tool and Claude Code skill that scans SEC filings for odd-lot stock buyback offers retail investors can profit from.

What language is oddly written in?

Mainly Python. The stack also includes Python, Claude Code Skill, SEC EDGAR API.

What license does oddly use?

Free for personal use, but commercial proprietary use is prohibited under the AGPL 3.0 license.

How hard is oddly to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is oddly for?

Mainly pm founder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.