Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

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?

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 <path>.

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.

Account & Security

How do I remove my local data?

This deletes ~/.tokenbot/config.json and ~/.tokenbot/keys.json.

How do I delete my server-side account?

Email support@tokenbot.com. 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.

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:

PreviousSecurity & TrustNextTBOT Tokenomics

Last updated

Was this helpful?