docs / core concepts
Stocks on TON
How KNAR prices and routes tokenized US stocks (xStocks) on the TON blockchain.
What an xStock is
xStocks are jettons issued by Backed Finance. Each token is backed 1:1 by the underlying share held by the issuer, so NVDAx tracks NVIDIA, TSLAx tracks Tesla, and so on. They live natively on TON, which means any TON wallet can hold them.
One deposit, one route
- You pick a stock and an amount of TON.
- KNAR asks the STON.fi v2 router to simulate the swap and shows the output, minimum after slippage, price impact, and pool fee.
- The quote is compared to the NYSE or Nasdaq reference price, so you can see the pool premium or discount before you sign.
- Confirming opens STON.fi with the pair preloaded, and you sign in your own wallet. KNAR never takes custody.
- Selling runs the same route backwards: xStock in, TON out.
Reserves
The reserves page reads total_supply from every xStock jetton master via toncenter v3 and multiplies it by the reference price. It refreshes every minute.
Some xStock pools on TON are shallow. If price impact exceeds 15% the swap panel flags the route, so try a smaller size.
| Endpoint | Returns |
|---|---|
| GET /api/stocks | Board: every xStock with TON and USD price, day change, sparkline |
| GET /api/stocks/{ticker} | Detail: reference price, pool price, supply, swap links |
| GET /api/stocks/{ticker}/chart?range=1d|5d|1mo|6mo|1y | Price history in USD |
| GET /api/stocks/quote?symbol=NVDA&side=buy&amount=10 | Live STON.fi simulation |
| GET /api/stocks/reserves | On-chain supply and backed value |
| GET /api/wallet/{address} | TON balance, jettons, recent events |