Show docs pages

Chase

Chase works your order passively, keeping one limit order at or near the best price on your side and moving it with the book until it fills.

This page covers how Chase prices and sizes its orders, each field in the ticket, how a Chase order ends, what you can change while it runs, and what it does when something goes wrong.

What Chase does

Chase works your quantity as a resting limit order on your side of the book. It moves that order as the market moves, until your quantity fills, you cancel it, or it expires.

Chase never prices an order across the spread. It is the algo the ticket opens on.

How it works

Pricing

Each time the book changes, Chase works out where its order should rest:

  • Chase distance at 0 (the default): when the spread is wider than one tick, a buy bids one tick above the best bid and a sell offers one tick below the best ask. When the spread is one tick, it joins the best bid or ask.
  • Chase distance above 0: the order rests that many basis points behind the best price on your side.
  • Limit price, when you set one, caps the result. A buy never rests above it and a sell never rests below it.

Holding its place

Your own order is part of the public book. When your order is alone at the best price, or it set that price, Chase leaves it there. When others are queued ahead of it at that price, Chase improves on them by a tick, as long as the spread is wider than one tick.

Sizing

Chase keeps one order resting at a time. It sizes that order from the size showing on your side of the book, so a large quantity goes out in parts.

If that size is below the exchange's minimum, Chase sends a minimum-size order. If an order would leave a remainder below the exchange's minimum, Chase sends the whole remainder instead.

On OKX and Bybit, no order is larger than the largest single order the exchange takes on the market: by quantity or by value on OKX, by quantity on Bybit. The rest goes out in later orders.

Sizing to your balance

On spot markets, Chase keeps each order within what your available balance can pay for, which avoids most rejections for insufficient balance:

  • A buy is no larger than your available quote currency buys at the order's price. On Coinbase, which holds the fee with the order, it leaves room for the fee at your account's rate.
  • A sell is no larger than your available base asset.

Your available balance already excludes what your open orders hold. When Chase amends its resting order, it counts what that order holds as available, so the amended order can be smaller than before.

On an OKX or Bybit perpetual, Chase keeps each order within your margin: the ticket's Max for the order's side (How Max is worked out) at the order's price, less what your other open orders on that market and side already take. An order priced through the mid leaves room for what it would lose against the mid. With Reduce only on, the order isn't limited this way.

Chase never waits for a balance. When Aura has no balance for the account yet (on a perpetual, no leverage for the market), or your balance pays for less than the exchange's minimum order, the order goes out at its usual size and the exchange decides.

Requotes and fills

When the price Chase wants changes, it requotes. On every OKX and Bybit market and on Kraken and Coinbase spot, Aura amends the resting order in place. On Coinbase futures, it cancels the order and places a new one.

Each fill reduces what is left, and Chase keeps working the rest.

Quantity in the quote currency

On spot, perpetual and futures markets, but not inverse perpetuals, click the unit beside Quantity to switch between the base and quote currency. In the quote currency, the quantity is a budget, and Chase converts what is left of it to the base asset as it works.

Parameters

ParameterWhat it doesDefault and limits
QuantityHow much to buy or sell, in the unit shown beside it.Required. Must meet the exchange's minimum size and be a whole number of lots. Some markets also have a minimum order value.
Chase distanceHow far behind the best price on your side the order rests, in basis points. At 0, Chase prices from the spread as described above.Default 0. Whole numbers from 0 to 9999.
Limit priceAn optional cap on every price Chase quotes.Default none. Leave it blank for no cap.
Post onlyEvery order is maker-only. The exchange rejects or cancels an order that would take liquidity, and Chase reprices it.Default off.
Reduce onlyThe exchange uses the order only to reduce your current net position and cancels any remainder it cannot use.Default off. Shown on perpetual markets only.
StartsNow sends the order on submit. At holds it as scheduled and starts it at the time you pick.Default Now. At offers 15 minutes ahead. At most 365 days out.
ExpiresNever is good till cancelled. At cancels whatever is left at that time and closes the order as Expired.Default Never. At offers 1 hour ahead. At most 365 days out, and after the start.

Below the submit button, Est. fee uses the maker rate when Post only is on and a maker-to-taker range when it is off. For more on the ticket, see Placing an order.

While it runs

The status chip in Open Orders tells you what Chase is doing. Hover new, working or waiting for a short explanation.

StatusMeaning
scheduledWaiting for its Starts time.
newAccepted, not working yet.
workingAn order is working at the exchange.
waitingWaiting for market data.
amendingApplying your changes.
expiringCancelling what is left at its Expires time.
cancellingCancelling at your request.

