Skip to main content

The sells that exit a strategy book from your wallet, with no quotes

POST/signals-orders/exit/plan

Returns 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​

OK