> 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/09-faq.md). # Frequently Asked Questions **Quick answers to the most common questions about TokenBot.** *** ## Getting Started ### Is TokenBot really free? Yes. The core trade synchronization service is completely free. You can connect exchanges, sync trades across your accounts, and receive event notifications without paying anything. We sustain the free service through optional features and exchange referral partnerships. ### How do I install it? TokenBot is a command-line tool. Install it with npm or Homebrew: ```bash npm install -g tokenbot # or brew tap tokenbot-org/tokenbot && brew install tokenbot ``` Then create your identity with `tokenbot init`. You'll need **Node.js 22 or newer**. ### How long does setup take? Most users are fully set up in under 10 minutes: * Install + `tokenbot init`: 2 minutes * Creating API keys on an exchange: 3-5 minutes * Adding your first account and strategy: 2 minutes ### Is there a web dashboard? No. TokenBot is CLI-first — everything runs through the `tokenbot` command. (The old web dashboards have been retired.) If you want a UI, you can build on the REST API, GraphQL API, or MCP server. *** ## About API Keys ### What is an API key? An API key is like a special credential that lets software (like TokenBot) interact with your exchange account. You create them on your exchange and add them to TokenBot. ### Is it safe to give TokenBot my API key? Yes, with one important condition: **never enable withdrawal permissions.** TokenBot only needs trade permissions. Without withdrawal permissions, your funds cannot be moved—even if your key were stolen. And with `tokenbot keys add`, your keys are encrypted locally and never sent to a server at all. ### Where are my exchange keys stored? You choose. `tokenbot keys add` keeps them encrypted on your own machine (`~/.tokenbot/keys.json`), never transmitted. `tokenbot exchange add` registers an account with the server (encrypted in AWS Secrets Manager) so the automated bots can trade. ### What happens if I delete my API key on the exchange? TokenBot immediately loses access to that account. This is the fastest way to disconnect. *** ## Trading & Syncing ### How does copying work? You designate a **Strategy** account and add **Copier** accounts that follow it. When the Strategy trades, each linked Copier replicates the trade, sized by its allocation. ### What if my Copier account doesn't have enough balance? TokenBot skips that account for that trade. Other Copier accounts still execute normally. ### Can I trade across multiple exchanges simultaneously? Yes! That's the main point of TokenBot. Your Strategy account can be on one exchange, with Copier accounts on several other exchanges. ### Do partial fills copy? Yes. If your Strategy order partially fills, TokenBot replicates the fill to your Copiers. ### What about stop-losses and take-profits? Supported, where the exchange supports them. *** ## The CLI ### How do I see all my accounts and links? ```bash tokenbot links list # copiers and the strategy each follows tokenbot exchange list # registered exchange accounts tokenbot balance --all # local balances across exchanges ``` ### Can I script TokenBot? Yes. Add `--json` to any command for machine-readable output you can pipe into other tools. You can also use the REST API, GraphQL API, or the MCP server for AI assistants. ### Where is my configuration stored? In `~/.tokenbot/` — your encrypted identity (`config.json`) and, if you use local keys, your encrypted key store (`keys.json`). Override the location with `--config `. *** ## Rewards & Referrals ### How do I earn $TBOT tokens? By trading! Every trade you make through TokenBot earns reward points that convert to $TBOT tokens. More volume = more tokens. Check your balance with `tokenbot rewards show`. ### What's the referral program? Share your referral code (`tokenbot rewards refer`). When someone gets started with your code and trades, you earn 10% of the $TBOT tokens they generate—forever, no cap. ### When can I claim my tokens? Anytime, once you hit the minimum claim amount. Run `tokenbot rewards show` for the current minimum. ### Where do $TBOT tokens go? When you claim, tokens are sent to the Ethereum-compatible wallet address you provide. Make sure you control this wallet. *** ## Troubleshooting ### A trade didn't copy—what happened? Common reasons: * **Insufficient balance**: Copier account didn't have funds * **API key issue**: Key might need regenerating or lacks trade permission * **Exchange maintenance**: Exchange was temporarily unavailable * **Trading pair not available**: The Copier's exchange might not list that pair ### My API key shows "invalid" 1. Regenerate the key on your exchange 2. Make sure trade permissions are enabled 3. Check whether IP restrictions exclude you (local) or the bot IPs (server-side) 4. Verify you copied the entire key (no extra spaces) ### A command fails with an auth error Run `tokenbot whoami` to confirm your identity is configured. If not, run `tokenbot init`. Make sure you're using the correct passphrase. ### Where can I check for outages? Check the TokenBot status page and follow [@TokenBotV2 on X](https://x.com/tokenbot). *** ## Account & Security ### How do I remove my local data? ```bash tokenbot logout ``` This deletes `~/.tokenbot/config.json` and `~/.tokenbot/keys.json`. ### How do I delete my server-side account? Email . This removes your account data, subject to legal retention requirements. ### What if I forget my passphrase? It cannot be recovered — your private key is encrypted with it. You'd need to run `tokenbot init` to create a new identity. ### Is 2FA available? Yes, for the account-management surface exposed by the GraphQL API (TOTP-based). The CLI itself authenticates with your keypair. *** ## Business & Legal ### How does TokenBot make money? Primarily through exchange referral partnerships. When you sign up for an exchange through our links, we receive a commission. We're transparent about this—[read more here](https://github.com/tokenbot-org/tokenbot-docs/blob/main/help-center/rewards/transparency/README.md). ### Where is TokenBot based? Check our Terms of Service for legal entity details. ### Is TokenBot available in my country? TokenBot is available widely, but some features depend on which exchanges serve your region. If an exchange doesn't operate in your country, you won't be able to connect it. ### Do you share my data? No. We don't sell or share your personal data with third parties. See our Privacy Policy for details. *** ## Still Have Questions? We're here to help: * **X (Twitter)**: [@TokenBotV2](https://x.com/tokenbot) * **GitHub**: [tokenbot-org](https://github.com/tokenbot-org) * **Email**: --- # 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/09-faq.md?ask= ``` 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.