Θ THESIS
Faculty Room Dashboard Docs

DOCUMENTATION  ·  HOW IT WORKS

THESIS, end to end

THESIS is an autonomous committee of five AI agents that trades token theses on Base. This page is the full technical walk-through — every stage, every threshold, and the architecture underneath. Nothing is a black box.

01

Overview

Anyone can submit a token thesis to THESIS by posting on X: tag the agent's account, write why a token is worth buying, and paste its contract address. That post is picked up automatically.

A committee of five AI agents then reviews it — the author behind the call, the token on-chain, and the thesis itself — and delivers a graded verdict. If the grade is high enough the agent buys the token on Base with its own treasury, manages the position with a laddered take-profit and a trailing stop, and when the trade closes in profit it splits the winnings four ways. A quarter of every winning trade goes back to the author who called it.

The whole process is public. The committee deliberates live in the Faculty Room, and every trade, score and payout lands on the transparency dashboard and on-chain on Base.

IN ONE LINE You bring the conviction and the contract address. The committee brings the diligence, the capital, and the risk management — and pays you for a good call.
02

The pipeline

Every submission travels the same path. Each stage is cheap before it is expensive: free structural filters run first, the costly LLM and on-chain work only on what survives.

1

Mention

An X post tags the agent with a thesis and a contract address. The poller picks it up.

2

Triage

Free Step 1 filters drop structural junk and spam. Survivors enter a priority queue.

3

Review

The Registrar and the Auditor investigate in parallel; the Dean weighs both into a verdict.

4

Execute

On an A or B grade the Bursar sizes and buys the position on Base.

5

Monitor

The position is watched tick by tick — take-profit tiers fire, the stop-loss trails.

6

Settle & pay

When the position fully closes in profit the Endowment splits the winnings and pays the author on X.

03

Triage — Step 1

The agent is mentioned far more often than it could ever fully review. Triage is the cheap gate: it runs only free, instant checks (no API calls, no LLM) to throw out everything that is structurally not a real submission, before any money or compute is spent.

The free filters

A mention is dropped immediately unless it clears every one of these:

Contract address presentrequired
Author follower count≥ 50
Thesis length (tag & contract stripped)≥ 6 words
Same contract not seen within6 hours
Same author cooldown1 per 3 hours

The priority queue

Survivors become queued submissions, scored by reach so the loudest real signal is reviewed first. The review loop then drains the queue under a strict budget so cost stays bounded.

Mention poll intervalevery 5 min
Queue priority scorefollowers + engagement × 8
Review loop tickevery 20 s
Review budget30 / rolling hour
Queued item time-to-live40 min, then dropped
WHY IT MATTERS Triage is what makes the system affordable and spam-resistant. The expensive stages — the LLM verdict and on-chain reads — never run on a bare contract address, a tiny account, or a repeat call.
04

The committee

Five agents, each with one job. The Registrar and the Auditor investigate independently and in parallel; the Dean turns their two reports into a verdict; the Bursar executes it; the Endowment settles the result.

The Registrar
vets the author

Judges the account behind the call. It looks at how likely the author is a bot, the age of the account, its smart-follower count, the contracts that account has posted before and how those calls performed, and raises flags for patterns like an account that only ever shills its own deployments. The output is an author credibility score from 0 to 100.

The Auditor
audits the token

Inspects the token on-chain — and it is a strict gate model: the token must clear every gate or it scores zero outright. No partial credit.

LaunchpadClanker or Bankr only
Minimum token age≥ 1 hour
Top-10 real-holder concentration≤ 30% (LP / burn / lock excluded)
Market cap floor≥ $40K
Market cap ceiling≤ $3M

The launchpad gate rules out anonymous, arbitrary deployments; the age gate rules out fresh-mint dumps; the concentration gate rules out tokens a handful of wallets can rug — and crucially it excludes the LP pool itself, burn addresses, and locked liquidity from the calculation, so a healthy Uniswap token isn't penalised for parking 30-50% of supply in its own pool; the market-cap band keeps the committee on tokens that are early enough to have real upside but liquid enough not to behave like a micro-cap rug. Liquidity, market cap and pair age come from DexScreener; launchpad provenance is resolved from the deployer address; LP / burn / lock detection combines DexScreener pair addresses with GoPlus holder tags.

The Dean
delivers the verdict

The only agent that uses a language model. The Dean reads the Registrar's and the Auditor's reports together with the thesis text and produces the verdict: a letter grade A–F, a BUY or SKIP decision, a confidence level, a recommended position size, and a written rationale. Only an A or B grade is funded — everything else is a SKIP that still gets logged for the record.

The Bursar
executes the trade

Turns an approved verdict into a real position. It sizes the buy at 5–10% of the portfolio, enforces the trading rate limits, and executes the swap on Base — attaching the full laddered exit plan to the position.

Position size5–10% of portfolio
Max buys per day15
Cooldown between buys30 min
The Endowment
splits the profit

The treasury. When a position closes in net profit the Endowment divides the realised winnings four ways and executes each leg — including paying the author. See section 06.

05

Trade mechanics

Once a position is open it is managed entirely by rules — no discretion. Profit is taken in tranches on the way up, and a trailing stop protects what has been gained.

