MarkoutDocs
How it works.
What the bots do with your orders, what a funding pair costs and when it pays back, who charges which fee, and what the keys can and cannot do.
What it does
Markout runs trading bots on your own account at a perp DEX. Your money stays on the venue. The bot gets a key that can trade and cannot withdraw.
Cost per $1M
Volume is not free. A bot pays fees, and the price sometimes moves against the small position it holds. Cost per $1M is everything a run lost, per million dollars it traded. It is the one number to compare venues, markets and settings by.
- Fees $3.00
- Price moved against the position $2.00
Maker bot
The maker bot keeps buy and sell orders resting in the book, at the best price or a little behind it. The orders are post-only: they wait to be hit and never cross the spread, so every fill pays the lower maker fee.
- Rest on both sides. When the price moves, the orders follow it.
- One side fills. The bot now holds a small position.
- The other side works it off. Both fills count as volume.
- Repeat until the target volume or the max loss.
You set three numbers: the capital the bot may use, the volume you want, and the most you accept to lose. The estimate then gives the cost per $1M and the hours to the target.
Style: where the orders sit and how much the bot may hold
A style is one point on a square. Left to right moves the orders away from the best price. Bottom to top lets the bot hold a bigger position before it stops adding to it.
- Sharp
- The default. Almost at the best price, small position. The most fills per hour.
- Patient
- A few bp off the best price. Far fewer fills, so slower.
- Bold
- At the best price with a bigger position. More volume, more swing.
- Wide & bold
- The fewest fills per hour, the slowest to a target.
Protection: four limits, from the first to the last
- Stop-loss distance
- From the loss budget that is left, and never closer than 3 spreads or 10 bp, so normal noise does not trigger it. After a stop-out the side that built the position waits 30 s.
- If our server is down
- The stop order is on the venue, not with us, so it still works. When the server is back the bot picks up where it was.
- Stopping a bot
- It cancels its orders and closes the position: up to 120 s with maker orders, then at market. "Close fast" waits 15 s.
- Max loss
- Counts fees and price moves together. It is a limit the bot acts on, not a guarantee: in a fast market the close can land past it.
Taker bot
Some venues score taker volume higher than maker volume. The taker bot buys at the ask and sells at the bid about a second later, at a steady pace. Nothing rests in the book and the position lives for about a second.
- When it waits
- While the spread is wider than 3 taker fees (at least 1 bp). Paying more spread than fee defeats the point.
- Pace
- 6 to 600 fills per hour. By default the pace that reaches your target in the estimated hours.
- Protection
- The close is the stop, so no stop order is placed. The max loss and the target work as for the maker bot.
Funding pairs
A perp has no expiry, so venues keep its price near the spot price with funding: a small payment between longs and shorts every hour, or every 4 or 8 hours. When the rate is positive, longs pay shorts.
The same asset has a different rate on each venue. A pair is a long on the venue where the rate is low and a short of the same size where it is high. The price moves cancel out. What is left is the difference between the two rates: the carry.
What a pair costs: four fills
To open the pair you trade twice, and to close it twice more. The cost of the pair is the fee on these four fills. It depends on how the orders are filled, which is the switch Maker / Mixed / Taker above the table.
- What is in the cost
- Each venue's fee on each of the four fills, the Markout fee where it is on, and the current spread of each market you cross.
- What is not
- The price moving between your two orders while you open or close, and the cost of moving money between venues.
- Which one
- Maker when you can wait for both orders to fill. Mixed when you want the hedge the moment you are in. Taker when the rate is a spike you want now. The dearer the fill, the longer the hold has to be to earn it back.
When it pays back
A pair starts below zero by its cost. Funding is not paid by the minute: it arrives at each venue's payment time, to whoever holds the position then. So the pair climbs in steps, and it has paid back at the first payment that takes it above zero.
- "Pays back" in the table
- The number of payments of the slower leg that cover the cost at the rate right now, and the wait until the last of them. With Mixed costs the same pair needs 23 payments, with Taker 43.
- Why not "break even in 0.7 h"
- Dividing the cost by the hourly rate gives a time that no venue pays on. If you close before the payment time you collect nothing and still pay the four fills.
- It assumes
- That the rate stays where it is until then. It often does not, which is what the next two parts are for.
Net APR: the carry minus the cost, over the time you hold
- Net APR
- The 3.0 bp round trip, as a share of 35.0 % gross
- Which rate
- The table ranks and shows net APR on the pair's average carry of the last 7 days, not on this hour's rate. One hour's spike does not lead the list.
- "now" under a number
- Shown when this hour's rate is more than twice the 7 day average: the pair is in a spike that may not last.
- APR, not APY
- No compounding, and no price result. It is a rate on the position size, and with leverage the margin you post is smaller than the position.
How past holds ended
A rate can fall or flip the hour after you enter. So for every pair we replay its history: for each past hour when you could have entered, we add up the funding over the next 24 hours, 7 days or 30 days and take the cost away.
How a pair runs here
"Launch pair" starts two maker bots, one on each venue. The long leg leans long and the short leg leans short. Both keep quoting on both sides, so a pair also makes maker volume while it collects the carry.
What can go wrong
- The rate changes
- The carry can shrink or turn negative. Then the pair pays instead of earning, and closing early still costs the four fills.
- The legs are on two venues
- Each leg has its own margin. A fast move can stop out or liquidate one leg while the other stays open, and then you hold a plain long or short.
- Prices differ between venues
- The two markets do not trade at the same price at every moment. The gap can widen while you hold.
- Payment times differ
- One leg can pay every hour and the other every 8 hours. Between the two you have paid on one side and not yet received on the other.
- Reference rows
- A row marked "reference" uses a large exchange's rate for comparison only. It cannot be launched here.
Fees
Two parties can charge a fee on a fill, and the app always shows them apart.
- Where you see it
- In the window where you connect an account, on the launch button as part of the cost per $1M, and on every bot's page as fees paid.
- Hyperliquid
- Many stock, index and commodity markets on TradeXYZ, Entropy and Paragon have a far lower maker fee than the core markets: 0.29 bp against 1.5 bp.
Keys and safety
You connect a venue with a key made for trading. On Hyperliquid it is an API wallet, which signs orders and has no right to move funds.
- Your limit
- Every bot has a max loss in dollars, set by you before launch.
- One bot per market
- One account runs one bot on a market at a time, so two bots never trade against each other's orders.
- Legal
- The Terms and the Risk disclosure are part of using the service.
Venues
One Hyperliquid key also trades the exchanges built on it. They are separate order books with their own markets and fees, and the app lists them under their own names.
- Hyperliquid
- The core markets, and with the same key TradeXYZ, Entropy and Paragon: stocks, indices, commodities and FX as perps. Funding is paid every hour.
- Hibachi
- Funding is paid every hour.
- RISEx
- Funding is paid every hour.
- Extended
- Funding is paid every hour.
- Paradex
- Funding accrues continuously while the position is open.
- GRVT
- Funding is paid every 1, 4 or 8 hours, by market, to whoever holds the position at that time.
- TxFlow
- Waiting for its mainnet.
Words
- bp
- Basis point: 0.01 %. On $1M, 1 bp is $100.
- Maker, taker
- A maker order waits in the book for someone to trade against it. A taker order trades against a waiting order at once and pays more.
- Spread
- The gap between the best buy price and the best sell price.
- Post-only
- An order that is refused if it would trade at once. It can only be a maker order.
- Position, exposure
- What the bot holds after a fill, and its size as a share of what the capital allows.
- Markout
- Where the price went after your fill. If it went against you, the fill was a bad one. It is the part of the cost that is not fees.
- Funding, carry
- The payment between longs and shorts on a perp, and the difference between two venues' rates that a pair collects.
- Open interest
- The total size of open positions on a market. A pair is only as large as the smaller leg's market can take.
- Round trip
- Opening and closing. For one market two fills, for a pair four.
See the numbers on live markets.
Open Markout