The sells that exit a strategy book, each with its signable quote
/signals-orders /exitThe same orders as POST /signals-orders/exit/plan, each carrying quote: exactly the
POST /quote/sell answer for that order, signable payloads included. Sign and submit each
quote through POST /trade/submit unchanged.
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/exit/plan, then POST /quote/sell per order when
ready.
A partial result is normal: an order whose quote is refused is moved to skipped with
the error code POST /quote/sell would have answered (for example no_routes, which on
a sub-minimum leg carries no minimum, or holdings_insufficient), and the response is
still 200. 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. 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 /exit 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. 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.
Limits on this route count upstream quote calls, not requests: an order held on one Solana venue costs 1 point, on two venues 3, on three 6 (each pass re-quotes the venues not yet filled). Points come from a per-integrator bucket (30 a minute) and from a bucket shared by every caller (90 a minute), charged only after the wallet is admitted and only when there is something to quote.
The plan never costs more than 30 points: orders past that are skipped as leg_cap, so an
exit of more than ten names held on two venues each exits the rest on the next call. A
plan costing more than the points left is refused whole with 429 before any order is
quoted. A 429 from the shared bucket can be another integrator's traffic and does not
spend your own points. The X-RateLimit-* headers describe the shared bucket.
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.
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, a missing max_slippage_bps or a protocol with no Solana protocol), 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.
book_unavailable: the strategy has no book yet.
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.