⚙️ Config#

Dynaconf#

Dynaconf is a powerful and easy-to-use configuration management library for Python. Talky settings are based on Dynaconf. It supports TOML settings file, .env file or environment variable , and other types. Refer to dynaconf/dynaconf for more information.

Settings Structure#

Config will load:

talky default: talky_settings.toml
default from library if the library support it: default_settings.toml
user settings: settings.toml
user secrets: .secrets.toml

Your settings should be setup in settings.toml, .secrets.toml, .env or environment variable.

Settings.toml or .env can be located in /app/settings.toml or /app/.env for docker. If deployed locally, place your file in /tt/ folder.

1Password#

In case, you use 1Password to store your settings, you can use .secrets.toml to retrieve and store your settings from a notesPlain item. in order to use 1Password, you need to add the following to your .env file:

OP_SERVICE_ACCOUNT_TOKEN: your 1Password service account token

OP_VAULT: your 1Password vault

OP_ITEM: your 1Password item

OP_PATH: your one 1Password path (optional and default value /usr/bin/op)

The .secrets.toml will located in /tt/.secrets.toml and be created by the OP client via op read op://vault/item/notesPlain > .secrets.toml

Talky Settings#

More than 100 settings customizable via settings.toml or .env. Most of them are predefined and you only need to update the credentials realted to your exchange and chat platform

########################################
###          DEFAULT SETTINGS        ###
########################################

# Any of those settings can be changed.
# To overwrite a setting, create a 
# a file named settings.toml or load from 
# .env file or env vars.
# As an example, to change the port:
#
#   settings.toml
#   [default]
#    port = 8081
#
# or via .env 
# export TT_PORT=8081


########################################
###        DYNACONF SETTINGS         ###
########################################

[default]
# Dynaconf settings verification
VALUE = "Production"

########################################
###         PYTHON SETTINGS          ###
########################################

# Log level to troubleshoot
# loglevel = "DEBUG"
loglevel = "DEBUG"
# Log level for third party library
thirdparty_lib_loglevel = "ERROR"

# URL to verify the latest version
repo = "https://api.github.com/repos/mraniki/tt/releases/latest"
# Enable/Disable Version Check
version_check = true


########################################
###         FASTAPI SETTINGS         ###
########################################

# Uvicorn Server settings
host = "0.0.0.0"
port = 8080

# Experiemental, If set to true,
# provide a ui at http://0.0.0.0:8080/
# refer to frontend documentation 
# ui_enabled = true
ui_enabled = false

# Your webhook secret to send
# trade alert directly to your chat.
# If you use Trading view, the webhook
# to be set in the trading view notification
# will be https://0.0.0.0/webhook/123abc
# as per the above and below data

webhook_secret = "123abc"

# Forward the webhook data 
# to another endpoint like another bot
# or webhook service.

# Forwarded  Enable/Disable
forwarder = false
# Forwarder URL
forwarder_url = ""

########################################
###        APPRISE SETTINGS          ###
########################################

# Refer to 
# https://github.com/caronc/apprise/wiki
# Apprise endpoint URL can be a URL 
# for the chat, a URL to an Apprise config
# or a URL to the Apprise API endpoint
# apprise_url = "tgram://BOTTOKEN/CHANNEL"
# apprise_url = "discord://token1/channel"
apprise_url = "json://localhost"

#Format of the apprise notification.
# apprise_format = "NotifyFormat.MARKDOWN"
apprise_format = "NotifyFormat.HTML"

########################################
###      IAMLISTENING SETTINGS       ###
########################################

# Enable/Disable IAMListening
iamlistening_enabled = true

########################################
###   COMMON BOT COMMAND SETTINGS    ###
########################################

# Bot Prefix 
bot_prefix = "/"
# Character to ignore
bot_ignore = "ℹ️ 🦄 ⚠️ 📊 🏦 📺 ⬆️ 💬 🐻"
# Command for help
bot_command_help = "help"
# Command for info
bot_command_info = "info"
# Command for user balance
bot_command_bal = "bal"
# Command for user position
bot_command_pos = "pos"
# Command for daily pnl
bot_command_pnl_daily = "d"
# Command for instrument quote
bot_command_quote = "q"
# Command for switch trading on or off
bot_command_trading = "trading"
# Command to retrieve network info
bot_command_network = "network"
# Command to restart the bot
bot_command_restart = "restart"
# Command to get live tv link
bot_command_tv = "live"
# Command to get trading view trend
bot_command_trend = "trend"
# Command to get latest news
bot_command_news = "news"
# Command to scrape data
bot_command_scraper = "scraper"
# command for conversation
bot_command_aichat = "ai"
# command to toggle aimode
bot_command_aimode = "aimode"
# command to export conversation
bot_command_aiexport = "export"
# command for reset conversation
bot_command_aiclear = "clear"

