Kairo

Documentation

How Kairo works

Agents that know when to move. Build, test and run paper-trading agents, and read the reasoning behind every decision.

Version November 2026Paper trading only · Not financial advice

How Kairo works

Everything you need to build, test and run trading agents, from your first click in the Studio to reading an agent's diary.

#Overview

Kairo lets you build trading agents without writing code. An agent is a small set of rules, like “buy when the 24h RSI drops below 30, sell when it rises above 60”, applied to up to 3 markets.

• Test it first. The Studio replays the last 30 days of hourly prices with your exact settings, instantly.
• Launch it. Our server then runs your agent every hour on fresh prices, even when your browser is closed.
• Read why. Every buy, sell and hold comes with a plain-English reason, so you always know what the agent saw.

#Quick start

1. Open the Studio.
2. Pick a personality (Momentum, Rebound, RSI Oversold or Breakout), or describe your idea in a sentence under “Just describe it”.
3. Choose up to 3 markets and set your stop loss.
4. Check the replay on the right. Tweak rules until you like what you see.
5. Give your agent a name and press Launch. Sign one free message with your wallet, or launch as a guest.

That's it. Your agent now appears under My agents and in the Arena.

#The Studio

The Studio is split in two: settings on the left, results on the right. Every change re-runs the backtest immediately.

✦ Just describe it

Write your strategy in plain words and the AI turns it into rules. See AI rule generator.

1 · Personality

A ready-made strategy. Pick one as a starting point; editing any rule turns it into Custom.

2 · Markets

Up to 3 markets. The agent watches each one separately and can hold several at once.

3 · Brakes & sizing

Stop loss (2–25%) sells a position once it falls that far below the entry price. Max per position (10–100%) caps how much of the agent's total value goes into a single buy.

4 · Rules

The buy and sell conditions, plus an optional take profit and max holding time. See Writing rules.

#Strategies

Four built-in personalities. Each is just a preset set of rules, so you can open any of them and change everything.

#Writing rules

Every rule compares an indicator with something else:

Comparisons

What can be compared

• Price lines (price, average, highest, lowest) are compared with another price line, never a plain number. To say “3% below the average”, use the offset box (±%) on the average.
• Change, z-score and RSI are compared with a number.

Combining rules

• All must match: the agent acts only when every rule in the group is true.
• Any one: one true rule is enough.
• Each group (buy and sell) can hold up to 6 rules. You need at least one buy rule.
• You need at least one way out: a sell rule, a take profit (1–500%) or a max holding time (1–720 hours). The stop loss always applies on top.

#Indicators

All indicators are calculated on hourly closing prices. “N” is the period you pick from the dropdown.

#How an agent trades

Once per hour, for each of its markets, the agent works through this list and stops at the first thing that applies:

1. Holding? Check the stop loss, then the take profit, then the max holding time. If one is hit, sell everything in that market.
2. Still holding? If the sell rules are met, sell. Otherwise keep holding.
3. Not holding? If the buy rules are met, buy with the smaller of: the cash left, or max per position × the agent's total value. Buys under $10 are skipped.

• Long only. Agents buy and later sell. They never short or use leverage.
• Fees. Every buy and every sell pays a 0.3% fee, so a round trip costs about 0.6%. Over-trading shows up in the results.
• Starting capital. $10,000 of virtual money, shared across the agent's markets.

#Reading the results

Vs holding

The headline number. The agent's return minus what you would have made by splitting $10,000 equally across the same markets at the start and doing nothing. +5 pts means the agent beat simply holding by 5 percentage points. An agent can lose money and still score positive here if holding lost even more.

Agent return

How much the agent's total value (cash plus positions) changed, after fees.

If held

The buy-and-hold return over the same period. This is the dashed line on the chart.

Max drawdown

The biggest drop from a peak in the agent's value. A smaller number means a smoother ride.

Trades · won

Closed trades, and the share of them that made money after fees.

Agent diary

Decisions lists every buy and sell with its reason. Trades shows each closed trade from entry to exit. Right now shows what the agent thinks about each market at the latest hour.

#Live agents

• After launch, the server runs your agent once an hour (a minute after the hour), on the hour that just closed.
• The agent page has two tabs: Live (results since launch) and 30-day backtest (the same rules replayed over recent history). Right after launch the live curve is empty; it fills in hour by hour.
• Pause stops the agent. When you resume, it continues from the current hour and does not trade the hours it missed.
• Delete removes the agent and its whole history. This can't be undone.
• Want different rules? Use Remix it to open the same setup in the Studio and launch a new agent. Launched agents can't be edited, so their track record stays honest.
• Each account can have up to 20 agents.

#AI rule generator

In the Studio, type your idea into “Just describe it” and press Turn into rules. You can write in any language. For example:

• The AI fills in the rules, markets, stop loss and a name. Everything stays editable, and the backtest updates right away.
• If part of your idea can't be expressed with the available indicators (news, volume, shorting…), the AI says so in a Note instead of quietly dropping it.
• Periods are rounded to the closest available one. “1 day” becomes 24h, “3 days” becomes 72h.
• Up to 10 requests per hour, 600 characters each. You need to be signed in (wallet or guest).

#Wallet & guest accounts

Sign in with wallet

Your wallet signs a short message containing a one-time code. It's free, it is not a transaction, and it does not move or approve any funds. Your agents are tied to your wallet address and are reachable from any browser.

Guest

No wallet? Launch as a guest. Your agents are tied to this browser only; clearing cookies loses access to them. If you later sign in with a wallet in the same browser, your guest agents move to your wallet automatically.

#The Arena

The Arena ranks agents by one thing: how far they beat simply holding.

• Live ranks every agent by its results since launch. House agents (built by the Kairo team) show what each strategy does over time.
• 30-day backtest replays the house agents over recent history in your browser.
• Guest owners are shown as “guest”; wallet owners by their shortened address.

#Markets & prices

16 markets, trading 24/7. Agents keep checking at night and on weekends. Prices are hourly, with up to 1000 hours of history.

#$KAIRO & community

The official links. Always check the contract address here before you trade, as copycat tokens are common.

#FAQ

#Disclaimer

Kairo is a simulation and educational tool. Results are hypothetical, based on historical or simulated prices, and include no slippage or liquidity effects. Past performance does not predict future results. Nothing here is financial, investment or trading advice. Do your own research before risking real money.