thefin

Freqtrade Setup Guide and Pitfalls

January 19, 2026

In Quant Trading Intro: Why Can We Make Money from the Market?, I shared my thoughts on quantitative trading. This post documents the actual setup process.

My Technical Choices

ChoiceI ChoseWhy
Trading BotFreqtradeOpen source, well-documented, lets me focus on strategy
RuntimeDockerEnvironment isolation, easy to reproduce on different machines
Docker ToolOrbStackDocker manager for macOS, lightweight with nice UI
ExchangeBinanceLargest exchange, reliable data quality
Run Modedry-runDon't risk real money

Setup Process

The whole process was surprisingly smooth — Claude Code helped me with almost everything.

I just described what I wanted to do, and it generated commands, executed them, and handled errors. I won't go into specific installation steps here; just ask AI and you'll get the answer.

Pitfalls

Although the overall process was smooth, I hit two pitfalls worth documenting for others.

1. Wrong stake_currency

I wanted to fetch BTC data, so I set stake_currency to BTC. Then I couldn't find any trading pairs when downloading data.

Later I understood: stake_currency is your "base currency" for trading, not the asset you want to trade.

  • Choose USDT → Buy/sell other coins with USDT → Trading pairs are BTC/USDT, ETH/USDT
  • Choose BTC → Buy/sell other coins with BTC → Trading pairs are ETH/BTC, XXX/BTC

Binance has the most USDT pairs with the best liquidity. To trade BTC, the correct approach is:

stake_currency: USDT
Trading pair: BTC/USDT

2. Getting Telegram Bot chat_id

Creating a Bot and getting the Token isn't hard — just follow BotFather.

The tricky part is getting chat_id. Many tutorials online say to call an API, but there's a simpler way:

  1. Open Telegram Web (web.telegram.org)
  2. Click into your conversation with the Bot
  3. Look at the URL, format is like web.telegram.org/k/#-1234567890
  4. That number is the chat_id

Summary

Environment ready. Next step: understand SampleStrategy and grasp the basic structure of a strategy.

Updated at January 19, 2026

Disclaimer: This article is for informational purposes only and does not constitute investment advice. Trading involves risks. Always do your own research.

CC BY 4.0 © 2026 TheFin.top