# Help Message
helper_commands = """
🆘 /help
ℹ️ /info
🔀 /trading
🔁 /restart
🕸️ /network
📺 /live
📰 /news
📊 /trend
💬 /ai
➰ /aimode
🧽 /clear
‍💨 /export
⚖️ /q WBTC
🏦 /bal
🏦 /pos
🎯 BUY WBTC
🎯 buy BTCUSDT sl=200 tp=400 q=2%
"""

########################################
###         TRADING SETTINGS         ###
########################################

# Enable/Disable Trading
trading_enabled = true
trading_control = true
trading_days_allowed = ["tue", "wed", "thu"]
trading_hours_start = "08:00"
trading_hours_end = "16:00"

########################################
###        FINDMYORDER SETTINGS      ###
########################################

# Enable/Disable FindMyOrder
findmyorder_enabled = true

# Keyword to be use to identify an order
action_identifier = "BUY SELL LONG SHORT"
# Keyword identifier for stoploss
stop_loss_identifier = "sl="
# Keyword identifier for take-profit
take_profit_identifier = 'tp='
# Keyword identifier for quantity
quantity_identifier = 'q='
# Keyword identifier for order type
order_type_identifier = "spot future margin"
# Keyword identifier for leverage
leverage_type_identifier = "cross isolated"
# Keyword identifier for comments
comment_identifier = "comment="

# Stoploss default value is none is provided
stop_loss = 1000
# Take-Profit default value is none is provided
take_profit = 1000
# Quantity default value is none is provided
quantity = 1

# Settings to enable or disable
# instrument mapping
instrument_mapping = true
# instrument mapping to use and alternative 
#  symbol when generating the order
mapping = [
    { id = "EURUSD", alt = "EUR/sUSD" },
    { id = "GOLD", alt = "XAU" },
    { id = "BTC", alt = "WBTC" },
    { id = "ETH", alt = "WETH" },
]

# Instruments to be ignored
# when generating an order
ignore_instrument = "DOGE"

########################################
###         PLUGINS SETTINGS         ###
########################################

# Enable/Disable Plugins
plugin_enabled = true
# Plugins Locations
plugin_directory = "tt.plugins.default_plugins"

# Plugins name list to load at the start
# of the bot to allow a reduced memory 
# usage and footprint if needed
# if you want all the plugins to be loaded
# at the start, set it to
authorized_plugins = []
# Here the value has been set for helper
# and dex exchange plugins only
# authorized_plugins = [
#     'helper_plugin',
#     'dex_exchange_plugin',
#     ]

# Enable/Disable Example Plugin
# example_plugin_enabled = true
example_plugin_enabled = false
# Enable/Disable User Plugins
# Not yet implemented
# user_plugins_allowed = true
user_plugins_allowed = false

# plugin cron scheduler
user_day_of_week="tue-thu"
user_hours="6,12,18"
user_timezone="UTC"

########################################
###          HELPER SETTINGS         ###
########################################


# Enable/Disable Helper
helper_enabled = true
# helper_enabled = false
#name of the bot
bot_name = "Talky"
# URL endpoint for latency ping.
ip_check_url = "8.8.8.8"


########################################
###        TALKYTREND SETTINGS       ###
########################################

# Enable/Disable Talkytrend
talkytrend_enabled = true
# talkytrend_enabled = false

# Enable/Disable Signals
enable_signals = true
# enable_signals = false

# instrument trend to be monitored
# use https://tvdb.brianthe.dev
# for the list of supported instrument
assets = [
    { id ="EURUSD", exchange='FX_IDC',screener="forex"},
    { id ="UKOIL", exchange='FX',screener="cfd"},
    { id ="GOLD", exchange='TVC',screener="cfd"},
    { id ="BTCUSD", exchange='BINANCE',screener="crypto"},
]

# Enable/Disable Yfinance
enable_yfinance = true

