repowisedefeat-beta/defeatbeta-api

defeat-beta / defeatbeta-api

An open-source alternative to Yahoo Finance's market data APIs with higher reliability.

Python★ 761
Use in your agentAsk this codebase

github.com/defeat-beta/defeatbeta-apiIndexed at 00296ddUp to date with upstream

What is defeatbeta-api?

defeatbeta-api is an open-source alternative to Yahoo Finance's market data APIs for retrieving and analyzing financial data. It provides a market data interface built around the Ticker class and uses Python with DuckDB and the cache_httpfs extension.

Written by a model from the README and the source

166 files and 485 symbols in 4 modules, led by Python (68 files) and Shell (2).

Start reading

Code health

6.8out of 10Fair

This codebase scores 6.8 out of 10 for code health, which we rate fair. It also scores maintainability 7.5 and static performance 9.2 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 3 of 166 files are git hotspots, and they average 1.1 — which is where the fixes pay off most.

Full health report

On the leaderboards:#31 of 49 Python repos

Use defeat-beta/defeatbeta-api in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/defeat-beta/defeatbeta-api
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is defeatbeta-api put together?")
  • get_why("why is defeatbeta-api structured this way?")

Explore defeatbeta-api

Key features of defeatbeta-api

  • defeatbeta-api provides market data including financial ratios, SEC filings, earnings call transcripts, stock news, and revenue by segment and geography.
  • defeatbeta-api generates Discounted Cash Flow analysis with WACC calculations, projected cash flows, enterprise value, fair price, and editable Excel output.
  • defeatbeta-api uses Large Language Models to analyze earnings call transcripts, quarterly financial changes, and quarterly forecasts.
  • defeatbeta-api includes an MCP server implementation for AI access to financial analysis.
  • defeatbeta-api includes a Skills implementation for AI financial analysis workflows compatible with platforms that support skills.

How defeat-beta/defeatbeta-api works

Input enters through the Ticker class in defeatbeta_api/data/ticker.py, which accepts a company ticker symbol such as TSLA. The ticker exposes methods for prices, financial statements, earnings call transcripts, and other market data. DuckDB performs SQL-compatible analytical queries against the hosted market data source through cache_httpfs. Transcript access separates catalog listing from on-demand retrieval by fiscal year and quarter. The mcp directory provides an MCP server implementation, while the skills directory provides workflows for AI financial analysis. The test/test_ticker.py file covers ticker behavior, and mcp/src/defeatbeta_mcp/tools/breakdown.py implements an MCP analysis tool.

The codebase has 166 files and 485 symbols in 4 modules, led by Python and Shell. Code health is 6.8 out of 10, rated fair.

Getting started with defeatbeta-api

  1. Install defeatbeta-api from PyPI with pip.
    pip install defeatbeta-api
  2. Create a Ticker instance with a company ticker symbol.
    ticker = Ticker('TSLA')

Commands copied from the README

defeat-beta/defeatbeta-api FAQ

What is defeatbeta-api?

defeatbeta-api is an open-source alternative to Yahoo Finance's market data APIs. It provides access to financial data, analysis, transcripts, news, and valuation workflows.

How does defeatbeta-api work?

defeatbeta-api uses the Ticker class to request company data and DuckDB with cache_httpfs to run SQL-compatible analytical queries. Its MCP and Skills modules extend access for AI analysis.

How do I install defeatbeta-api?

defeatbeta-api installs with pip using the command pip install defeatbeta-api. The package supports MacOS, Linux, and Windows.

What language is defeatbeta-api written in?

defeatbeta-api is written primarily in Python. The repository also includes shell files.

How is the defeatbeta-api code organized?

defeatbeta-api is organized around the defeatbeta_api, mcp, doc, and skills directories. The defeatbeta_api directory holds core data access, while mcp and skills provide AI integrations.

Who is defeatbeta-api for?

defeatbeta-api is for users who need market data APIs, financial analysis, valuation output, earnings transcript analysis, or AI access through MCP and skills.

What license does defeatbeta-api use?

defeatbeta-api uses the Apache-2.0 license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of defeat-beta/defeatbeta-api from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.