Skip to main content

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​

chainNetworkIssuers (protocol)Trades inOpen
solSolanaondo, xstocks, backpackUSDC on SolanaYes
ethEthereum mainnetondo, xstocksUSDC on EthereumYes
robinhoodRobinhood Chain (4663)robinhoodUSDG, not USDCYes
baseBase (8453)coinbaseBase-native USDCYes, per ticker once minted
arbitrumArbitrum One (42161)realityArbitrum-native USDCYes, per ticker once minted
bnbBNB Smart Chain (56)ondo, xstocks, bstocksBinance-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​

chainDefault leg: you signWho pays the trade's gasNative gas the wallet still needs
solA Solana transactionThe wallet in SOL, a market maker, or your sol_fee_payerSOL 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
ethA gasless order (EIP-712 typed data)Nobody on your sideETH, for the one-time approvals
robinhoodA gasless orderNobody on your sideETH on Robinhood Chain, for the one-time approvals
baseA gasless orderNobody on your sideETH on Base, for the one-time approvals
arbitrumA gasless orderNobody on your sideETH on Arbitrum, for the one-time approvals
bnbA gasless order (ondo, xstocks)Nobody on your sideBNB, 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​

chainpriority: "speed"Cross-chain buy into it (speed only)origin_chainpayout_chainReached by /bridge/quote
solUnchanged: the normal swapxstocks and backpack, never ondoYesYesYes
ethNever on its own routeondo only, never xstocksYesYesYes
robinhoodSpeed swap, only with USDG already on Robinhood ChainNeverYesNoYes, arriving as USDG
baseSpeed swapcoinbase, on an unpinned or multi-chain request onlyYesYesYes
arbitrumNever (400 invalid_request when pinned)NeverNoNoYes
bnbbstocks only, the same transaction it uses at every priority; never ondo or xstocksbstocksNoNoYes; 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​

chainTrade made outside Treasures appears in /tradesPositions read by /portfolio
sol, ethYes, as an external balance-change row (no price), recorded on the next /trades or /portfolio readFor the wallets you send
robinhood, base, arbitrum, bnbNo. Only trades submitted through Treasures are recorded, with their cost basisFor 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, xstocks and backpack (Backpack Securities, Solana only). Backpack tokens report a bare token_ticker (MU, no suffix), so branch on protocol and chain, 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_routes and reason: "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, as no_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 ondo leg on Solana is filled by a market maker, and so are some xstocks and backpack legs 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 an ondo leg that means the wallet needs about 0.01 SOL, or the ondo leg is dropped, and sol_fee_payer cannot 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_payer on every buy and sell quote: one fixed Solana address you fund.
    • A leg it pays for echoes it, reads gasless: false with estimated_gas_usd, and must be signed as issued by both your sol_fee_payer and 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 ondo leg (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.
  • 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_routes with reason: "insufficient_balance"), but a Solana leg that still reaches /trade/submit short of the token it spends is sent and fails as not_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/submit returns. On broadcast_unknown, poll; do not resubmit. A failed leg reports market_maker_rejected or not_landed and keeps the reported signature on tx_hash (what to do).
  • Under priority: "speed" a buy's Solana leg the wallet cannot fund is dropped; otherwise Solana legs are unchanged. An xstocks or backpack listing 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. ondo and xstocks each 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_hash while it is live, then tx_hash). An order still unresolved after an hour ends as status_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 as failed, with not_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 reach eth/ondo only 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 chain can return a Robinhood leg when it prices best, so check base_asset on every leg, not only when you asked for Robinhood.
  • Approvals go to a different address. The settlement contract on Robinhood Chain is 0x5A705DE8982235a7fa45bB83dCaCf03a211389C7, not the 0x1111…0a65 the 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. Read tradability and min_trade_size_usd on the robinhood listing 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, with execution: "user_operation").
    • The quote reads the USDG balance: if it is short, the leg is dropped with a speed_route_unavailable warning (reason: "insufficient_balance"), or the quote is 422 no_routes with that reason when you pinned chain: "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 approve when 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_fallback warning, which needs the stock token approved to the settlement contract above.
  • Never a payout chain. A sell with payout_chain leaves 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 read base_asset: "usdc".
  • Listed per ticker once minted. A ticker without minted supply is missing from available_chains and a buy is 422 no_routes. Sells are never gated: a holder can always exit.
  • Approvals of USDC (to buy) or the B20 token (to sell) to 0x111111125421ca6dc452d289314280a0f8842a65 on 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 with execution: "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 a speed_route_fallback warning, 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 arbitrum is 422 no_routes with reason: "market_closed", and an unpinned buy comes back without an arbitrum leg. Treasures does not gate sells on the clock.
  • Approvals of USDC (to buy) or the stock token (to sell) to 0x111111125421ca6dc452d289314280a0f8842a65 on Arbitrum, sent with a little ETH on Arbitrum.
  • The gasless route only. No speed route (a speed request pinned to arbitrum is 400 invalid_request), no cross-chain leg into it, and neither origin_chain nor payout_chain takes it. Fund it with a bridge.
  • No on-chain price on /stocks/prices: compare a leg against the tradfi price 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:

  • ondo and xstocks: 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 own approve when one is due), about 40 seconds to sign, its gas paid from the wallet's BNB. It is the one bnb cell served under priority: "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.

