Personal project · AI agent

Trading Agent

A private research agent I built for my own crypto analysis. It exists because manual analysis was taking too long: too many charts, too many tabs, too many repeated steps. It follows the way I already work, applies rules learned from experience, and gives me a faster, consistent starting point.

Why it exists

Manual analysis was the bottleneck. Reading movers, checking structure, forming a bias, writing it down, and turning it into a plan all happened across separate screens and tools. Each part was useful, but the switching was slow, and the longer it took, the easier it became to skip a step or rush a decision.

The agent removes that friction. It runs on Telegram and is built on top of Hermes Agent, reading public OKX data on request. A short command returns the market view, the reasoning, and the document that belongs to it, without making me rebuild the same context by hand.

The goal is not to replace analysis. The goal is to make the same analysis faster, more consistent, and easier to review. This is strictly a personal tool: no dashboard, no public link, no account for anyone else. It is tuned to one person's workflow, and that person is me.

What the agent can do

Scan the market

/movers
The raw market view: top 10 gainers and top 10 losers over 24 hours, with no interpretation added. I use it to see where attention is moving before deciding what deserves a closer look.
Skill: movers · Source: get_market_movers_24h
/movers-top
The scanner with judgment. It narrows the market into long-watch and short-watch candidates and assigns each one a grade, replacing a manual sweep with a shortlist I can act on.
Skill: movers-top · Source: get_trade_candidates

Read one coin

/analisa COIN
A focused technical read of one coin: bias, trend, trigger, and invalidation. It follows the same sequence I would walk through on a chart, written out in the order I need to make a decision.
Skill: analisa · Source: get_symbol_snapshot
/struktur COIN
The context layer: market structure and the price zones that matter around the current move. It shows where price is respecting a level, where the range sits, and what would break the read.
Skill: struktur · Source: get_symbol_snapshot

Produce a document

/report COIN
Turns the analysis into a technical PDF report. The point is to get the read out of the chat and into a format I can review later, annotate, or keep next to past sessions.
Skill: report · Source: generate_report.py
/tradeplan COIN
The decision document: an eight-page PDF playbook that carries the setup, the reasoning, and the invalidation into one structured plan. It is the version I read when I am away from the charts.
Skill: tradeplan · trade_plan · trade-plan · Source: generate_trade_plan.py

Rules come from experience

The rules inside the agent are not generic indicators, and they are not something the model invents. They are the checks I already use after spending time in the market: what makes a move worth watching, when volume supports it, which structure invalidates the idea, and when the right answer is to wait.

Writing those rules down made them repeatable. The agent applies the same sequence whether I check the market for ten minutes or review it carefully over the weekend. That consistency is the real gain: fewer wasted minutes, fewer skipped steps, and a baseline I can compare against.

Every output shows the data it used and the conditions it applied. When data is missing or two sources disagree, the command says so instead of forcing a conclusion.

Built for speed, not scale

Each command is intentionally narrow. It answers one question: what moved, what is worth watching, what this coin looks like, what the structure is, what the report says, what the plan is. Narrow scope keeps responses fast and makes a wrong answer easy to spot.

The umbrella skill, okx-telegram-command-workflows, holds those boundaries together: response style, what each command is allowed to do, and how errors or conflicting data are handled.

This is a personal research tool. It does not execute trades, it does not manage funds, and nothing it produces is financial advice.