Ledgersys is the
tax layer for
AI agents.

import requests
import uuid

API_KEY = "sandbox_sk_your_key_here"
BASE_URL = "https://api.ledgersys.live/v1"

class LedgersysAgent:
    def __init__(self, api_key: str):
        self.headers = {
            "X-API-Key": api_key,
            "Content-Type": "application/json"
        }

    def record_trade(self, trade_type: str, amount_btc: float, value_usd: float, date: str):
        """Record a Bitcoin transaction via API with idempotency key."""
        response = requests.post(
            f"{BASE_URL}/transactions",
            json={
                "date": date,
                "type": trade_type,
                "amount_btc": amount_btc,
                "value_usd": value_usd
            },
            headers={
                **self.headers,
                "Idempotency-Key": str(uuid.uuid4())
            }
        )
        return response.json()

    def get_tax_liability(self, jurisdiction: str = "ZA"):
        """Get current tax obligation in real time via API."""
        response = requests.get(
            f"{BASE_URL}/tax",
            params={"jurisdiction": jurisdiction, "method": "FIFO"},
            headers=self.headers
        )
        return response.json()

    def generate_report(self, tax_year: int):
        """Generate audit-ready tax report for human owner via API."""
        response = requests.get(
            f"{BASE_URL}/reports/tax",
            params={"tax_year": tax_year, "format": "pdf"},
            headers=self.headers
        )
        return response.content


# Usage
agent = LedgersysAgent(API_KEY)

# After your agent makes a Bitcoin trade:
agent.record_trade("buy", amount_btc=0.01, value_usd=850, date="2026-04-25")

# Check tax exposure:
tax = agent.get_tax_liability(jurisdiction="ZA")
print(f"Current tax obligation: ${tax['tax_obligation']}")

# End of tax year — generate report for human:
pdf = agent.generate_report(tax_year=2026)
with open("tax_report_2026.pdf", "wb") as f:
    f.write(pdf)