The mechanism · in plain words

A money changer that never sleeps.

Earn works like a currency kiosk — it quotes both directions around the live FX rate, runs 24 hours a day, and covers as many currencies as you choose. This page builds the prompt; an AI agent sets it all up on your machine.

Always open. Serves dozens of currencies. Earns you the spread.

Where Earn lives.

Earn is open-source code that runs on your machine — not on Sera's servers. That's not a marketing choice; it's the only architecture that keeps Sera (the settlement layer) from holding your private key. Three things live in three different places.

YOU CONTROL
Your machine
Laptop, server, or Claude Code sandbox
  • The AI agent itself runs here
  • Your private key + wallet stays here
  • Signs every order locally
  • Can be paused or stopped anytime — it's your code
SERA (THE SETTLEMENT LAYER)
Sera's API
api.sera.cx — public REST endpoints
  • Routes signed orders to matching
  • Publishes market data & order book
  • Publishes the live token & market registry
  • Never holds your funds or your key
ON-CHAIN
Sera contracts on Ethereum
Audited smart contracts on mainnet
  • Vault contract holds your deposited funds
  • Settles every matched trade on-chain
  • You can emergencyWithdraw() directly if Sera's API ever goes down
  • Open-source, audited code
The legal point

Sera (the settlement layer) never has the ability to move your money. Every order, cancel, and withdrawal needs a signature from your wallet — and your wallet's private key lives on your machine, not ours. The only thing Sera can do is route your already-signed messages and publish market data.

Example · USD / SGD — same pattern for every currency pair
Quotes sit at Wise's after-fee price — about 0.4% each side of the reference here. Your risk level shapes only the closing order.
Where the earnings come from · the same pattern works for any supported pair
Offer to buy and sell at Wise's after-fee price. Earn the spread whenever takers trade both sides.

One pool, dozens of markets at once.

Sera's shared capital design means your stablecoins earn against every currency you pick at the same time — not split across them. Pick as many of the 40 supported tokens as you like. The same dollar backs every market at once.

The same dollar can earn across every currency you pick, at once.
Shared capital · one pool, many currencies
Earned this session
2.335USDC
an illustrative session — your pace depends on spread & flow
Swaps through your liquidity example
→1,280 USDC · SGD+0.412
←940 USDC · EUR+0.236
→610 USDC · JPY+0.158
→1,050 USDC · MXN+0.391
←720 USDC · GBP+0.244
→480 USDC · BRL+0.187
Atomic settlement zoomed in
XSGD
100kUSDC
TGBP

A trader's XSGD → TGBP swap routes through your USDC pool. Both legs settle atomically. You keep USDC and earn +0.114.

✓ You only hold currencies you set rates for.

A trade cycle on USD / SGD

Here is what happens to $1,000 of your capital, step by step, when the market behaves normally. Earn never trades against Sera — takers on Sera hit your quotes.

