ACB Unofficial API Client

This project provides an unofficial Python client for interacting with the Asia Commercial Joint Stock Bank (ACB) API. It allows you to authenticate, fetch account balances, and retrieve transaction history. Ideal for shops or personal use to integrate ACB transaction notification features into your applications.

How It Works

The client uses the requests library to make HTTP requests to ACB's endpoints. It handles authentication, session management, and data retrieval. The api_key, client_id, and x-converstation-id were derived from the ACB repo.

Features

• Authenticate with ACB using your username and password
• Fetch balances for all payment accounts
• Retrieve transaction history for a specific account

Requirements

• Python 3.7+
• requests library
• python-dotenv library

Installation

1. Clone the repository.

2. Install dependencies:

   pip install -r requirements.txt

3. Change .env.example to .env and fill in your ACB credentials to make sure you won't reveal your credentials:

   ACB_USERNAME=your_username
   ACB_PASSWORD=your_password
   

Usage

Run the main script to fetch your account balances and recent transactions:

python main.py

Example Output

By default, the script will print your account balances and the last 5 transactions for your first account.

Environment Variables

• ACB_USERNAME: Your ACB account username
• ACB_PASSWORD: Your ACB account password

Pull Requests

Feel free to submit pull requests for improvements or bug fixes.

Plans

• Turn this into a package maybe?
• Make a Discord/Telegram bot to notify about transactions.
• Add more features as needed.
• Write tests.

Credits

• Based on anhnmt/ACB (many thanks!)
• Another trivial repos that I can't remember..

Disclaimer

This is an unofficial client and is not affiliated with ACB. Use at your own risk. I won't be responsible for any issues arising from its use.