In the order sheet, a note beside the limit price says where the best price on your side sits against your limit, for example Bid at the limit or Bid 7.2 bps above. It turns amber once the market is past your limit.

How it ends

The status chip shows the outcome: filled, cancelled or part. cancelled. It reads rejected only for an order above your Max USD notional or one that never reached the exchange because the account had no connection. When the order ended for a reason other than a fill or a cancel, the order sheet shows the reason in a red box at the top, whatever the status.

ReasonWhat happened
FilledThe whole quantity filled. With a quote-currency quantity, also when what is left of the budget is too small for one order the exchange accepts. Hover the status to see the unspent amount.
CancelledYou cancelled the order.
ExpiredThe order reached its Expires time.
Remainder below the exchange's minimum sizeWhat is left is smaller than the exchange's minimum order size.
Remainder below the exchange's minimum order valueWhat is left is worth less than the exchange's minimum order value.
Stopped after repeated rejectionsThe exchange rejected 5 orders in a row, with none accepted or filled in between. Rejections for the exchange's rate limit don't count.
Rejected by the exchangeThe exchange rejected an order for a reason that sending again cannot fix. The red box names the reason, such as Size not accepted, with the exchange's own words.
Position already closedA reduce-only order found no position left to reduce.
Cancelled by the exchange for marginThe exchange's risk or margin controls cancelled an order.
Order could not be sentThe account's current settings cannot carry this order.
Above your Max USD notionalThe order is larger than your max USD notional. See Settings.
Amended order was refusedAura accepted an amend, but the order with its new values failed Aura's checks.
Exchange account disconnectedThe account had lost its connection, or the exchange had refused its API key, before the order reached the exchange. See Connection status.
Exchange account could not connectAura could not connect the account to send the order.
Closed when the paper account was restoredYou reset a paper account whose saved state Aura couldn't restore.

Amending

Open the order and click Amend, or click the pencil on its row in Open Orders. The Order column turns into fields where it stands. Fields you can change are editable; the rest are dimmed.

FieldNotes
QuantityMust stay above what has already filled.
Chase distanceWhole basis points, under 10000.
Post onlyOn or off.
Reduce onlyPerpetual markets only. Applies to orders placed after the amendment.
Limit priceLeave it empty to remove the limit.
ExpiresUnchanged, At a time, or No expiry (GTC). On an order with no expiry, the choices are No expiry (GTC) and At a time.
StartsOnly while the order is scheduled: Unchanged, At a time, or Start now.

Each changed field shows a teal dot and its old value, such as "was 5 bps", and only changed fields are sent. Click Apply (it reads, for example, Apply 2 changes), or Discard to leave without sending anything.

Aura cancels the resting order, waits for it to finish, and checks the new values the way it checks a new order, including your max USD notional. Chase then starts again from the current book. The status reads amending meanwhile. If you cancel during an amend, the cancel wins.

What can go wrong

SituationWhat Chase does
No book, or no trading rules for the marketPlaces nothing. It shows waiting until the book arrives, and new while it waits for the trading rules. It starts when both arrive.
The book stops updatingKeeps working from the last book Aura received. A quiet book is not treated as stale.
The exchange refuses a price, for example a Post only order that would takeReprices from the current book and sends again. This does not count as a rejection.
Insufficient balanceRetries at half the refused size, never below the exchange's minimum, and keeps later orders at that size until one fills. After 5 rejections in a row it stops with Stopped after repeated rejections.
The exchange rate-limits youWaits out the exchange's window, 2 seconds on OKX and 1 second on Coinbase, Kraken and Bybit, then sends again, as many times as it takes. A rate limit never counts as a rejection and never ends the order. If the exchange won't move a resting order for its rate limit, the order stays where it is until the wait is over.
The exchange is unavailable, has too many open orders, or gives no clear reasonWaits for the next book update or exchange event, then tries again. These count toward the 5-in-a-row limit.
A rejection that sending again cannot fix, such as Size not accepted, Market unavailable, API key refused or Position limit reachedStops with Rejected by the exchange.
What is left falls below the exchange's minimumEnds with one of the two Remainder below… reasons.
A quote-currency budget is too small for one more orderEnds Filled if anything filled, with the unspent amount in the status hover. If nothing filled, it ends Cancelled with the remainder reason.
The exchange does not confirm an orderThe status reads unconfirmed, and Chase places nothing beside that order until it is settled. See Managing orders.
You amend while the market's trading rules are unavailableAura refuses the amend and the order keeps waiting. Try again once the market is back.

If your exchange account disconnects, see Connection status. To compare Chase with the other algos, see Choosing an algo.