Read the README in English.

Úvod

Vítejte na stránkách AccBota. AccBot je open-source akumulační bot, který v pravidelných intervalech po malých částkách v Kč nebo Eurech nakupuje BTC (eventuálně LTC, ETH, XMR nebo DASH) na burze Coinmate dle strategie DCA.

Jednoduchý popis fungování bota

• Nakupuje uživatelem definovanou částku v českých korunách (typicky desítky Kč) / eurech (typicky jednotky Eur) každých uživatelsky definovaných hodin (ideálně dělitelných 24, aby nakupoval vždy ve stejný čas, tedy např. -> každou hodinu, 1x za 2h, 1x za 4h, 1x za 8h, etc.).
• Běží autonomně bez nutnosti jej nějak v čase spravovat, je zapotřebí si pouze hlídat stav svého Kč účtu a pravidelně jej na Coinmate doplňovat (např. jednou za měsíc).
• Náklady na provoz jsou prakticky nulové (vychází to cca na 0.04 € / měsíčně za Azure hosting); bot je implementován zatím jako Azure function, která se spouští v pravidelných intervalech a celé řešení je tedy hostované na Azure.
• (Volitelná funkcionalita) Po každém nákupu Vás informuje na Telegramovém kanále o tom, za jakou částku nakoupil. Tuto informaci doplní o statistiky, jaká je aktuální průměrná akumulovaná cena, etc. Viz příklad:
  • 
• (Volitelná funkcionalita) Pokud je naakumulované dostatečné množství BTC, pak pokud je poplatek za výběr z celkové částky menší, než uživatelsky stanovený limit (např. 0.1 %), bot pošle naakumulované množství BTC z burzy do definované BTC peněženky (poznámka: pokud chcete využívat tuto funkcionalitu, doporučujeme povolit API odeslání pouze na Vaši konkrétní BTC peněženku, viz nastavení při vytváření API klíče na Coinmate)
  • 

Prerekvizity

1. Nainstalovaný PowerShell

2. Nainstalovaný Azure CLI

3. Založený účet na burze Coinmate (účet je zdarma; k tomu, abyste mohli na burzu zasílat fiat, je zapotřebí provést ověření KYC)

   • Pokud byste nás chtěli podpořit a zaregistrovat se přes náš referral link, můžete kliknutím na banner níže

   

4. Založený účet na Azure (účet je zdarma; platí se pouze za využité prostředky, které vychází na cca 0.04$ / měsíc)

Postup instalace

1. Na Coinmate si vygenerujte API klíče (aby měl BOT přístup k prostředkům na burze a mohl provádět svoji akumulační činnost). Do poznámkového bloku si zapište vygenerovaný ClientId, PublicKey a PrivateKey -> budete je potřebovat v bodu 5.

   • POZOR: Je nutné API klíčům přidat oprávnění na Trading, viz:

   .

   • Pokud byste chtěli využít i funkci automatického výběru, zaškrtněte i volbu "Enable for Withdrawal". V takovém případě doporučujeme si zaškrtnout i "Enable for withdrawals to template addresses only", což znanená, že bot bude moci poslat naakumulované BTC pouze na Vámi definované adresy, viz:

   

2. Stáhněte si ZIP z aktuálního RELEASE, který obsahuje instalační PowerShell skript a zbuilděného bota.

3. ZIP z předchozího bodu rozbalte kamkoliv do Vašeho souborového systému

4. V poznámkovém bloku (nebo jiném textovém editoru) otevřte soubor install_script.ps1

5. (Nepovinné) Nastavte si Telegram notifikace. (Pokud i přes doporučení nechcete Telegram notifikace využívat, v dalším kroku proměnné týkající se Telegramu nevyplňujte)

6. Upravte proměnné v sekci ### USER-DEFINED VARIABLES ###

##############################
### USER-DEFINED VARIABLES ###
##############################

# Jméno, které se zobrazuje v Telegram notifikacích
$Name='anonymous'

