xfinance Python SDK

Official Python SDK for X-Finance API - Comprehensive financial calculations for Python applications.

Overview

The xfinance Python SDK provides a comprehensive interface to the X-Finance API, offering robust financial calculation capabilities including compound interest, loan payments, investment returns, and more.

Key Features:

• Compound Interest Calculations: Flexible compounding with custom frequencies

• Loan Payment Calculations: Mortgage and loan amortization support

• Investment Returns: Future value projections with regular contributions

• Async Support: Non-blocking asynchronous operations

• Type Safety: Full Pydantic validation with type hints

• Error Handling: Comprehensive exception hierarchy

• Authentication: API key and JWT token support

Quick Installation

pip install xfinance-python-sdk

Basic Usage

from xfinance_sdk import XFinanceClient
from xfinance_sdk.models.request import CompoundInterestRequest
from decimal import Decimal

# Initialize client
client = XFinanceClient(api_key="your-api-key")

# Calculate compound interest
request = CompoundInterestRequest(
    principal=Decimal("10000"),
    annual_rate=Decimal("0.05"),
    years=10,
    compounding_frequency=12
)

response = client.calculate_compound_interest(request)
print(f"Final amount: ${response.final_amount:,.2f}")

Getting Help

• GitHub Repository

• Issue Tracker

• PyPI Package

License

MIT License - See LICENSE file for details.