Metadata-Version: 2.4
Name: smartbindb
Version: 5.17.5
Summary: Blazing-fast offline BIN (Bank Identification Number) lookup database with hundreds of thousands of records bundled.
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
Author-email: Abir Arafat Chawdhury <abirxdhackz@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: bank,bin,card,fintech,iban,lookup,offline,smartbindb
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
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
Requires-Dist: pycountry-convert>=0.7.2
Requires-Dist: pycountry>=22.3.5
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: hatch; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=4.1; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Provides-Extra: docs
Requires-Dist: furo>=2024.1.29; extra == 'docs'
Requires-Dist: sphinx-copybutton>=0.5.2; extra == 'docs'
Requires-Dist: sphinx>=7.0; extra == 'docs'
Description-Content-Type: text/markdown

# 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
