Metadata-Version: 2.4
Name: apibank-ai
Version: 1.3.0
Summary: SDK oficial de API Bank AI Empire: Banca autónoma M2M, emisión de tarjetas Visa/Mastercard y KYA para Agentes IA.
Home-page: https://www.apibankaiempire.com
Author: API Bank AI Empire & IC Neural Systems LLC
Author-email: developers@apibankaiempire.com
Project-URL: Documentation, https://www.apibankaiempire.com/developers
Project-URL: Source, https://github.com/cep1122/api-bank-ai
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.1
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# API Bank AI - Python SDK (apibank-ai)

[![PyPI version](https://img.shields.io/pypi/v/apibank-ai.svg?color=emerald)](https://pypi.org/project/apibank-ai/)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**API Bank AI** es la plataforma bancaria y de liquidación fiduciaria autónoma diseñada específicamente para **Agentes de Inteligencia Artificial**, enjambres multi-agente y sistemas M2M (Machine-to-Machine).

Permite a cualquier modelo LLM (Claude, GPT, Gemini, Llama, LangChain, AutoGen) tener su propia **cuenta bancaria soberana**, emitir **tarjetas virtuales Visa/Mastercard**, presentar **pasaportes de identidad KYA (Know Your Agent)** y liquidar transacciones en milisegundos con dinero real o cripto-activos.

---

## ⚡ Instalación Rápida

```bash
pip install apibank-ai
```

---

## 🚀 Inicio Rápido (3 Minutos)

```python
from apibank import APIBankClient

# 1. Conectar con la red API Bank AI Empire
client = APIBankClient(api_key="tu_api_key_soberana")

# 2. Consultar balance de la bóveda
wallet = client.get_wallet()
print(f"Bóveda ID: {wallet['id']} | Balance: {wallet['balance']} CRD")

# 3. Emitir Tarjeta Virtual Visa para compras online del Agente
card = client.issue_virtual_card(
    daily_limit=2500.0,
    monthly_limit=25000.0,
    cardholder_name="CENTURION AGENT 01",
    brand="VISA"
)
print(f"Tarjeta creada: {card['pan_masked']} Expira: {card['exp_date']}")

# 4. Emitir Pasaporte Criptográfico KYA (Know Your Agent)
kya = client.issue_kya_passport(
    agent_name="Autonomous-Trading-Unit",
    daily_spend_limit_crd=10000.0
)
print(f"KYA Token: {kya['kya_token'][:30]}... Sello: {kya['cryptographic_seal']}")
```

---

## 🛠️ Capacidades Principales

### 1. Emisión de Tarjetas Virtuales BaaS (Visa & Mastercard)
- Emisión instantánea de PANs con verificación de algoritmo de Luhn.
- Push-provisioning listo para **Apple Pay** y **Google Wallet** (`.pkpass`).
- Congelamiento instantáneo en 1-clic (`toggle_freeze_card`) para defensa antifraude.
- Ajuste dinámico de límites diarios y mensuales.

### 2. Protocolo KYA (Know Your Agent) & x402
- Pasaportes de identidad de reputación algorítmica para agentes.
- Puntuación de crédito AI (300 a 850) calculada en tiempo real.
- Verificación criptográfica HMAC-SHA256 para interactuar con APIs sin riesgo de sybil-attacks.

### 3. Escrow Covenants M2M
- Bloqueo de fondos condicional entre agentes (`escrow_lock`).
- Liberación atómica por oráculos verificadores (`escrow_release`).
- Reembolso automático si no se cumplen las condiciones (`escrow_refund`).

### 4. Micro-Préstamos Flash & Préstamos de Liquidez
- Ejecución de flash-loans atómicos en un solo ciclo de ejecución para arbitraje estadístico.

---

## 📋 Requisitos y Soporte

- Python 3.8 o superior
- Conexión a internet a la API pública de API Bank AI (`https://api-bank-ai.vercel.app` o servidor privado)

Documentación completa y dashboard interactivo: [https://www.apibankaiempire.com/developers](https://www.apibankaiempire.com/developers)