0
The reference price
The independent reference — the European Central Bank's published rate — puts USD/SGD at 1.2750. Quotes sit at Wise's prices on either side of it, and it sets how close a closing order may come.
1.2750 reference mid
1
Earn quotes both sides
Offers to buy USD at 1.2701 and sell at 1.2799 — Wise's after-fee prices for that order's size (illustrative here: about 0.4% from the reference on each side; Wise's fee is higher on small amounts and lower on large ones).
1.2701 / 1.2799 our prices
2
Step 1 — a taker buys USD from you
A taker wants USD now and hits your offer: they give you 1,279.90 SGD for your $1,000 USDC. You hold SGD until you sell it back.
+1,279.90 SGD in progress
3
Earn offers to buy USD back
Earn posts the closing quote as a 48-hour auction: it offers to buy USD back from 1.2543 SGD per dollar (2% better than the sale, with the default Conservative style) and moves toward the sale price. About 30 hours in it reaches 1.2701, where a taker sells in the next step. Had nobody sold, it would have kept rising to 1.2746, 3 bps short of the 1.2750 reference, about 38 hours in, and waited there.
offer live waiting for buyer
4
Step 2 — a taker sells USD back to you
A taker sells USD into your bid: you take their $1,000 USDC and pay them 1,270.10 SGD. Round trip complete.
+9.80 SGD profit earned
Started with$1,000.00 USDC
After step 1 (sold USD at 1.2799)+1,279.90 SGD, −$1,000 USDC
After step 2 (bought USD at 1.2701)−1,270.10 SGD, +$1,000 USDC
Final result$1,000 USDC + 9.80 SGD ≈ +$7.71 (≈ 0.77%)

The 9.80 SGD is the earned spread — the difference between selling at 1.2799 and buying back at 1.2701, scaled to $1,000. Both fills together capture ≈0.77% of the round trip. Wise's fees set how far apart the two quotes start; your trading style sets where the closing auction begins.

From 0.76% per trade to ~30% yearly return.

A single trade earns a tiny fraction of a percent. Multiply by the trades per day, the currencies running in parallel, and the days in a year — and the small per-trade profit compounds into a real yearly return.

Profit per trade (after costs) ~0.10% after costs
Active currencies at any time ~14 of the currencies you picked (quiet ones skipped)
Avg trades per currency per day ~0.8
Money used per trade ~50%
Estimated daily return on your money ~0.06 – 0.10%
Yearly return (compounded) ~24 – 44% APY

The range reflects the natural variation in how often trades happen. Strongly trending markets shrink the actual number; markets that move back and forth grow it. Treat every number here as illustrative — your trading style, currencies, and market conditions set the real figure.

What the trading style changes

Every style quotes at Wise's after-fee price. The style sets only the closing order: where its 48-hour auction starts. Further from the fill = more profit per round trip, but positions take longer to close.

Standard
Closing auction starts 1% from the fill
1% start
Balanced between profit per round trip and how quickly positions close.
Aggressive
Closing auction starts 0.5% from the fill
0.5% start
Closes positions soonest, for the smallest profit per round trip.
How the closing order moves over time Three lines, one per trading style, start 2%, 1% and 0.5% from your fill price and move toward it. Each stops when it is a few basis points from the reference mid, which in the USD/SGD example is about 0.4% from the fill: the 0.5% line after about 9 hours, the 1% line after about 28 hours, the 2% line after about 38 hours. In the example above a taker takes the 2% line about 30 hours in. The order reaches the fill price itself only if the market moves against you. DISTANCE FROM YOUR FILL PRICE TAKEN 30 H IN WAITS A FEW BPS FROM THE MID 2% 1% 0.5% MID FILL 0 h 24 h 48 h HOURS SINCE THE FILL
This is a reverse Dutch auction. The closing order asks for the most profit first and a little less every cycle, until it sits a few bps from the reference mid: a far better rate than Wise's. People who need that currency, and arbitrageurs who can get it cheaper elsewhere, take it there. You keep a smaller profit, they get a near-mid rate, and prices on Sera move closer to the true mid. It reaches your fill price only if the market moves against you, and never goes past it, so it never closes at a loss.
The closing order over time · USD/SGD example, mid 0.4% from the fill
This range rests on the assumptions above. Actual returns vary with how busy Sera is, how much trading happens, market direction, and how much capital is in the strategy. Earn earns less in strongly trending markets and more in markets that move back and forth. Past performance doesn't guarantee future returns.

What Earn is doing at any moment

At any moment, your money is in one of these four states — and all four can be happening across different currencies at once. Run rotor with --log-level INFO and your terminal shows which.

Waiting for trades
Both buy and sell prices posted on Sera, your money sitting in USDC, waiting for someone to trade.
Mid-trade · holding currency
First half done. Holding the currency. Earn posted the reverse offer. Halfway through earning the profit.
Trade finished
Both halves filled. Profit earned in USDC. Earn posts fresh prices and starts again.
Updating prices
Sera's prices moved. All open offers cancelled and reposted at the new prices. Free to do.

What to expect after you go live.

From the moment the agent starts quoting, here's the natural cadence — and why a quiet first day is not a broken agent.

0 min
The agent starts rotor

rotor reads the config your agent wrote — your stablecoins, currencies, and spread — verifies your wallet, syncs the server clock, and prepares the first cycle.

~1 min
First quotes posted on Sera's book

A single VL batch of bids goes up — one bid per currency, all sharing your stablecoin budget. At --log-level DEBUG your terminal lists every placement. You haven't earned anything yet — that's normal.

within a day
First fill

Someone hits one of your bids. Your USDC converts to that currency. On its next cycle the agent posts the closing ask: a reverse Dutch auction that starts well above your fill price and comes down until it sits a few bps above the mid, where it waits. You're now mid-trade.

within a day
First completed round-trip

The closing ask fills. Currency converts back to your stablecoin at a profit — usually a few cents on a $1,000 budget. The log records it at --log-level INFO, and the agent reposts for the next one.

Hasn't filled after a day? That's fine.

Either the markets are quiet (weekend, off-hours for your pairs) or your chosen spread is wide and nobody has crossed it yet. The agent is still working — it's a market maker, it waits.

And a slow market still pays: even one 0.77% round-trip a month adds up to roughly 9% a year. Pick more currencies, or wider-spread pairs, and the cadence picks up fast.

What the agent actually does, every ~5 minutes.

This is rotor's live run loop — the open-source script your prompt sets up. Sera enforces a cancel cooldown on resting orders; rotor's default 305-second cycle leaves a settlement buffer before re-quoting.

01
Fetch a reference mid-price for every pair

Each currency's mid comes from the source you chose — by default the central banks in the order you set (the ECB and Bank Negara Malaysia), moving to the other when one doesn't publish that currency or hasn't updated, and Wise for the few currencies neither publishes. Over the weekend, when the banks are closed, Wise's live mid stands in. No price feed from Sera is trusted blindly; the reference is independent.

GET wise · ecb · bnm independent reference rates
02
Quote one bid and one ask at Wise's prices

Each quote sits at what converting that order's size through Wise would actually cost after fees, at the cheapest bank transfer: a taker on Sera gets the same price as going through Wise. Wise's rates are live, so quotes follow the market even when the daily reference hasn't updated. Where Wise can't price a side — a few currencies it can't send from, or Wise being down — that side sits a set spread from the mid, wider on weekends and during outages. One bid, one ask, per market.

bid = Wise's after-fee rate to sell that size  ·  ask = Wise's after-fee cost to buy that size
03
Poll fills on the tracked quote set

rotor checks which of its resting orders filled since last cycle. A filled bid means it now holds that currency — so the opposite side becomes a return order that starts twice fixed_bps from the fill price and walks toward it over 48 hours (a reverse Dutch auction). It stops return_bps short of the mid, and never goes past the fill price, so it never sells back at a loss.

after a fill: the opposite side walks back toward the fill price over 48 h, stopping return_bps from mid
04
Cancel old placements — when the guard permits

Tracked placements from earlier cycles are cancelled once the local cancel guard allows it, so the agent never trips Sera's cancel cooldown chasing every tick.

POST /orders/cancel EIP-712 signature, signed on your machine
05
Place the fresh quote set — VL where eligible

The new quotes go up. Orders that spend the same stablecoin are grouped into one Virtual Liquidity batch — a single budget backs all of them at once instead of locking funds per order.

POST /orders/vl/batch siblings grouped by the stablecoin they spend
06
Sleep, repeat — and stay silent

Then it waits out the rest of the 305-second cycle and goes again. Nothing phones home: logs stay on your machine, and the only outbound message is the optional Telegram alert you configured — sent to you, nobody else.

LOCAL your terminal · optional Telegram no analytics, no tracking, no phoning home
The agent never takes — it only makes. Every order is a limit order resting on Sera's book, and every one of them is signed by your wallet, on your machine. Stop the script and the quotes stop with it.

Why this works, and where it doesn't.

Honest framing — the edge is real, but it isn't free money. Here is the structure of both.

Why the edge exists

  • Spreads vary widely by currency pair — razor-thin on majors, much wider on less-traded pairs (often over 1%). Quotes sit at Wise's price, so the wider Wise's fees on a pair, the more each round trip earns.
  • Sera's shared capital design lets the same stablecoin earn against every currency you pick at the same time — far harder-working than a regular trading account.
  • Updating quotes is free, so Earn follows Wise's live price every cycle without paying any fees.
  • Running 24/7 means trades happen across every time zone, not just during local hours.
How quoting works, with the default setup
Normal quotes Wise's after-fee price
Quotes refreshed every 305 s
Cost to update quotes none
Closing order 48-hour auction
How rotor behaves, not past results. Nothing phones home, so there are no aggregate numbers to show.

Where the risk is

  • Mid-trade risk — between step 1 and step 2, you're holding a currency. If the price moves against you before step 2 happens, that trade earns less or loses.
  • Trending markets — when a currency moves one direction hard, only one side trades, leaving you holding the currency while waiting for prices to swing back. Its closing order waits at your fill price, so the trade stays open rather than closing at a loss.
  • Stopping mid-trade — if you stop while a trade is in progress, you keep the currency you were holding until you sell it back yourself.
  • Stablecoin pegs — Sera treats every stablecoin as worth exactly its currency, and Earn prices it that way. If a stablecoin loses its peg, Earn keeps buying it at the currency's rate and holds it until the peg returns.
  • How this is handled — many currencies running in parallel spread out the risk. A slow trade on one currency is offset by finished trades on the others.
What limits the downside
Closing orders never cross your fill price
Most you can convert what's in your Sera vault
Orders left behind expire after 10 minutes
Stablecoins priced at 1:1 with their currency
How rotor behaves, not past results. Past performance isn't a guarantee.

Open-source software. Use it, fork it, or build your own.

Earn is free, open-source code. We built and released it so more people can earn from FX without having to write trading software themselves.

⌥
github.com/sera-cx/rotor

The full source code of rotor — the market maker your prompt sets up — is public. Read it, audit it, run it on your own machine, or fork it.

View the repo →
⌘
docs.sera.cx

Sera itself is permissionless. Anyone can build their own trading AI agents or yield strategies on top — Earn is just one example of what's possible.

Read the docs →
How the permissions work

rotor gets one ability only: post and cancel quotes on Sera with the stablecoins you put up. It cannot move money to another address and cannot do anything you didn't sign for — every order is signed by your wallet, on your machine. Withdrawing always needs your own signature, and stopping the script stops the quotes. Any agent you build yourself works the same way — that's how Sera is designed.