The sells and buys that bring your strategy positions to its book, each with its signable quote
/signals-orders /rebalanceThe same orders as POST /signals-orders/rebalance/plan, each carrying quote: exactly the
POST /quote/sell or POST /quote/buy answer for that order, signable payloads included.
Sign and submit each quote through POST /trade/submit unchanged. The two-round funding
flow is the plan route's: in round 1, submit the sells; once they settle, call again with
amount_usdc set to the smaller of funding.next_amount_usdc and usdc_available
(omitted when that is zero) for the buys.
Without amount_usdc the book's cash weight is sold on every call, and a buy-in from cash
is amount_usdc on a wallet holding none of the names; see
POST /signals-orders/rebalance/plan. To submit several quotes in one request, send them
together through POST /trade/submit/batch.
One call at a time per wallet and strategy. While a quote from an earlier /rebalance
for the same wallet and strategy is neither final (GET /quote/{quote_id}/status) nor
five minutes past its expires_at, a new call is refused with 409 orders_in_flight
naming those quote_ids (an empty list while the earlier call is still quoting), with
Retry-After in seconds, so a retry never mints the same sells twice.
A submitted quote counts as final once its status has been read as final, so poll every quote you submit. The plan route is never refused this way: wait for every order there yourself.
One wallet per strategy. Your holdings are not tracked per strategy: every name of the book you hold in this wallet counts, whichever strategy (or none) you bought it for. Two strategies sharing a name in one wallet will sell or resize each other's position, so give each strategy its own wallet.
For programmatic signers only. A Solana leg is signable for about 45 s after this
response. Each quote's own expires_at binds; the top-level expires_at is the earliest
of them and signing_window_sec is the seconds left until it. Human and hardware-wallet
flows should call POST /signals-orders/rebalance/plan, then quote each order when ready.
A partial result is normal: an order whose quote is refused is moved to skipped with the
error code its quote route would have answered (for example no_routes, also what a buy
the wallet cannot fund at quote time answers), and the response is still 200. A buy
skipped here is counted in funding.buys_deferred_usdc and spends nothing from
funding.next_amount_usdc; a sell skipped here adds nothing to it, so the next call never
spends USDC that no sell freed.
When no sell is quoted, a buy the plan held as awaiting_sell_proceeds is skipped as
insufficient_balance instead, since no proceeds are coming. An order whose quote expired
before the response was sent is skipped as quote_stale.
max_slippage_bps is required here and applies to every leg.
Limits count upstream quote calls, from the same buckets as POST /signals-orders/exit: a
sell held on one Solana venue costs 1 point, on two 3, on three 6; a buy costs at most 1
point per Solana venue it can buy on. The plan never costs more than 30 points (orders past
that are skipped as leg_cap), so it always fits an empty per-integrator bucket; a plan
costing more than the points left this minute is refused whole with 429 before any order
is quoted. A 429 from the shared bucket does not spend your own points.
Requires your general (tik_) key; a reporting key is refused.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 503
OK
Invalid request body (including eth_wallet, protocol, amount_usdc: "0" or a missing max_slippage_bps), or slippage out of range.
Missing, malformed or unknown X-API-Key, or an ownership-proof failure.
address_blocked (sanctions screening flagged the wallet), or insufficient_scope, key_revoked or integrator_suspended.
No such strategy for you (see GET /signals/strategies/{id}).
-
book_changed:expected_book_hashis not the book served now; the wallet was not read and nothing was quoted. -
orders_in_flight: a quote from an earlier call for the same wallet and strategy is neither final nor five minutes past itsexpires_at(quote_ids; empty while that call is still quoting). Nothing was quoted; pollGET /quote/{quote_id}/statusfor the quotes you submitted, and call again afterRetry-Afterseconds or once each is final.A quote you never submitted has no status to poll:
Retry-Afteris how long until the earliest listed quote is five minutes past itsexpires_at(60 while the earlier call is still quoting). If an earlier call's response was lost, its quotes hold the wallet and strategy until the latest one'sexpires_atplus five minutes: wait outRetry-After, or submit the quotes you do hold.
Response Headers
Delta-seconds, sent with orders_in_flight only: until the earliest listed quote is five minutes past its expires_at (at least 1), or 60 while the earlier call is still quoting. Other listed quotes may still hold after it, and the next call says so.
As on POST /signals-orders/rebalance/plan, including strategy_halted; nothing is quoted.
Sliding window exceeded: per-IP or per-(IP, wallet), plus a per-organisation bucket (shared across all of your keys) whenever a valid X-API-Key is presented. Retry-After header carries delta-seconds.
Transient; retry.
screening_unavailableorintegrator_fee_misconfigured(seePOST /quote/sell)balance_unavailable: the wallet's Solana USDC could not be read, and is never reported as zeroholdings_unavailable: the wallet's holdings could not be read.
When the reads behind the plan (screening, the strategy and its book, holdings, prices and
USDC) did not answer within 15 seconds, the call answers holdings_unavailable, or
screening_unavailable when screening was the read still pending, with Retry-After: 15.
Response Headers
Delta-seconds, 15, sent when the reads passed their deadline. Wait that long before retrying.