# yahoo finance ticker reference
# https://finance.yahoo.com/lookup/
yfinance_ticker_reference = "TSLA"

# Enable/Disable Events
enable_events = true
# Events calendar
economic_calendar = "https://nfs.faireconomy.media/ff_calendar_thisweek.json"
# Adhoc date to add in event tracker
fomc_decision_date = [
    "2023-11-01",
    "2023-12-13",
    "2024-01-31",
    "2024-03-20",
    "2024-05-01",
    "2024-06-12",
    "2024-07-31",
    "2024-09-18",
    "2024-11-07",
    "2024-12-18",
    "2025-01-29"
    ]

# TV url
live_tv_url = "https://bloomberg.com/media-manifest/streams/us.m3u8"

# RSS Feeds Enable/Disable
enable_feed = true
feed_url = "https://www.dailyfx.com/feeds/market-news"

# Finnhub news fetcher
enable_finnhub = false
finnhub_api_key = ""
finnhub_news_category = "forex"

# web scraper
enable_scraper = false
scraper_page_url = ""
scraper_page_id = ""

########################################
###           CEFI SETTINGS          ###
########################################

# Enable/Disable CEFI
cex_enabled = true

########################################
###           DXSP SETTINGS          ###
########################################

# Enable/Disable DXSP
dxsp_enabled = true

# Header to use for retrieving urls content below
headers = {User-Agent= 'Mozilla/5.0'}

# DEX ABI to use in case you have no explorer setup
dex_erc20_abi_url = "https://raw.githubusercontent.com/Uniswap/interface/44c355c7f0f8ab5bdb3e0790560e84e59f5666f7/src/abis/erc20.json"

# token list using uniswap tokenlist format
# https://github.com/mraniki/tokenlist
# this can be used to avoid using coingecko
# or if token are not listed yet or for testnet
# token_mainnet_list = "https://raw.githubusercontent.com/mraniki/tokenlist/main/all.json"
# token_testnet_list = "https://raw.githubusercontent.com/mraniki/tokenlist/main/testnet.json"
token_mainnet_list = ""
token_testnet_list = ""
token_personal_list = "https://raw.githubusercontent.com/mraniki/tokenlist/main/TT.json"

#################################
###        MYLLM SETTINGS     ###
#################################
myllm_enabled = true

# [default.myllm.g4f]
# llm_library = "g4f" # options are bard, openai or g4f
# enabled = false # options are true or false to enable or disable the llm
# llm_model= "gpt-4-turbo" # model to use e.g. gpt-3.5-turbo, gpt-4, gpt-4-32k
# llm_provider = "g4f.Provider.Bing" # only for g4f. Refer to https://github.com/xtekky/gpt4free
# llm_provider_key = "" # only for bard and openai to pass either the cookie or the api key
# max_memory = 100 # Conversation history size
# timeout = 5 # time lag to wait ai response
# temperature = 0 # not used
# token_limit = 400 # not used
# llm_prefix = "🐻" # prefix use to filter the AI response
# llm_template = """
# You are a friendly AI helping me with 
# trade monitoring and execution.
# """

# [default.myllm.openai]
# enabled = false
# llm_library = "openai"
# llm_model= "gpt-3.5-turbo"
# llm_provider = "" 
# llm_provider_key = "DEADBEEF1234567890KEY"
# max_memory = 100 # Conversation history size
# timeout = 5 # time lag to wait ai response
# temperature = 0
# token_limit = 400
# llm_prefix = "" # prefix use to filter the AI response
# llm_template = """
# You are a friendly AI helping me with 
# trade monitoring and execution.
# """


########################################
###      CHAT PLATFORM SETTINGS      ###
########################################

# [default.platform.template]
# platform = ""
# enabled = false
# bot_token = ""
# bot_channel_id = ""
# bot_api_id = ""
# bot_api_hash = ""
# bot_hostname = ""
# bot_user = ""
# bot_pass = ""
# bot_auth_token = ""
# iteration_enabled = false
# iteration_limit = -1

# # discord example
# [default.platform.discord]
# platform="discord"
# enabled = true
# bot_token = "mytoken"
# bot_channel_id = "mychannelid"
# bot_api_id = ""
# bot_api_hash = ""
# bot_hostname = ""
# bot_user = ""
# bot_pass = ""
# bot_auth_token = ""
# iteration_enabled = false
# iteration_limit = -1

########################################
###           DEX SETTINGS          ###
########################################

