🏦 insnc — Alfa-Bank Web API CLI

insnc is a command-line tool for accessing your Alfa-Bank account data via the web API used by insnc.by.

---

🚀 Features

• 🔐 Secure login using environment variables
• 📜 Get transaction history
• 📜 Get cards balance
• 💼 Get information about your service package
• 🎁 Get information about your loyalty program (status and history)
• 💳 Get information about your credits
• 📊 Export to Excel with categorized operations:
  • Приход (Income)
  • Расход (Expense)
  • Перевод (Transfer)
  • Конвертация (Currency exchange)

---

🛠 Setup

1. Clone and install

git clone https://github.com/cndctr/insnc.git
cd insnc
pip install -r requirements.txt

You can install it locally using pip

cd insnc
pip install --editable .

Or just download the latest executable from releases page.

2. Configure

Edit config.json

{
  "ALFA_LOGIN": "", # Insert your login
  "ALFA_AUTH": "", # Insert your base64 encoded credentials (login:password)
  "X-Client-App": "desktop/Windows--NT 10.0 10/Firefox--138.0", # Change to your browser value
  "X-Dev-ID": "de040169-0d6c-40e3-b621-a783bf350422" # Change to your value
}

How to get base64 encoded credentials?

• You can use base64decode.org to encode your credentials pair - login:password
• You can use powershell oneliner (recommended)

[convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("login:password"))

How to get "X-Client-App" and "X-Dev-ID"?

1. When you log in to insnc.by in your browser for the first time, the bank will prompt you with the second step of 2FA and display a QR code on the screen.
   You must scan this code using the Insync mobile app — this authorizes the new device and browser. After successful login, you can capture the required parameters as follows:
2. Open insnc.by in your browser and open Developer Tools (Ctrl+Shift+I). Switch to the Network tab.
3. Enter your login and click "Продолжить". You should see some network activity.
4. Look for the POST request related to login credentials — select it.
5. In the Request Headers, find X-Client-App and X-Dev-ID. Copy these values and paste them into your config.json file. Example:

What if you don't want to store your credentials in config.json?

• Then set environment variables:

setx ALFA_LOGIN "your_login"
setx ALFA_AUTH "base64encoded_credentials"

---

🧪 Usage

# Fetch 50 recent operations
python main.py --history

# Fetch 20 recent operations and export them to Excel
python main.py -si 20 -e .\history.xlsx

# Get cards' balance
python main.py --balance

# Fetch loyalty program status and history
python main.py --loyalty_status --loyalty_history

Or after setup using pip locally:

insnc --history --items 20
insnc --credits

---

📝 License

MIT — free for personal & educational use.