Oft3r GitHub avatar

agentic-trading-desk

Oft3r

Agentic Trading Desk is a local, modular trading system that combines an AI agent (via Robinhood MCP) with deterministic Python scripts to score stocks and ETFs using a three-pillar framework of trend, momentum, and macro sentiment, with the user always approving execution.

Stars

240

7-day growth

No data

Forks

56

Open issues

0

License

MIT

Last updated

2026-07-02

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It enforces a clear separation of concerns: the AI handles data fetching and user interaction, while deterministic, zero-network-dependency Python scripts compute all technical indicators, ensuring reproducibility and speed. The three-pillar scoring system and guardrails (protected positions, mandatory confirmation) make it a practical, risk-aware tool for short-term portfolio management.

Who it is for

  • Retail traders using Claude Code who want automated technical analysis
  • Quantitative developers building local trading assistants
  • Investors managing short-term portfolios with a rule-based approach

Use cases

  • Analyze a stock or ETF for a potential entry or exit using the three-pillar scorecard
  • Automate daily macro sentiment scoring for cross-asset market context
  • Get structured trade recommendations (HOLD, EXIT, RE-ENTRY, etc.) without manual indicator calculation
  • Integrate as a Claude Code skill for conversational trading analysis

Strengths

  • Deterministic calculations: all scripts use only Python stdlib, ensuring speed and zero network dependency during execution
  • Transparent three-pillar framework (trend, momentum, macro) with clear scoring from -6 to +6
  • Strong guardrails: protected positions, account segregation, T+1 liquidity checks, mandatory user approval for every order
  • Easy integration: can be placed as a skill in Claude Code for interactive use

Considerations

  • Relies on Robinhood MCP for data; not broker-agnostic
  • Macro sentiment requires manual injection of 10Y-2Y yield spread from Investing.com (not fully automated)
  • No backtesting or historical performance validation is provided or claimed

README quick start

Agentic Trading Desk

Personal trading desk for technical analysis and short-term portfolio management on stocks and ETFs. The system combines the automation and query capabilities of an Artificial Intelligence agent (via Robinhood MCP protocol) with local deterministic mathematical calculation engines in Python.

The ruling principle is: the AI fetches data and interacts with the user; the scripts perform the deterministic calculations; the user decides and approves execution.


🚀 Project Architecture

The project is designed to operate locally and modularly. All technical indicator computations are delegated to Python 3 scripts that only use the Python standard library (stdlib), ensuring speed and zero network dependencies during execution.

graph TD
    A[Robinhood MCP / API] -- Price Historicals / Quotes --> B[Claude / Agentic Core]
    C[Investing.com / Web] -- 10Y-2Y Spread / News --> B
    B -- JSON of Daily Closes --> D[scripts/macro_pillar.py]
    B -- JSON of Closes + Holding status --> E[scripts/score.py]
    D -- Injected Macro Score --> E
    E -- Raw Indicators --> F[scripts/indicators.py]
    E -- Three-Pillar Scorecard + Suggested Decision --> B
    B -- Visualized Proposal --> G[User]
    G -- Order Confirmation --> A

File Structure

  • SKILL.md: Operations manual and specific guardrails guiding the AI agent's actions.
  • scripts/indicators.py: Mathematical engine to calculate technical indicators without visual estimations.
  • scripts/macro_pillar.py: Macro regime detector and cross-asset sentiment scorer.
  • scripts/score.py: Evaluator of the three-pillar framework and exit/entry decision engine.

📈 The Three-Pillar Framework

Each analyzed asset is scored in three independent categories with scores from -2 to +2 (for a consolidated total range of -6 to +6):

1. Trend

Determined in scripts/score.py using:

  • Price position relative to the EMA 20.
  • Structural crossovers between exponential moving averages: EMA 20 > EMA 50 and EMA 50 > EMA 200.
  • Slope direction of the EMA 200 (measured relative to 5 bars ago).

2. Momentum

Determined in scripts/score.py combining:

  • RSI-14 using Wilder's smoothing (ne

Description

AI-assisted trading desk for short-term technical analysis on stocks & ETFs via Robinhood MCP. Deterministic Python engines score each asset on a three-pillar framework (Trend · Momentum · Macro-Sentiment) using EMA, RSI, MACD, TRIX & Bollinger Bands. The AI fetches data; the scripts compute; the human approves every order.

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482