# DEX template
# [default.dex.template]
# wallet_address = ""
# private_key = ""
# rpc = "" # https://chainlist.org for rpc url example
# protocol = "" # uniswap or 0x
# protocol_version = 2 # your protocol version | used for uniswap
# api_endpoint = "" # your api endpoint | used for 0x
# api_key = "" # your api key | used for 0x
# router_contract_addr = "" # your router contract address | used for uniswap
# factory_contract_addr = "" # your factory contract address | used for uniswap
# trading_asset_address = "" # your trading asset address
# trading_risk_percentage = true # Use risk amount as percetage of the balance or real amount
# trading_risk_amount = 10 # Risk amount
# trading_slippage = 2 # Slippage percentage
# trading_amount_threshold = 0 # Trading amount threshold
# block_explorer_url = "" # your block explorer url
# block_explorer_api = "" # your block explorer api
# mapping to use to change instrument per exchange
# mapping = [
# { id = "BTC", alt = "WBTC" },
# { id = "ETH", alt = "WETH" },
# { id = "GOLD", alt = "XAUT" },
# { id = "EURUSD", alt = "AgEUR" },
# ]

# # uniswap v2 protocol type and router uniswap
# [default.dex.eth]
# wallet_address = "0x1234567890123456789012345678901234567890"
# private_key = "0xdeadbeef88"
# rpc = "https://rpc.ankr.com/eth"
# protocol = "uniswap"
# protocol_version = 2
# api_endpoint = ''
# api_key = ""
# router_contract_addr = "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"
# factory_contract_addr = "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f"
# trading_risk_percentage = true
# trading_risk_amount = 10
# trading_slippage = 2
# trading_amount_threshold = 0
# trading_asset_address = "0xdAC17F958D2ee523a2206206994597C13D831ec7"
# trading_asset_separator = ""
# block_explorer_url = "https://api.etherscan.io/api?"
# block_explorer_api = "123123123123123"
# mapping = [
#     { id = "BTC", alt = "WBTC" },
# ]

# # uniswap v2 protocol type and router pancakeswap on BSC chain 56
# [default.dex.bsc]
# wallet_address = "0x1234567890123456789012345678901234567890"
# private_key = "0xdeadbeef88"
# rpc = "https://rpc.ankr.com/bsc"
# protocol = "uniswap"
# protocol_version = 2
# api_endpoint = ''
# api_key = ""
# router_contract_addr = "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"
# factory_contract_addr = "0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73"
# trading_risk_percentage = true
# trading_risk_amount = 10
# trading_slippage = 2
# trading_amount_threshold = 0
# trading_asset_address = "0xdAC17F958D2ee523a2206206994597C13D831ec7"
# trading_asset_separator = ""
# block_explorer_url = "https://api.bscscan.com/api?"
# block_explorer_api = "123123123123123"
# mapping = [
#     { id = "BTC", alt = "BTCB" },
# ]

# # uniswap v3 and router uniswap v3 on arbitrum chain
# [default.dex.arb]
# wallet_address = "0x1234567890123456789012345678901234567890"
# private_key = "0xdeadbeef88"
# rpc = "https://arbitrum.llamarpc.com"
# protocol = "uniswap"
# protocol_version = 3
# api_endpoint = ''
# api_key = ""
# router_contract_addr = ""
# factory_contract_addr = ""
# trading_risk_percentage = true
# trading_risk_amount = 10
# trading_slippage = 2
# trading_amount_threshold = 0
# trading_asset_address = "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9"
# trading_asset_separator = ""
# block_explorer_url = "https://api.arbiscan.io/api?"
# block_explorer_api = "123123123123123"
# mapping = [
#     { id = "BTC", alt = "WBTC" },
# ]

# # ZeroX 0x protocol type on polygon chain 137
# [default.dex.polygon]
# wallet_address = "0x1234567890123456789012345678901234567890"
# private_key = "0xdeadbeef88"
# rpc = "https://rpc.ankr.com/polygon"
# protocol = "0x"
# protocol_version = 4
# api_endpoint = "https://polygon.api.0x.org/"
# api_key = ""
# router_contract_addr = "0xdef1c0ded9bec7f1a1670819833240f027b25eff"
# factory_contract_addr = "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f"
# trading_risk_percentage = true
# trading_risk_amount = 10
# trading_slippage = 2
# trading_amount_threshold = 0
# trading_asset_address = "0xdAC17F958D2ee523a2206206994597C13D831ec7"
# trading_asset_separator = ""
# block_explorer_url = "https://api.polygonscan.com/api?"
# block_explorer_api = "123123123123123"
# mapping = [
#     { id = "BTC", alt = "WBTC" },
# ]

