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

# What is TokenBot?

**TokenBot is a free command-line tool that synchronizes your cryptocurrency trades across multiple exchange accounts automatically.**

***

## The Simple Version

Think of TokenBot like a personal assistant for your trading that lives in your terminal. You designate one of your exchange accounts as your **Strategy** account. When a trade happens there, TokenBot mirrors it onto your other **Copier** accounts. No copying and pasting. No switching between apps. No missed opportunities.

Everything runs through the `tokenbot` CLI — install it once with npm or Homebrew and drive the whole platform from the command line.

***

## What Can You Do With TokenBot?

### Trade Once, Execute Everywhere

You trade on your Strategy account. TokenBot handles the rest.

**Example:** You buy 0.5 ETH on your Binance account. TokenBot replicates the same trade on your Bybit, OKX, and Coinbase accounts.

### Spread Your Risk

Keeping all your crypto on one exchange is risky. Exchanges can get hacked, go offline, or face regulatory issues. TokenBot helps you keep funds across multiple exchanges while still trading them together.

### Automate Your Strategies

TokenBot ships server-side trading and market-making engines that run on a schedule. Register an exchange account and let the bots work for you between your own manual trades.

### Earn Rewards

Active traders earn $TBOT tokens based on their trading volume. Share TokenBot with friends using your referral code and earn a share of their rewards too.

***

## How Does It Actually Work?

TokenBot connects to your exchange accounts using **API keys** — special credentials that let software trade on your behalf.

Here's the important part: **TokenBot never has access to your money.**

API keys can be set with different permissions. TokenBot only needs "trade" permission. It can place buy and sell orders, but it cannot withdraw anything. Your funds stay safely on your exchange, under your control.

And you control where your keys live. Keys you add locally with `tokenbot keys add` are encrypted on **your machine** and never transmitted anywhere.

```
┌─────────────────┐
│  Strategy acct  │
│   (Buy 1 BTC)   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  tokenbot CLI   │
│   + TokenBot    │
│    backend      │
└────────┬────────┘
         │
    ┌────┴────┐
    ▼         ▼
┌───────┐ ┌───────┐
│Copier │ │Copier │  ← Same trade, different exchanges
│Binance│ │ Bybit │
└───────┘ └───────┘
```

***

## Who Is TokenBot For?

### Professional Traders

Managing multiple accounts manually is tedious. TokenBot automates the grunt work so you can focus on strategy.

### Power Users & Developers

Everything is a command. Pipe `--json` output into your own scripts, wire up webhooks, or drive TokenBot from the REST/GraphQL APIs or the MCP server for AI assistants.

### Anyone Who Wants to Spread Risk

Don't put all your eggs in one basket. Trade across exchanges without the hassle.

***

## Is TokenBot Free?

**Yes.** The core trade synchronization is completely free.

TokenBot earns money through optional features and referral partnerships with exchanges. When you sign up for an exchange through TokenBot's links, we may receive a small commission from the exchange. This helps us keep the service free while you often get signup bonuses too.

***

## Quick Facts

| Question                | Answer                                                                                 |
| ----------------------- | -------------------------------------------------------------------------------------- |
| **Cost**                | Free                                                                                   |
| **Interface**           | `tokenbot` command-line tool (macOS, Linux, Windows)                                   |
| **Install**             | `npm install -g tokenbot` or `brew tap tokenbot-org/tokenbot && brew install tokenbot` |
| **Supported Exchanges** | Many, via CCXT (Binance, Coinbase, OKX, Bybit, Kraken, and more)                       |
| **Trading Types**       | Spot, Margin, and Perpetual Futures                                                    |
| **Security**            | secp256k1 keypair identity; exchange keys encrypted; no withdrawal access              |
| **Token**               | $TBOT (1B supply, ERC-20)                                                              |

## Official Links

* 🌐 **Website**: [tokenbot.com](https://tokenbot.com)
* 🐦 **X (Twitter)**: [@TokenBotV2](https://x.com/tokenbot) — Official announcements
* 📦 **Install**: [tokenbot on npm](https://www.npmjs.com/package/tokenbot)
* 🔍 **Token Explorer**: [Etherscan](https://etherscan.io/token/0x6645EC2036fB0DE007714829A6116279002F6408)
* 📊 **Market Data**: [CoinMarketCap](https://coinmarketcap.com/currencies/tokenbot/)
* 💻 **Open Source**: [Token Contracts on GitHub](https://github.com/tokenbot-org/token-contracts)

***

## Ready to Start?

Install the CLI and create your identity:

```bash
npm install -g tokenbot
tokenbot init
```

***

## Next: Why TokenBot Exists

Curious about the problem TokenBot solves? [Read more →](https://github.com/tokenbot-org/tokenbot-docs/blob/main/help-center/overview/why-tokenbot-exists/README.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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tokenbot.com/home/01-what-is-tokenbot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