chainTo buy, approveTo sell, approveSpenderPaid in
solNothingNothingn/an/a
ethUSDC 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48Each issuer's stock token0x111111125421ca6dc452d289314280a0f8842a65ETH
robinhoodUSDG 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168The stock token0x5A705DE8982235a7fa45bB83dCaCf03a211389C7ETH on Robinhood Chain
baseUSDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913The B20 token0x111111125421ca6dc452d289314280a0f8842a65ETH on Base
arbitrumUSDC 0xaf88d065e77c8cC2239327C5EDb3A432268e5831The stock token0x111111125421ca6dc452d289314280a0f8842a65ETH on Arbitrum
bnbBinance-Peg USDC 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580dEach issuer's stock token0x111111125421ca6dc452d289314280a0f8842a65BNB

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​

chainTo buy, holdTo sell, holdNative float to keep
solUSDC on SolanaThe stock tokenAt least 0.02 SOL. With sol_fee_payer, about 0.01 SOL for first ondo buys, bridges and cross-chain legs leaving Solana
ethUSDC on EthereumThe stock tokenAbout 0.01 ETH, for approvals and self-broadcast bridges
robinhoodUSDGThe stock tokenA little ETH on Robinhood Chain, for approvals; more for speed swaps
baseUSDC on BaseThe B20 tokenAbout 0.001 ETH on Base, for approvals; more for speed swaps
arbitrumUSDC on ArbitrumThe stock tokenA little ETH on Arbitrum, for approvals
bnbBinance-Peg USDC on BNB Smart ChainThe stock tokenAbout 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.
    • ondo listings follow the issuer's own per-ticker sessions.
    • Arbitrum and the xstocks listings outside Solana follow the continuous week, Sunday 20:00 ET to Friday 20:00 ET, closed on US market holidays.
    • xstocks on Solana, backpack, robinhood, coinbase and bstocks are not gated on the clock, though their liquidity can thin outside market hours (watch tradability).
    • A buy outside its session is 422 no_routes with reason: "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 from available_chains, before waiting.
  • Minimums. min_trade_size_usd is the smallest size measured to fill: on the ticker, on the single-chain listing blocks, and per chain on the ondo, xstocks and backpack blocks (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. tradability and warn_reason (per chain on the ondo, xstocks and backpack blocks, such as sol_tradability), and the same two fields on each quote leg, flag a thin or untradable venue before you quote. An absent tradability means 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 Chain ondo or xstocks leg. Sign and submit inside it.

Mistakes integrators hit most​

  1. A Solana wallet with no SOL. Its quotes are refused with 422 no_routes and reason: "insufficient_gas". Send sol_fee_payer on buys and sells, or fund the wallet with SOL. A first buy of an ondo token needs about 0.01 SOL in the wallet either way.
  2. Approving the wrong address on Robinhood Chain. Its spender is 0x5A70…89C7, not the 0x1111…0a65 used everywhere else.
  3. Treating USDG as USDC, or adding the stablecoins of different chains together. Read base_asset and chain on every leg.
  4. 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.
  5. 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.
  6. Approving only one issuer's token before an Ethereum sell. A sell can draw on every issuer's token the wallet holds.
  7. 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/tickers at runtime.
  8. Expecting outside activity on Robinhood Chain, Base or Arbitrum to appear in /trades. Only trades submitted through Treasures are recorded there.
  9. Indexing legs by array position. Echo each leg's quote_index; the values can skip.