Skip to main content

Backpack Securities on Solana, and buy quotes ranked by where your money is

Backpack Securities tokenized stocks now trade as a third stock protocol on Solana, beside ondo and xstocks. Buy quotes and previews also take an optional origin_chain, which ranks the legs for money held on one chain. Both are additive on the request; strict response parsers have one thing to check.

What changed​

Backpack Securities (protocol: "backpack")

  • POST /quote/buy, POST /quote/sell and POST /quote/preview accept protocol: "backpack", alone or in a protocol array (arrays now take one to six values). It is Solana only: it pairs with chain: "sol", and there is no Ethereum cell.
  • It is co-ranked, not opt-in. An unpinned Solana buy ranks a listed backpack cell against ondo and xstocks, and an unpinned sell fills from a held Backpack position like any other.
  • GET /stocks and GET /stocks/tickers gain an optional backpack listing block, the same shape as ondo and xstocks, with eth_address always null. The key is absent, not null, while the venue is switched off, and a cell is listed only once its token has supply. GET /stocks/{ticker} lists a backpack entry in listings[] on the same terms. GET /stocks/prices carries no onchain.backpack: compare a Backpack leg against tradfi.
  • A buy pinned to a backpack cell that is not listed is 422 no_routes. Sells are never gated this way.
  • Backpack positions report the plain stock symbol as token_ticker ("MU", no suffix) on GET /portfolio, GET /trades and GET /settlements, with protocol: "backpack" and chain: "sol".
  • Under priority: "speed", sol/backpack is reachable as a cross-chain buy, and a held Backpack position sells cross-chain with payout_chain.
  • The GET /settlements filters now list every value: chain adds arbitrum, and protocol adds reality and backpack.

origin_chain on buy quotes and previews

  • POST /quote/buy and POST /quote/preview accept origin_chain ("sol", "eth", "robinhood" or "base"), the chain your stablecoin sits on. Omit it and nothing changes.
  • On the default route it changes the ranking only. Every leg on another chain ranks as if it also paid the measured cost of moving the money there, so quotes[0] is the cheapest leg for money held on that chain. No leg is added, dropped or repriced, and a leg on another chain is still a same-chain leg: fund that chain before you submit it.
  • Under priority: "speed" it is the only chain a cross-chain leg may spend from, so the leg's origin_chain always equals the value you sent. /quote/preview prices as if the whole amount sits there (sol when you omit it, as before).
  • New refusal: 400 invalid_request when /quote/buy names an origin_chain whose wallet the request does not carry (sol_wallet for sol, eth_wallet otherwise). /quote/sell rejects the field as unknown.

What to do​

Action (strict response parsers only): backpack can appear as a protocol on response rows for any wallet that holds the tokens, whatever you send. Treat chain and protocol as open vocabularies and never fail a parse on an unlisted value. Branch on protocol and chain, not on the shape of token_ticker.

Action (only if you depend on today's Solana routing): an unpinned Solana buy can now route to a Backpack cell. To keep the old routing, send protocol as an array of the protocols you want.

Nothing else is required. To use the new fields, update to skill 1.17.0 (and the wallet skill to 1.4.0) from Agent Skills, or read the API Reference. The routing rules are in Routing and Priority Mode, and every combination of options is mapped in Buying and Selling.