Metadata-Version: 2.4
Name: smartbindb
Version: 5.17.3
Summary: Blazing-fast offline BIN (Bank Identification Number) lookup database with hundreds of thousands of records bundled.
Author-email: Abir Arafat Chawdhury <abirxdhackz@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/abirxdhack/TheSmartBinDB
Project-URL: Documentation, https://abirxdhack.github.io/TheSmartBinDB
Project-URL: Repository, https://github.com/abirxdhack/TheSmartBinDB
Project-URL: Issues, https://github.com/abirxdhack/TheSmartBinDB/issues
Project-URL: Changelog, https://github.com/abirxdhack/TheSmartBinDB/releases
Keywords: bin,bank,card,lookup,offline,smartbindb,fintech,iban
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pycountry>=22.3.5
Requires-Dist: pycountry-convert>=0.7.2
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: pytest-cov>=4.1; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=7.0; extra == "docs"
Requires-Dist: furo>=2024.1.29; extra == "docs"
Requires-Dist: sphinx-copybutton>=0.5.2; extra == "docs"
Dynamic: license-file

# SmartBinDB

[![PyPI version](https://img.shields.io/pypi/v/smartbindb.svg)](https://pypi.org/project/smartbindb/)
[![Python versions](https://img.shields.io/pypi/pyversions/smartbindb.svg)](https://pypi.org/project/smartbindb/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Docs](https://img.shields.io/badge/docs-online-blue)](https://abirxdhack.github.io/TheSmartBinDB)

> Blazing-fast **offline** Bank Identification Number (BIN) lookup database for Python.

SmartBinDB ships with a bundled binary database covering hundreds of thousands of
card BINs across the globe and provides a simple async API to look them up by
BIN, issuing bank or country — with **zero network calls**.

## Installation

```bash
pip install smartbindb
```

## Quick start

```python
import asyncio
from smartbindb import SmartBinDB

db = SmartBinDB()

async def main():
    print(await db.get_bin_info("457173"))
    print(await db.get_bins_by_bank("Chase", limit=5))
    print(await db.get_bins_by_country("BD", limit=10))

asyncio.run(main())
```

## Documentation

Full API documentation, tutorials, integration guides (FastAPI, Flask, Django,
Telegram bots) and examples live at:
<https://abirxdhack.github.io/TheSmartBinDB>

## Links

- Repository: <https://github.com/abirxdhack/TheSmartBinDB>
- PyPI: <https://pypi.org/project/smartbindb/>
- Issues: <https://github.com/abirxdhack/TheSmartBinDB/issues>

## License

MIT © Abir Arafat Chawdhury