# Crypto, které na Coinmate chcete nakupovat (MOŽNÉ HODNOTY: BTC, LTC, ETH, XRP, DASH)
$Currency='BTC'

# Fiat měna, za kterou chcete na Coinmate nakupovat crypto (MOŽNÉ HODNOTY: CZK, EUR)
$Fiat='CZK'

# Velikost chunku v CZK, resp. EUR, který chcete pravidelně nakupovat (MINIMUM pro CZK: 26; MINIMUM pro EUR: 1)
$ChunkSize='26'

# Jednou za kolik hodin chcete pravidelně nakupovat BTC
$HourDivider='1'

# Příznak, zdali chcete povolit Withdrawal v případě, že je fee menší než 0.1% (POVOLENÉ HODNOTY: true / false)
$WithdrawalEnabled='false'

# Adresa peněženky pro withdraw (aplikuje se pouze pokud WithdrawalEnabled = TRUE)
$WithdrawalAddress=''

# (Využije se pouze v případě, kdy $WithdrawalEnabled='true'). 
# Maximální limit na withdrawal fee v procentech. (DEFAULT: 0.001 = 0.1 %) 
$MaxWithdrawalPercentageFee = '0.001'

# (Využije se pouze v případě, kdy $WithdrawalEnabled='true'). 
# Maximální limit na withdrawal fee v absolutní hodnotě (Kč)
# Pokud je nastaveno -1, uplatní se pouze podmínka procentuální => $MaxWithdrawalPercentageFee
$MaxWithdrawalAbsoluteFee = -1

# Adresa telegram kanálu, do kterého chcete dostávat notifikace (ve formátu @NázevKanálu)
$TelegramChannel='@channel_name'

# Privátní klíč telegram bota (POZOR, bot musí být členem kanálu výše)
$TelegramBot='telegram_bot_hash'

# ClientId z Coinmate API
$CoinMateCredentials_ClientId='111'

# Public key z Coinmate API
$CoinMateCredentials_PublicKey='XXX'

# Private key z Coinmate API
$CoinMateCredentials_PrivateKey='XXX'

# Příznak pro vytvoření logu na Azure. (POVOLENÉ HODNOTY: true / false). DOPORUČENÍ: Standardně mít vypnuté, tedy "false". 
# Log zvyšuje měsíční náklady z cca 0.04 € / měsíc na cca 0.2 € / měsíc. Doporučujeme tedy zapnout pouze pokud Vám bot například nenakupuje jak by měl. 
$CreateAzureLog = 'false'

##############################

7. Uložte soubor install_script.ps1 s vyplněnými hodnotami z předchozího kroku.

• : Poklepáním spusťte run.bat file (Pro Windows OS).
• / : Spusťte PowerShell a v něm proveďte příkaz

  powershell.exe -executionpolicy bypass -file .\install_script.ps1

Skript Vám automaticky připraví všechny potřebné resources na Azure. Na začátku by mělo vyskočit i okno s přihlášením do Azure portal.

POZOR: Instalace trvá několik minut, vyčkejte prosím na její dokončení. Na závěr by se měla objevit následující hláška:

(Nepovinné) Nastavení Telegram notifikací

Tato část není povinná pro provoz bota, nicméně jde o velkou přidanou hodnotu, neboť Vás bot bude pravidelně informovat po každém nákupu jaké je Vaše průměrná cena naakumulovaného BTC a kolik BTC jste již naakumulovali. Zároveň si budete moci v reálném čase ověřovat, že bot funguje.

1. Založení účtu na Telegramu

2. Vytvoření bota přes BotFather dle návodu.

   • Token z návodu se poté vloží do proměnné $TelegramBot z PowerShell skriptu

