> For the complete documentation index, see [llms.txt](https://docs.tallyprotocol.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tallyprotocol.xyz/getting-started/what-is-tally.md).

# What Tally is

Tally is a layer between you and the tokenized US stocks on BNB Chain. It does three things that a normal token swap interface does not.

1. **It counts in shares.** Every quote, balance and guarantee is expressed in shares of the stock. A token's price per share is the token price divided by its share multiplier, read from the chain where the issuer exposes it.
2. **It compares issuers.** For one stock it quotes each issuer's token live and ranks them by what you would actually receive, including the network fee.
3. **It guarantees the minimum in shares.** Buys go through a contract, [ShareGuard](/smart-contracts/shareguard-overview.md), that reverts the whole transaction if the shares you receive are below the minimum shown on your review screen.

## What it is not

* **Not custody.** Tally never holds your funds or keys. You sign every transaction in your own wallet (a Privy embedded wallet from an email or Google sign-in, or an external wallet such as OKX or Binance Web3 Wallet).
* **Not the underlying stock.** The tokens track a US stock's price. You do not own the share and have no shareholder rights.
* **Not advice.** Copy states facts. Suggestions on the Portfolio page are the same short list for everyone, rotated per wallet, and are labelled as such.
* **Not a venue.** Tally does not match orders. Trades execute through the Binance Web3 aggregator's router on BNB Smart Chain.

## The surfaces

| Surface                           | What it does                                                                                                                                         |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Web app (`app.tallyprotocol.xyz`) | Home, Trade, Portfolio, Radar, Guardian, Pies. Buy, sell, migrate between issuers, read receipts.                                                    |
| Telegram bot                      | Read-only commands (`/quote`, `/shares`, `/shield`) and Guardian alerts after you link your wallet.                                                  |
| MCP server                        | The same engine as tools an AI agent can call, with unsigned transactions the agent's own wallet signs. See [Tally for agents](/agents/overview.md). |

All three use one engine, so the numbers are identical everywhere. See [Architecture](/architecture/overview.md).

## Scope today

* BNB Smart Chain mainnet only, spot only, buys through ShareGuard, sells through the router with the router's own minimum-receive protection.
* Ondo and bStock tokens are tradable. xStocks tokens appear as data and as a trap example: on BNB Chain they have almost no liquidity.
* The minimum buy is 6 USDT and the minimum sale is 5 USDT.
* A short list of regions is blocked at the edge. See [Security model](/architecture/security-model.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.tallyprotocol.xyz/getting-started/what-is-tally.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.