Azurro (Snappi 2.0)

Azuro-only betting bot — separate project and venv from Snappi. Uses same Sentry/colour/unit concepts; writes to AzuroSnaps sheet; places bets via Azuro relayer.

Telegram bot commands

Send these to the Azurro Telegram bot (when main.py is running):

Command	Description
/status	Thorold time, Hunter phase (05:00–00:00), USDT balance from relayer.
/livecheck	Number of live football games from Azuro data-feed; sample match.

No other slash commands are implemented in Azurro. (Snappi has additional commands such as /pause, /accept, /rejections, /logs, /livecheck, etc.; those are not in Azurro.)

Subgraph and placing bets

• Data-feed (live games): Uses AZURO_SUBGRAPH_URL; default is https://thegraph-1.onchainfeed.org/subgraphs/name/azuro-protocol/azuro-data-feed-polygon. Schema: Game.state = Live, startsAt, Condition.state (Active/Stopped), Outcome.currentOdds.
• Flow: Fetch live football → resolve Under outcome (conditionId, outcomeId, odds) → relayer place_bet. When a live game has Active (or Stopped) conditions with Under markets, the bot can place. If the subgraph only returns Resolved conditions at that moment, no bet is placed until Active conditions appear.

Setup

• .venv already created. Activate: source .venv/bin/activate
• Fill .env: AZURO_WALLET_ADDRESS, AZURO_PRIVATE_KEY, AZURO_*, Telegram, Gemini, API_FOOTBALL_KEY, AzuroSnaps sheet vars. Keep .env out of git (sensitive keys).
• Core modules azuro_relayer, azuro_executor, azuro_integration, azuro_live_feed are not in this repo (they were never in git). Recover from backup or reimplement from Azuro docs; place them in this directory so main.py can import them.

Run

• Standalone scripts (work without full bot):
  • ./.venv/bin/python scripts/azuro_list_bets.py — list recent bets
  • ./.venv/bin/python scripts/azuro_check_allowance.py — check USDT balance and relayer allowance
  • ./.venv/bin/python scripts/azuro_approve_relayer.py — approve relayer to spend USDT
  • ./.venv/bin/python debug_conditions.py — subgraph conditions check
• Full bot: After adding the missing modules, run ./.venv/bin/python main.py (or wire a Hunter loop in main.py that uses azuro_integration + executor + notifier + AzuroSnaps).

Optional systemd

[Unit]
Description=Azurro Azuro Betting Bot
After=network-online.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/home/ubuntu/Azurro
ExecStart=/home/ubuntu/Azurro/.venv/bin/python -u main.py
Restart=always
RestartSec=15
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

Save as azurro.service, then: sudo cp azurro.service /etc/systemd/system/ && sudo systemctl daemon-reload && sudo systemctl enable azurro && sudo systemctl start azurro.