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 accounts, and get alerts without paying anything.

We sustain the free service through optional premium features and exchange referral partnerships.

Do I need to download anything?

Yes — TokenBot is CLI-first. You install the tokenbot command-line tool and drive everything from your terminal; there is no web dashboard.

npm install -g tokenbot   # requires Node.js 22+
tokenbot init

Access is currently early access — join the waitlist at site.tokenbot.com. See the Quick Start Guide.

Set up webhooks to send trade alerts to Discord, Telegram, or any platform.

How long does setup take?

Most users are fully set up in under 10 minutes:

Account creation: 2 minutes
Creating API keys on an exchange: 3-5 minutes
Connecting your first account: 1 minute

About API Keys

What is an API key?

An API key is like a special password that lets software (like TokenBot) interact with your exchange account. You create them on your exchange and give 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.

Can I use the same API key for other services?

You can, but we don’t recommend it. Create a dedicated API key for TokenBot. This makes it easy to revoke access later without affecting other services.

What happens if I delete my API key on the exchange?

TokenBot immediately loses access to that account. Trades won’t sync to or from that account anymore. This is the fastest way to disconnect if needed.

Trading & Syncing

How fast do trades copy?

Typically under 1 second. TokenBot uses WebSocket connections to detect trades instantly, then executes copies within milliseconds.

What if my Copier account doesn’t have enough balance?

TokenBot skips that account for that trade and sends you an alert. Other Copier accounts still execute normally.

Can I trade on multiple exchanges simultaneously?

Yes! That’s the main point of TokenBot. Your Strategy account can be on one exchange, and you can have Copier accounts on multiple different exchanges.

Do partial fills copy?

Yes. If your Strategy account order partially fills, TokenBot copies that partial fill to your Copiers.

What about stop-losses and take-profits?

Supported. If your exchange supports them and you set them on your Strategy account, TokenBot copies them to your Copier accounts.

Bots & Alerts

How do trade alerts work?

TokenBot uses webhooks to send real-time trade notifications to any HTTPS endpoint. You can build custom bots for Discord, Telegram, Slack, or any platform. See Webhooks → for setup.

Can alerts go to multiple destinations?

Yes. You can create multiple webhook endpoints, each subscribing to different events. Useful if you have different audiences for different strategies.

Why aren’t my webhooks delivering?

Check these common issues:

Is your webhook endpoint returning 200 status codes?
Is the webhook status “Enabled” (not “Failing”)?
Is your Strategy account active and making trades?

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.

What’s the referral program?

Share your unique referral link. When someone signs up 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 your current balance. Claiming is not yet exposed on the CLI — contact support to action a claim.

Where do $TBOT tokens go?

When you claim, tokens are sent to the Ethereum wallet address you provide. Make sure you control this wallet.

Troubleshooting

Trade didn’t copy—what happened?

Common reasons:

Insufficient balance: Copier account didn’t have funds
API key issue: Key might need regenerating
Exchange maintenance: Exchange was temporarily unavailable
Trading pair not available: Copier exchange might not list that pair

Run tokenbot trades to see the status of recent trades, or tokenbot copier show <id> to inspect a copier.

API key shows “invalid”

Try these fixes:

Regenerate the key on your exchange
Make sure all required permissions are enabled
Check if the key has IP restrictions that exclude TokenBot
Verify you copied the entire key (no extra spaces)

Webhook not delivering?

Check the webhook status in Settings → Webhooks
Verify your endpoint is accessible and returning 200
Check the delivery logs for error details
Re-enable the webhook if it was auto-disabled due to failures

Dashboard won’t load

Clear your browser cache
Try a different browser
Disable browser extensions temporarily
Check if the issue is your internet connection

Account & Security

How do I delete my account?

Go to Settings → Account → Delete Account. This permanently removes all your data, API keys, and trading history.

Can I export my trading history?

Yes — --json gives you machine-readable output you can transform however you like:

tokenbot trades --limit 500 --json > trades.json

For CSV, pipe it through jq:

tokenbot trades --limit 500 --json \
  | jq -r '["executed","symbol","side","qty","price","pnl"], (.[] | [.executedAt,.symbol,.side,.quantity,.price,.profitLoss]) | @csv' \
  > trades.csv

What if I forget my passphrase?

There is no password — the CLI encrypts your identity key under a passphrase you choose, and there is no recovery path. If it’s lost, register a new identity with tokenbot init and re-bind it to your account.

Is 2FA available?

Not currently. 2FA and passkeys belonged to the retired web dashboard. Authentication is now a secp256k1 signature over every request, with your private key encrypted at rest and never transmitted — see Authentication.

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?

TokenBot is a global service. Check our Terms of Service for legal entity details.

Is TokenBot available in my country?

TokenBot is available worldwide, 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 that exchange.

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