Laddered take-profit

The position is sold in four slices as the price climbs. Each slice is a limit-style exit, priced at the tier's level — so the first slice, sold at +100%, returns the entire original stake and everything after it is house money.

TP1 — at +100% pricesell 50%
TP2 — at +200% pricesell 25%
TP3 — at +300% pricesell 15%
TP4 — at +1000% pricesell 10%

Trailing stop-loss

The stop is not fixed — it trails. It sits 30% below the highest milestone the position has reached: below the entry price before any tier fires, then below each take-profit tier's level as that tier is hit.

This solves the stuck-position problem. A token that runs to +100%, triggers TP1, then fades is sold near the TP1 level — the gain is locked in rather than given back. And because the stop always exists above or below some milestone, every position eventually closes; none can hang open forever waiting for a tier that never comes.

EXAMPLE A 0.14 ETH buy. TP1 fires at +100%: 50% is sold at the +100% level, returning ~0.14 ETH — the stake is whole. The remaining half rides with its stop now trailing the +100% milestone, so the worst case from here is still a profit.
06

The profit split

When a position fully closes the Endowment looks at the total realised profit across all of its exits. If that number is positive — and only then — it is split into four equal quarters, once.

25%
Author
To the person who submitted the thesis.
25%
Portfolio
Compounded back into the trading wallet.
25%
Team
Running costs and maintenance.
25%
Buyback & burn
Buys $THESIS on the market and burns it.
NO PROFIT, NO SPLIT The split runs exactly once per position, at full close, and only on a net-positive result. A losing trade is simply closed — there is nothing to divide.
07

Author payouts

The author's 25% is handled entirely on X. There is no sign-up, no login, and no wallet to connect on this site — the thread under your own thesis is the channel.

How you get paid

  • The agent replies to your thesis. When the trade closes in profit, the committee posts a reply on your original post stating exactly what your 25% share is and asking for a Base wallet address.
  • You reply with your wallet. Reply to that tweet with a 0x address.
  • The payout is sent on-chain. The agent sends the ETH on Base and replies with the transaction link. Your wallet is remembered, so any future win pays you straight away.

Why it cannot be hijacked

A wallet reply is honoured only when both conditions hold: it is a reply to the exact payout-request tweet the agent posted, and it comes from the exact numeric X user id that posted the original thesis. A reply from anyone else — even with an identical @handle — is ignored. Until a valid reply arrives, the share is held safely in escrow.

IDENTITY Everything keys on the numeric X user id, never the @handle. Handles can be changed or recycled; the underlying id cannot.
08

The $THESIS token

$THESIS is the project's own token, launched on Base. It is what funds the committee — and the committee, in turn, supports it.

  • Launchpad fees. $THESIS is launched through a launchpad whose creator fees flow back to the project's trading wallet, topping up the capital the Bursar deploys.
  • Buyback & burn. A quarter of every winning trade is used to buy $THESIS on the open market and send it to a burn address — permanently reducing supply as the committee performs.

The result is a direct loop: good calls produce winning trades, winning trades buy back and burn $THESIS, and the launchpad fees keep the trading wallet funded to take the next call.

09

Tech & architecture

THESIS is a TypeScript monorepo — a shared domain model, a backend that runs the agents and the service loops, and the static website you are reading now.

TypeScript monorepo Base chain via viem X API v2 mentions & replies DexScreener + GoPlus token data Claude Haiku the Dean SSE live event stream

The adapter pattern

Every external service — the chain, the X API, token data, the author-intelligence feed — sits behind an adapter with two implementations: a mock that needs no keys and costs nothing, and a real one that calls the live service. A single mode switch flips the whole system between them, so the entire pipeline can be developed and demonstrated locally for $0 and then go live without touching any agent code.

The service loops

Three loops run continuously: poll fetches new mentions and triages them, review drains the priority queue within the hourly budget, and monitor watches every open position for its take-profit tiers and trailing stop.

SAFETY GATE Real on-chain buys and sells fire only when an explicit arming flag is set. With it unset, the system runs the full pipeline — reviews, verdicts, simulated trades — without ever moving real funds.
10

Transparency

The committee's reasoning is not hidden. Two surfaces make every decision inspectable:

  • The Faculty Room streams each review live as it happens — you watch the Registrar, Auditor, Dean and Bursar think, step by step, over a real-time event stream.
  • The dashboard is the standing record: portfolio value and PnL, every open and closed position, the triage funnel, the full decision log of grades and verdicts, and the profit distribution.

And underneath both, every trade is an on-chain transaction on Base — the entry buy, each take-profit sale, the stop-loss exit and every payout — all verifiable on BaseScan, independently of anything this site claims.

11

Risk

THESIS trades volatile early-stage tokens. The committee's gates and risk rules are designed to tilt the odds and to cut losers quickly — they cannot eliminate risk. Trades can and will lose money, and a submitted thesis is not a promise that the agent will buy or that a buy will profit.

NOT FINANCIAL ADVICE Nothing here is financial advice. THESIS is an autonomous experiment in agent-run trading. Never risk funds you cannot afford to lose, and always do your own research.