The sells that exit a strategy book from your wallet, with no quotes
/signals-orders /exit /planReturns one full-share sell per name your wallet holds in the strategy's current book (the
Solana wallet, or eth_wallet on BNB Smart Chain with chain: "bnb"), plus any tickers
you add. Nothing is quoted and nothing expires, so this is the default flow: show the
orders, then call POST /quote/sell per order when the signer is ready, and submit each
quote through POST /trade/submit unchanged. Human and hardware-wallet flows should use
this route; POST /signals-orders/exit is for programmatic signers.
With chain: "bnb" the plan reads eth_wallet on BNB Smart Chain; quote each order with
"chain": "bnb", "protocol" (see Quoting each order), eth_wallet and a fresh
eth_signature, and submit each on its own POST /trade/submit, never as a batch. Without chain: "bnb", a body carrying eth_wallet
is refused with 400 invalid_request.
strategy_id accepts the id or the slug; the response always carries the canonical id.
as_of is when Treasures ingested the book (unix seconds), not the filing date.
nav_usdc counts the priced names you hold in scope only. On Solana an unpriced holding is
still an order, with notional_usdc: null, ranked after the priced ones; with
chain: "bnb" it is skipped as price_unavailable, since its venue floor cannot be
checked. Shares are floored to 18 decimal places, never rounded up. A holding worth under
$0.01 reads as not held. A holding that could not be read is skipped as
holdings_unknown, never assumed absent, with one exception on Solana: a token account
found but not decodable into a balance reads as zero, so that name is not_held.
At most 25 orders are returned and, on Solana, their upstream quote calls are capped at 30
(see POST /signals-orders/exit; chain: "bnb" has no quote-call cap). The overflow (the
smallest by notional, unpriced first) is skipped as leg_cap, so
POST /signals-orders/exit answers the same split. With protocol sent, only the pinned
venues are read and sold: a name also held on another venue gets no skipped entry, so
repeat the call per venue.
Quoting each order. Send one POST /quote/sell per order, with the same wallet and a
fresh proof:
{ "ticker": <ticker>, "amount_shares": <shares>, "chain": "sol", "protocol": <the protocol you sent here, if any>, "sol_wallet": <sol_wallet>, "ownership_proof": <proof>, "max_slippage_bps": <bps> }.
To submit several Solana quotes in one request, send them together through
POST /trade/submit/batch.
With chain: "bnb", send "chain": "bnb" and eth_wallet instead, and always a
"protocol": the pin you sent here, or ["ondo","xstocks"] when you sent none. An unpinned
bnb quote can route to bStocks, which the plan never read.
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.
expected_book_hash, when sent, must equal the served book's book_hash, or the call is
refused with 409 book_changed before the wallet is read or anything is quoted: re-read the
book and decide again.
max_slippage_bps is optional here (nothing is quoted) and range-checked when sent.
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, 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_hash is not the book served now. The wallet was not read and nothing was quoted; re-read the book (book_hash is the served one) and decide again.
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.