# # kwenta protocol type on OPTIMISM chain 10 
# [default.dex.opt]
# wallet_address = "0x1234567890123456789012345678901234567890"
# private_key = "0xdeadbeef88"
# rpc = "https://optimism.llamarpc.com"
# protocol = "kwenta"
# protocol_version = 2
# api_endpoint = ""
# api_key = ""
# router_contract_addr = "0xa062aE8A9c5e11aaA026fc2670B0D65cCc8B2858"
# factory_contract_addr = "0xF4c67CdEAaB8360370F41514d06e32CcD8aA1d7B"
# trading_risk_percentage = true
# trading_risk_amount = 1
# trading_slippage = 2
# trading_amount_threshold = 0
# trading_asset_address = "0x8c6f28f2F1A3C87F0f938b96d27520d9751ec8d9"
# trading_asset_separator = ""
# block_explorer_url = "https://optimistic.etherscan.com/api?"
# block_explorer_api = "123123123123123"
# mapping = [
#     { id = "BTC", alt = "WBTC" },
# ]

# # uniswap v3 protocol type using pancakeswap on zkSync chain 324 
# [default.dex.zkSync]
# wallet_address = "0x1234567890123456789012345678901234567890"
# private_key = "0xdeadbeef88"
# rpc = "https://zksync.drpc.org"
# protocol = "uniswap"
# protocol_version = 3
# api_endpoint = ""
# api_key = ""
# router_contract_addr = "0xD70C70AD87aa8D45b8D59600342FB3AEe76E3c68"
# factory_contract_addr = "0x1BB72E0CbbEA93c08f535fc7856E0338D7F7a8aB"
# trading_risk_percentage = true
# trading_risk_amount = 1
# trading_slippage = 2
# trading_amount_threshold = 0
# trading_asset_address = "0x8c6f28f2F1A3C87F0f938b96d27520d9751ec8d9"
# trading_asset_separator = ""
# block_explorer_url = "https://explorer.zksync.io/api?"
# block_explorer_api = "123123123123123"
# mapping = [
#     { id = "BTC", alt = "WBTC" },
# ]

########################################
###           CEX SETTINGS          ###
########################################

# CEFI template
# [default.cex.template]
# protocol = ""
# api_key= ""
# secret= ""
# password = ""
# testmode = true
# defaulttype = ""
# ordertype = ""
# leverage_type = ""
# leverage = 1
# trading_risk_percentage = true
# trading_risk_amount = 10
# trading_slippage = 2
# trading_amount_threshold = 0
# trading_asset = "USDT"
# trading_asset_separator = ""
# mapping = [
#     { id = "BTC", alt = "BTC/USDT" },
# ]
# balance_limit = false
# balance_limit_value = 10

# # CEFI example using ccxt binance
# protocol = "ccxt"
# api_key= ""
# secret= ""
# password = ""
# testmode = true
# defaulttype = "spot"
# ordertype = "market"
# leverage_type = "isolated"
# leverage = 1
# trading_risk_percentage = true
# trading_risk_amount = 10
# trading_slippage = 2
# trading_amount_threshold = 0
# trading_asset = "USDT"
# trading_asset_separator = ""
# mapping = [
#     { id = "BTC", alt = "BTC/USDT" },
# ]
# balance_limit = true
# balance_limit_value = 10

# [default.cex.capital]
# protocol = "capital"
# enabled = false
# user_id = "12345678"
# api_key= "myapi_DEADBEEF"
# password = "12345678"
# testmode = false
# defaulttype = ""
# ordertype = ""
# leverage_type = ""
# leverage = 1
# trading_risk_percentage = true
# trading_risk_amount = 10
# trading_slippage = 2
# trading_amount_threshold = 0
# trading_asset = "USD"
# trading_asset_separator = ""
# mapping = [
#     { id = "EURUSD", alt = "EURUSD" },
#     { id = "BTC", alt = "BTCUSD" },
#     { id = "ETH", alt = "ETHUSD" },
#     { id = "CRUDE", alt = "OIL_CRUDE" },
#     { id = "BRENT", alt = "OIL_BRENT" },
#     { id = "GOLD", alt = "GOLD" },
#     { id = "SILVER", alt = "SILVER" },
#     { id = "US500", alt = "US500" },
# ]
# balance_limit = false
# balance_limit_value = 10


