Chains and Venues
Every chain Treasures trades on has its own rules: which stablecoin it trades in, who pays the gas, what the wallet has to approve and to which address, and which quote options it accepts. A quote can mix chains, so an integration that handles one chain correctly can still fail on the next leg it receives. This page puts those rules in one place. Read the row for each chain your users trade on before you build for it.
For how the quote options combine, see Buying and Selling. For how routes are ranked and what priority mode changes, see Routing and Priority Mode.
At a glance
chain | Network | Issuers (protocol) | Trades in | Open |
|---|---|---|---|---|
sol | Solana | ondo, xstocks, backpack | USDC on Solana | Yes |
eth | Ethereum mainnet | ondo, xstocks | USDC on Ethereum | Yes |
robinhood | Robinhood Chain (4663) | robinhood | USDG, not USDC | Yes |
base | Base (8453) | coinbase | Base-native USDC | Yes, per ticker once minted |
arbitrum | Arbitrum One (42161) | reality | Arbitrum-native USDC | Yes, per ticker once minted |
bnb | BNB Smart Chain (56) | ondo, xstocks, bstocks | Binance-Peg USDC (18 decimals) | Yes for ondo and xstocks; bstocks not yet |
Which tickers trade where changes over time. GET /stocks/tickers is the authority: read available_chains and each issuer's listing block at runtime rather than hardcoding a list.
Who pays gas, and what you sign
chain | Default leg: you sign | Who pays the trade's gas | Native gas the wallet still needs |
|---|---|---|---|
sol | A Solana transaction | The wallet in SOL, a market maker, or your sol_fee_payer | SOL for fees and new token accounts. With sol_fee_payer, only for a first buy of an ondo token and for bridges or cross-chain legs leaving Solana |
eth | A gasless order (EIP-712 typed data) | Nobody on your side | ETH, for the one-time approvals |
robinhood | A gasless order | Nobody on your side | ETH on Robinhood Chain, for the one-time approvals |
base | A gasless order | Nobody on your side | ETH on Base, for the one-time approvals |
arbitrum | A gasless order | Nobody on your side | ETH on Arbitrum, for the one-time approvals |
bnb | A gasless order (ondo, xstocks) | Nobody on your side | BNB, for the one-time approvals |
"Gasless" covers the trade itself. On every EVM chain the wallet sends its own one-time ERC-20 approval first, and that transaction costs that chain's native gas. Under priority: "speed" the Robinhood Chain and Base legs stop being gasless: the wallet pays each swap's gas too, unless your paymaster sponsors it with execution: "user_operation".
Which options each chain takes
chain | priority: "speed" | Cross-chain buy into it (speed only) | origin_chain | payout_chain | Reached by /bridge/quote |
|---|---|---|---|---|---|
sol | Unchanged: the normal swap | xstocks and backpack, never ondo | Yes | Yes | Yes |
eth | Never on its own route | ondo only, never xstocks | Yes | Yes | Yes |
robinhood | Speed swap, only with USDG already on Robinhood Chain | Never | Yes | No | Yes, arriving as USDG |
base | Speed swap | coinbase, on an unpinned or multi-chain request only | Yes | Yes | Yes |
arbitrum | Never (400 invalid_request when pinned) | Never | No | No | Yes |
bnb | bstocks only, the same transaction it uses at every priority; never ondo or xstocks | bstocks | No | No | Yes; delivery: "submit" not yet |
execution: "user_operation" (your paymaster pays) applies only to the Robinhood Chain and Base speed swaps and to cross-chain legs leaving an EVM chain.
Records and reads
chain | Trade made outside Treasures appears in /trades | Positions read by /portfolio |
|---|---|---|
sol, eth | Yes, as an external balance-change row (no price), recorded on the next /trades or /portfolio read | For the wallets you send |
robinhood, base, arbitrum, bnb | No. Only trades submitted through Treasures are recorded, with their cost basis | For any wallet when you send your integrator key; without it, only for wallets Treasures already knows |
Solana (sol)
- Three issuers, ranked against each other.
ondo,xstocksandbackpack(Backpack Securities, Solana only). Backpack tokens report a baretoken_ticker(MU, no suffix), so branch onprotocolandchain, never on the symbol's shape. - No approvals. Solana has no allowances.
- SOL is the gas you cannot skip by default. Every Solana transaction pays a network fee, and a first buy of a token opens its token account (roughly 0.0016 to 0.0021 SOL of rent, which stays with the wallet). A wallet short of SOL is refused at quote time with
422 no_routesandreason: "insufficient_gas": under 0.01 SOL when the trade opens a token account, under 0.002 SOL otherwise. A wallet just above 0.002 SOL can still be refused, asno_market_maker_fill, so keep about 0.01 SOL in a wallet buying a token it does not hold yet and a little over 0.003 SOL otherwise. - A market maker pays its own fee, but not the token account. Every
ondoleg on Solana is filled by a market maker, and so are somexstocksandbackpacklegs depending on size; the maker pays the network fee. A first buy of a token still opens the wallet's token account at the wallet's own cost. On anondoleg that means the wallet needs about 0.01 SOL, or theondoleg is dropped, andsol_fee_payercannot pay it. Other legs fill against an on-chain pool and pay the network fee from the wallet's SOL. - To pay the fees for your users, send
sol_fee_payeron every buy and sell quote: one fixed Solana address you fund.- A leg it pays for echoes it, reads
gasless: falsewithestimated_gas_usd, and must be signed as issued by both yoursol_fee_payerand the user's wallet. - It covers only the quote it rides on, so a wallet still short of SOL needs it again on the sell.
- It never pays for an
ondoleg (above), and it covers same-chain legs only: a bridge or cross-chain leg leaving Solana still spends the wallet's SOL. - Once you send it, a pool-filled leg is only ever the sponsored one, so a sponsor that cannot cover the fees and rent fails the leg even when the user's wallet could have paid.
- Details: Paying Solana fees for your users.
- A leg it pays for echoes it, reads
- Check the USDC balance before quoting. There is no general balance check. A market maker may refuse a Solana quote for a wallet short of USDC (
422 no_routeswithreason: "insufficient_balance"), but a Solana leg that still reaches/trade/submitshort of the token it spends is sent and fails asnot_landed. On the default route of the EVM chains an underfunded buy still gets a quote. - Minimums bear on the exit. A market maker that declines a small buy usually declines a small sell too, so a Solana position worth less than its minimum may not be sellable there until topped up: avoid partial sells that leave less than the minimum behind.
- Fast. A Solana leg is usually final when
/trade/submitreturns. Onbroadcast_unknown, poll; do not resubmit. A failed leg reportsmarket_maker_rejectedornot_landedand keeps the reported signature ontx_hash(what to do). - Under
priority: "speed"a buy's Solana leg the wallet cannot fund is dropped; otherwise Solana legs are unchanged. Anxstocksorbackpacklisting the wallet is not funded for on Solana can come back as a cross-chain leg paid from another chain.
Ethereum (eth)
- Two issuers, two token addresses.
ondoandxstockseach have their own token for the same ticker, and a sell can fill from both. - Gasless orders. You sign an EIP-712 order and a settlement network fills and broadcasts it. A fill can take minutes: poll status (
order_hashwhile it is live, thentx_hash). An order still unresolved after an hour ends asstatus_check_exhausted. - Approve before the first trade. USDC to buy, and each issuer's stock token to sell, to
0x111111125421ca6dc452d289314280a0f8842a65, sent with ETH. Before selling, approve every issuer's token the wallet holds for that ticker: a sell can draw on each of them, and the quote window is too short to send an approval in between. - An underfunded or unapproved buy still gets a quote. Treasures does not check the wallet's USDC on a default buy. The leg fails at submit (
broadcast_failed), or later asfailed, withnot_enough_balance_or_allowance, so check the balance and the allowance before quoting. - Not part of priority mode. Under
priority: "speed"Ethereum is never quoted on its own route; a buy can reacheth/ondoonly as a cross-chain leg, and a speed sell leaves Ethereum holdings out unless the sale pays out on another chain.
Robinhood Chain (robinhood)
- One issuer, Robinhood Stock Tokens (
protocol: "robinhood"), with bare tickers. - USDG only. A buy spends USDG and a sell pays out USDG. The leg says so with
base_asset: "usdg", and its_usdc-named amounts (amount_usdc,price_usdc_per_share,estimated_output_usdc) are in USDG. To get USDG onto the chain, bridge USDC from any other chain: the bridge converts it. - It is in unpinned quotes. A request without
chaincan return a Robinhood leg when it prices best, so checkbase_asseton every leg, not only when you asked for Robinhood. - Approvals go to a different address. The settlement contract on Robinhood Chain is
0x5A705DE8982235a7fa45bB83dCaCf03a211389C7, not the0x1111…0a65the other EVM chains use. Approve USDG (to buy) or the stock token (to sell) to it once, from the wallet, with a little ETH on Robinhood Chain. An approval to the wrong address leaves the order unfillable (not_enough_balance_or_allowance). - Listing is not liquidity. Many listed names have little or no settlement liquidity and return
422 no_routes. Readtradabilityandmin_trade_size_usdon therobinhoodlisting block before quoting. - Priority mode needs USDG already in the wallet.
- Under
priority: "speed"a Robinhood leg is a single on-chain swap that spends the wallet's own USDG and pays gas in its own ETH on Robinhood Chain (or your paymaster's, withexecution: "user_operation"). - The quote reads the USDG balance: if it is short, the leg is dropped with a
speed_route_unavailablewarning (reason: "insufficient_balance"), or the quote is422 no_routeswith that reason when you pinnedchain: "robinhood". - Robinhood Chain is never a cross-chain destination, so USDC elsewhere cannot fund a speed buy here: bridge to USDG first.
- A wallet with too little ETH for the swap fails at submit with
insufficient_native_gas. - The speed quote carries its own
approvewhen one is needed. - A speed sell the speed route cannot price is the exception: it comes back as a gasless order with a
speed_route_fallbackwarning, which needs the stock token approved to the settlement contract above.
- Under
- Never a payout chain. A sell with
payout_chainleaves Robinhood positions out. USDG on Robinhood Chain can fund a cross-chain speed buy elsewhere (origin_chain: "robinhood").
Base (base)
- One issuer, Coinbase B20 tokens (
protocol: "coinbase"), with bare tickers. - Base-native USDC (
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), a different token from Ethereum's USDC even though both readbase_asset: "usdc". - Listed per ticker once minted. A ticker without minted supply is missing from
available_chainsand a buy is422 no_routes. Sells are never gated: a holder can always exit. - Approvals of USDC (to buy) or the B20 token (to sell) to
0x111111125421ca6dc452d289314280a0f8842a65on Base, sent with a little ETH on Base. An Ethereum approval grants nothing here. - Priority mode. Under
priority: "speed"a Base leg is a single on-chain swap paid from the wallet's ETH on Base, or by your paymaster withexecution: "user_operation". A pinned speed buy needs USDC on Base; on an unpinned or multi-chain request, a wallet not funded on Base can be served a cross-chain leg instead. A speed sell the speed route cannot price comes back as a gasless order with aspeed_route_fallbackwarning, which needs the approval above. - A payout chain. A sell can pay its USDC out on Base with
payout_chain: "base".
Arbitrum (arbitrum)
- One issuer, Reality tokenized stocks (
protocol: "reality"). - Arbitrum-native USDC (
0xaf88d065e77c8cC2239327C5EDb3A432268e5831). - Listed per ticker once minted, like Base.
- Buys follow the market week. Outside Sunday 20:00 to Friday 20:00 ET, and on US market holidays, a buy pinned to
arbitrumis422 no_routeswithreason: "market_closed", and an unpinned buy comes back without anarbitrumleg. Treasures does not gate sells on the clock. - Approvals of USDC (to buy) or the stock token (to sell) to
0x111111125421ca6dc452d289314280a0f8842a65on Arbitrum, sent with a little ETH on Arbitrum. - The gasless route only. No speed route (a speed request pinned to
arbitrumis400 invalid_request), no cross-chain leg into it, and neitherorigin_chainnorpayout_chaintakes it. Fund it with a bridge. - No on-chain price on
/stocks/prices: compare a leg against thetradfiprice instead.
BNB Smart Chain (bnb)
Three issuers list on one chain, so read each leg's protocol; which of them are open is in At a glance. It trades in an 18-decimal Binance-Peg USDC that is not interchangeable with USDC anywhere else: bridge into it. While an issuer here is switched off for you its listings stay hidden and a buy there is 422 no_routes, but positions you already hold stay sellable. Its legs come in two kinds:
ondoandxstocks: gasless orders like Ethereum's, with a signing window of about 14 seconds per leg and one-time approvals paid in BNB rather than ETH.bstocks: a complete transaction at every priority (with its ownapprovewhen one is due), about 40 seconds to sign, its gas paid from the wallet's BNB. It is the onebnbcell served underpriority: "speed", and a cross-chain speed buy can reach it.
Neither origin_chain nor payout_chain takes bnb.
The strategy signals plan routes take chain: "bnb" for ondo and xstocks positions, and report in approvals which of the approvals below the wallet is missing.
Approvals by chain
Allowances are per chain: an approval on one chain grants nothing on another, even where the spender address is the same.
chain | To buy, approve | To sell, approve | Spender | Paid in |
|---|---|---|---|---|
sol | Nothing | Nothing | n/a | n/a |
eth | USDC 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 | Each issuer's stock token | 0x111111125421ca6dc452d289314280a0f8842a65 | ETH |
robinhood | USDG 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168 | The stock token | 0x5A705DE8982235a7fa45bB83dCaCf03a211389C7 | ETH on Robinhood Chain |
base | USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | The B20 token | 0x111111125421ca6dc452d289314280a0f8842a65 | ETH on Base |
arbitrum | USDC 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 | The stock token | 0x111111125421ca6dc452d289314280a0f8842a65 | ETH on Arbitrum |
bnb | Binance-Peg USDC 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d | Each issuer's stock token | 0x111111125421ca6dc452d289314280a0f8842a65 | BNB |
These cover the default gasless route. A speed swap's quote carries its own unlimited approve to the router named in its payload when the wallet needs one, and a cross-chain leg's quote carries an exact-amount approve: sign whatever the quote issues, in order. A bridge that you broadcast yourself names its spender in the bridge quote's approval_spender.
Funding each chain
chain | To buy, hold | To sell, hold | Native float to keep |
|---|---|---|---|
sol | USDC on Solana | The stock token | At least 0.02 SOL. With sol_fee_payer, about 0.01 SOL for first ondo buys, bridges and cross-chain legs leaving Solana |
eth | USDC on Ethereum | The stock token | About 0.01 ETH, for approvals and self-broadcast bridges |
robinhood | USDG | The stock token | A little ETH on Robinhood Chain, for approvals; more for speed swaps |
base | USDC on Base | The B20 token | About 0.001 ETH on Base, for approvals; more for speed swaps |
arbitrum | USDC on Arbitrum | The stock token | A little ETH on Arbitrum, for approvals |
bnb | Binance-Peg USDC on BNB Smart Chain | The stock token | About 0.001 BNB, for approvals and each bstocks trade |
POST /bridge/quote moves stablecoin between any two of these chains. With delivery: "submit" from Ethereum, Base or Arbitrum, the bridge needs no native gas on the way out.
The stablecoins are different tokens on every chain. GET /portfolio reports them separately (usdc.sol, usdc.eth, usdc.base, usdc.arbitrum, usdc.bnb, and USDG under usdg.robinhood); never add them together as one spendable balance.
Sessions and minimums
- Sessions. Treasures gates buys on the clock, not sells.
ondolistings follow the issuer's own per-ticker sessions.- Arbitrum and the
xstockslistings outside Solana follow the continuous week, Sunday 20:00 ET to Friday 20:00 ET, closed on US market holidays. xstockson Solana,backpack,robinhood,coinbaseandbstocksare not gated on the clock, though their liquidity can thin outside market hours (watchtradability).- A buy outside its session is
422 no_routeswithreason: "market_closed"when pinned, and loses that leg when not. A session can close on one chain while another still serves the ticker, so retry unpinned, or on another chain fromavailable_chains, before waiting.
- Minimums.
min_trade_size_usdis the smallest size measured to fill: on the ticker, on the single-chain listing blocks, and per chain on theondo,xstocksandbackpackblocks (sol_min_trade_size_usd,eth_min_trade_size_usd,bnb_min_trade_size_usd).- The Solana figure is firm: where a market maker fills the listing, it comes from a quote bound to a wallet. With none listed, assume $3.
- An order refused below a known floor carries
min_notional_usdc, which on Solana can be the size a market maker quoted your wallet at refusal time; on a sell it is a USDC value, never a share count. It describes only the venues that refused for size: a venue that refused for another reason still needs its own fix. - Cross-chain legs have no floor, but a small order pays proportionally more for the hop.
- Advisories.
tradabilityandwarn_reason(per chain on theondo,xstocksandbackpackblocks, such assol_tradability), and the same two fields on each quote leg, flag a thin or untradable venue before you quote. An absenttradabilitymeans unmeasured or unwarned, not healthy. - Signing windows. Each leg carries its own
expires_at: typically under a minute, about 40 seconds on a speed swap, and about 14 seconds on a BNB Smart Chainondoorxstocksleg. Sign and submit inside it.
Mistakes integrators hit most
- A Solana wallet with no SOL. Its quotes are refused with
422 no_routesandreason: "insufficient_gas". Sendsol_fee_payeron buys and sells, or fund the wallet with SOL. A first buy of anondotoken needs about 0.01 SOL in the wallet either way. - Approving the wrong address on Robinhood Chain. Its spender is
0x5A70…89C7, not the0x1111…0a65used everywhere else. - Treating USDG as USDC, or adding the stablecoins of different chains together. Read
base_assetandchainon every leg. - Asking for priority mode on Robinhood Chain without USDG there. The leg is dropped for
insufficient_balance, and no cross-chain route can fill it. Bridge to USDG first, and keep ETH on Robinhood Chain for the gas. - Expecting an underfunded EVM buy to fail at quote time. On the default route it fails at submit. Check the stablecoin balance and the allowance first.
- Approving only one issuer's token before an Ethereum sell. A sell can draw on every issuer's token the wallet holds.
- Hardcoding where a ticker trades. Base and Arbitrum list a ticker only once it is minted, Robinhood Chain names can be listed with no liquidity, and venues switch on per ticker. Read
/stocks/tickersat runtime. - Expecting outside activity on Robinhood Chain, Base or Arbitrum to appear in
/trades. Only trades submitted through Treasures are recorded there. - Indexing legs by array position. Echo each leg's
quote_index; the values can skip.