3. Vytvoření nového kanálu (videonávod pro vytvoření z mobilní aplikace -> Android nebo iOS verze). Eventuálně postupujte dle následujících printscreenů -> vytvoření přes Telegram desktop.

   • V levém horním rohu klikněte na nastavení

   

   • Klikněte na tlačítko New Channel

   

   • Pojmenujte si svůj kanál a potvrďte založení tlačítkem

   

   • Kanál označte jako Public a vymyslete pro něj unikátní název. Tento název se poté vyplňte ve formátu @MyAccBotChannel (v případě příkladu níže) do proměnné $TelegramChannel v powershell skriptu
   • Pokud chcete vytvořený kanál nastavit jako Private postupujte takto:
   • Zjistěte Id vašeho privátního kanálu, např. tak, že kanál otevřete ve webovém rozhraní Telegram
   • URL adresa bude mít formát https://web.telegram.org/z/#{IdKanálu}
   • Pozor! pro odesílání zpráv přes vytvořeného bota musíte před Id přidat ještě -100. Pokud tedy vaše adresa byla např. https://web.telegram.org/z/#-123456789, výsledné Id bude -100123456789.
   • Toto získané Id vložte do proměnné $TelegramChannel namísto názvu kanálu.

4. Do kanálu pozvěte svého bota (vyhledejte ho dle jména), kterého jste vytvořili v bodu 2 přes BotFather.

   • Potvrďte bota jako administrátora kanálu

   

   • Ponechte defaultní volbu oprávnění bota

   

5. Hotovo, do vytvořeného kanálu by Vám odteď měl bot zapisovat informace o nákupech se statistikami.

Úprava nastavení / Aktualizace již běžícího AccBota

• Pokud Vám AccBot již úspěšně běží a chcete si časem změnit nějaké nastavení (četnost nebo výše jednotlivých nákupů, povolení withdrawal, etc.), nejjednodušším způsobem je upravit USER-DEFINED VARIABLES v instalačním skriptu install_script.ps1 a skript znovu spustit dle kroku 7 instalačního návodu.
• Pokud chcete nasadit novou verzi AccBota, stáhněte si ZIP z aktuálního RELEASE, nastavte si sekci USER-DEFINED VARIABLES v instalačním skriptu install_script.ps1 a skript znovu spustit dle kroku 7 instalačního návodu.

Donate

AccBota jsme se rozhodli poskytnout zcela zdarma, neboť chceme co nejvíce lidem umožnit co nejjednodušší a nejlevnější cestu k aplikaci strategie DCA. Věříme, že pravidelné spoření v Bitcoinu je tím nejlepším způsobem k zajištění do budoucna. Investovat do BTC se zapojením emocí a s ambicemi predikovat trh se totiž ve většině případů nevyplácí.

Pokud byste nás chtěli podpořit, rozhodně se tomu bránit nebudeme. Níže jsou uvedeny jednotlivé peněženky, kam nám můžete zaslat příspěvek třeba na pivo. :) Děkujeme <3

• BTC ❤️: bc1q2hz79m4csklecqgusu9e2yjnrr6e9ca6nhu0at
  • 
• LTC: LTXdCFBYHgVLa8cBNBqwEvaQLi8tENY5R3
  • 
• XMR: 49QBko3UdegAkx6g8foqjs9efQD6rrhsPEoTqP9HmA2LCUZsJ8xBD2JZSMEdzhA5NJ9SrVhzu2uJXRUvL2kAiV45LyDBCUt
  • 
• DOGE: DR9mEaVLmx3gxqiqffwYQcLsT1upRL3xe9
  • 
• ETH: 0x8A944bcb5919dF04C5207939749C40A61f88188C
  • 
• DOT: 15sBCVyWu5Gy9VnzQpid4ggC1MmguBBd1xotUVbsbbRWddun
  • 
• BNB: bnb1lwcgq8emrjgptxg4hm37d5tf2yunrph842awrh
  • 
• ADA: addr1qxgfp7xf8rpg7laque78queavpfdztajgl3hr8kuanuqgdysjruvjwxz3al6penuwpen6czj6yhmy3lrwx0dem8cqs6qr8y8fj
  •