########################################
###     END OF DEFAULT SETTINGS      ###
########################################

Settings Example#

Settings.toml#

########################################
###          EXAMPLE SETTINGS       ###
#######################################
# [default]
# loglevel = "INFO"
# ui_enabled = false

# DISCORD BOT on ethereum chain using 
# uniswap v2 router
    #[default.platform.main]
    # bot_token = '12122121'
    # bot_channel_id = '1221212'
    # apprise_url = 'discord://12121/121212'
    # [default.dex.uniswap]
    # wallet_address = ""
    # private_key = ""
    # rpc = "https://rpc.ankr.com/eth"
    # protocol = "uniswap"
    # protocol_version = 2
    # api_endpoint = ""
    # api_key = ""
    # router_contract_addr = "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"
    # factory_contract_addr = "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f"
    # trading_risk_percentage = true
    # trading_risk_amount = 10
    # trading_slippage = 2
    # trading_asset_address = "0xdAC17F958D2ee523a2206206994597C13D831ec7"
    # trading_asset_separator = ""
    # block_explorer_url = "https://api.etherscan.com/api?"
    # block_explorer_api = ""
    # mapping = [
    # { id = "BTC", alt = "WBTC" },
    # ]

# TELEGRAM BOT on CEX Binance
    #[default.platform.main]
    # bot_token = '121212121'
    # bot_channel_id = '-1122121'
    # bot_api_id = '1212912'
    # bot_api_hash = '121212121' 
    # apprise_url = 'tgram://121221/-11211212121'
    # [default.cex.binance]
    # name ="binance"
    # api_key= ''
    # secret = ''
    # password = ""
    # testmode = true
    # defaulttype = "spot"
    # ordertype = "market"
    # trading_risk_percentage = true
    # trading_risk_amount = 4
    # trading_slippage = 2
    # trading_asset = "USDT"
    # trading_asset_separator = ""
    # mapping = [
    # { id = "BTC", alt = "BTCUSDT" },
    # ]

#DISCORD BOT on BSC chain using pancakeswap v2 router
    #[default.platform.main]
    # bot_token = '1212121212121'
    # bot_channel_id = '121212121212'
    # apprise_url = 'discord://121121/1212212'
    # [default.dex.pancake]
    # wallet_address = ""
    # private_key = ""
    # rpc = "https://rpc.ankr.com/bsc"
    # protocol = "uniswap"
    # protocol_version = 2
    # api_endpoint = ""
    # api_key = ""
    # router_contract_addr = "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"
    # factory_contract_addr = "0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73"
    # trading_risk_percentage = true
    # trading_risk_amount = 10
    # trading_slippage = 2
    # trading_asset_address = "0x55d398326f99059ff775485246999027b3197955"
    # trading_asset_separator = ""
    # block_explorer_url = "https://api.bscscan.com/api?"
    # block_explorer_api = ""
    # mapping = [
    # { id = "BTC", alt = "BTCB" },
    # ]

#MATRIX BOT on Polygon chain using zerox protocol
    #[default]
    # bot_token = '12122121'
    # bot_channel_id = '12121212'
    # bot_hostname='matrix.org'
    # bot_user='itsme'
    # bot_pass='mario'
    # apprise_url = 'discord://1212121/1211212'
    # [default.dex.polygon]
    # wallet_address = ""
    # private_key = ""
    # rpc = "https://polygon.llamarpc.com"
    # protocol = "0x"
    # protocol_version = 4
    # api_endpoint = "https://polygon.api.0x.org"
    # api_key = ""
    # router_contract_addr = "0xdef1c0ded9bec7f1a1670819833240f027b25eff"
    # factory_contract_addr = "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f"
    # trading_risk_percentage = true
    # trading_risk_amount = 10
    # trading_slippage = 2
    # trading_asset_address = "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
    # trading_asset_separator = ""
    # block_explorer_url = "https://api.polygonscan.com/api?"
    # block_explorer_api = ""
    # mapping = [
    # { id = "BTC", alt = "WBTC" },
    # ]

.env or ENV VARS#

########################################
###          EXAMPLE SETTINGS        ###
########################################

