🔥 FreeFire Info API (OB55) 🔥

A lightweight, fast & secure API for fetching Free Fire player profiles
_{Built with Flask • Powered by AES-CBC Encryption • Backed by Protobuf Serialization}

---

⚡ Overview

This project exposes a Free Fire Player Info API (OB55-ready) that:

• Retrieves player profiles by UID
• Handles token refresh automatically
• Uses AES-CBC encryption & Protobuf serialization
• Runs asynchronously via Flask for maximum performance

---

🧠 Core Features

✅ Encrypted Communication — AES-CBC protocol for secure request handling
✅ Protobuf Serialization — Lightweight, binary-efficient data exchange
✅ In-Memory Token Cache — Fast performance with lifecycle management
✅ Async Flask Server — Works with Gunicorn, Uvicorn, or any WSGI server
✅ Auto Refresh — Periodic background token renewal

---

🔗 API Endpoints

Endpoint	Method	Description
/get?uid=<PLAYER_UID>&region_group=GLOBAL	GET	Fetch player profile data
/region?uid=<PLAYER_UID>&region_group=GLOBAL	GET	Fetch player region and nickname
/refresh	GET	Manually refresh all region tokens

Example Usage

GET /get?uid=123456789&region_group=GLOBAL

Response

{
  "AccountInfo": {
    "AccountName": "LegendX",
    "AccountLevel": 65,
    "AccountRegion": "AS",
    "AccountLikes": 2400
  },
  "BanStatus": {
    "isBanned": false,
    "reason": null
  }
}

---

🧩 Architecture

├── app.py              # Flask async app
├── core/
│   ├── encryption.py   # AES-CBC encrypt/decrypt
│   ├── protobuf.py     # Protobuf serializer/deserializer
│   └── token_cache.py  # Token cache + lifecycle
├── static/
│   └── logo.png
├── requirements.txt
└── README.md

---

⚙️ Installation & Setup

1️⃣ Clone Repository

git clone https://github.com/TSun-FreeFire/TSun-FF-Info-API.git
cd TSun-FF-Info-API

2️⃣ Install Dependencies

pip install -r requirements.txt

3️⃣ Run the Local Dev Server

python app.py

4️⃣ Run in Production

Use a production WSGI server instead of Flask's development server.

Linux/macOS:

gunicorn "wsgi:app" --bind 0.0.0.0:${PORT:-5000}

Windows:

waitress-serve --listen=0.0.0.0:5000 wsgi:app

---

🧠 Contributing

Contributions are welcome & appreciated! Follow these steps:

1. Fork this repository
2. Create a new branch (feature/new-feature)
3. Commit your changes
4. Push to your fork and open a Pull Request

⚠️ Do not commit credentials or tokens. ✅ Add tests where possible.

---

🧾 License & Author

• Author: @Saeedxdie
• License: MIT (recommended)
• *Made with 💀 by TSun Studio

---

🧰 Tech Stack

Component	Description
Python	Core language
Flask	Backend framework
Protobuf	Data serialization
AES-CBC	Encryption algorithm
Gunicorn/Uvicorn	Deployment-ready ASGI/WGSI servers

---

💬 Support & Community

💌 Discord: Coming soon

🐞 Report Bug: Issues

⭐ Star this repo if you like it — it keeps the project alive!

---

🚀 — FreeFire Info API