# Below are examples for minimum setup
#
# If you use env vars, you need to
# prefix them with 'TT_'
# refer to example_settings.toml for
# toml setup and complete settings list

########################################
#             TELEGRAM BOT             #
#             on Binance               #
########################################
# TT_LOGLEVEL = 'INFO'
# TT_PLATFORM__MAIN__BOT_TOKEN = '121212121'
# TT_PLATFORM__MAIN__BOT_CHANNEL_ID = '-1122121'
# TT_PLATFORM__MAIN__BOT_API_ID = '1212912'
# TT_PLATFORM__MAIN__BOT_API_HASH = '121212121' 
# TT_APPRISE_URL = 'tgram://121221/-11211212121'
# TT_CEX__PRIMARY__NAME ="binance"
# TT_CEX__PRIMARY__API_KEY= ''
# TT_CEX__PRIMARY__SECRET = ''
# TT_CEX__PRIMARY__PASSWORD = ""
# TT_CEX__PRIMARY__TESTMODE = true
# TT_CEX__PRIMARY__DEFAULTTYPE = "spot"
# TT_CEX__PRIMARY__ORDERTYPE = "market"
# TT_CEX__PRIMARY__TRADING_RISK_PERCENTAGE = true
# TT_CEX__PRIMARY__TRADING_RISK_AMOUNT = 4
# TT_CEX__PRIMARY__TRADING_SLIPPAGE = 2
# TT_CEX__PRIMARY__TRADING_ASSET = "USDT"
# TT_CEX__PRIMARY__TRADING_ASSET_SEPARATOR = ""
# TT_CEX__PRIMARY__MAPPING = [{ id = "BTC", alt = "BTCUSDT" },]

Config#

TalkyTrader Settings, Scheduling and Logging,: 🧐⏱️⚙️

tt.config.settings = <dynaconf.base.LazySettings object>#

Scheduling is managed via asyncz lib More info: tarsil/asyncz

It allows you to schedule tasks at plugin level. Refer to the plugin documentation tt.plugins.plugin_manager

tt.config.scheduler = AsyncIOScheduler(global_config={}, trigger_plugins={'date': 'asyncz.triggers.date:DateTrigger', 'interval': 'asyncz.triggers.interval:IntervalTrigger', 'cron': 'asyncz.triggers.cron.trigger:CronTrigger', 'and': 'asyncz.triggers.date:DateTrigger', 'or': 'asyncz.triggers.combining:OrTrigger'}, trigger_classes={}, executor_plugins={'debug': 'asyncz.executors.debug:DebugExecutor', 'threadpool': 'asyncz.executors.pool:ThreadPoolExecutor', 'processpool': 'asyncz.executors.pool:ProcessPoolExecutor', 'asyncio': 'asyncz.executors.asyncio:AsyncIOExecutor'}, executor_classes={}, store_plugins={'memory': 'asyncz.stores.memory:MemoryTaskStore', 'mongo': 'asyncz.stores.mongo:MongoDBStore', 'redis': 'asyncz.stores.redis:RedisStore'}, store_classes={}, executors={}, executor_lock=<unlocked _thread.RLock object owner=0 count=0>, stores={}, store_lock=<unlocked _thread.RLock object owner=0 count=0>, listeners=[], listeners_lock=<unlocked _thread.RLock object owner=0 count=0>, pending_tasks=[], state=<SchedulerState.STATE_STOPPED: 0>, logger=<loguru.logger handlers=[(id=1, level=10, sink=<stdout>)]>, event_loop=None, timezone=_PytzShimTimezone(zoneinfo.ZoneInfo(key='Etc/UTC'), 'Etc/UTC'), store_retry_interval=10.0, task_defaults=TaskDefaultStruct(mistrigger_grace_time=None, coalesce=True, max_instances=1), timeout=None)#: Logging is managed via loguru

class tt.config.InterceptHandler(level=0)[source]#

InterceptHandler is a loguru handler that intercepts all log records. It can be used as a replacement for logging.basicConfig()

Initializes the instance - basically setting the formatter to None and the filter list to empty.

emit(record)[source]#

Emit a log record.

Parameters:: record (logging.LogRecord) – The log record to emit.
Returns:: None

tt.config.loguru_setup()[source]#

Set up the loguru logger with custom configurations.

Returns:: The configured loguru logger instance.
Return type:: loguru.logger