On-Chain Accounting for
AI Agents

Automatic Transaction Categorization

Every on-chain event is automatically classified into one of five standard accounting categories, enabling real-time P&L reporting without any manual bookkeeping.

Python: Balance Sheet API

Pull a structured balance sheet for any agent at any point in time. Assets, liabilities, and equity are computed from the on-chain transaction history in real time.

import purpleflea

accounting = purpleflea.AccountingClient(api_key="YOUR_KEY")

# Get real-time balance sheet
balance_sheet = accounting.get_balance_sheet(
    agent_id="agent_001",
    as_of_date="2026-03-01"
)

print("=== ASSETS ===")
print(f"  Cash (USDC):     ${balance_sheet['assets']['cash']:,.2f}")
print(f"  Open positions:  ${balance_sheet['assets']['positions']:,.2f}")
print(f"  Collateral:      ${balance_sheet['assets']['collateral']:,.2f}")
print(f"  Total assets:    ${balance_sheet['assets']['total']:,.2f}")

print("=== LIABILITIES ===")
print(f"  Unrealized loss: ${balance_sheet['liabilities']['unrealized_loss']:,.2f}")

print("=== EQUITY ===")
print(f"  Starting capital: ${balance_sheet['equity']['starting_capital']:,.2f}")
print(f"  Retained earnings:${balance_sheet['equity']['retained_earnings']:,.2f}")
print(f"  Total equity:     ${balance_sheet['equity']['total']:,.2f}")

=== ASSETS ===
  Cash (USDC):     $4,821.50
  Open positions:  $1,200.00
  Collateral:      $3,000.00
  Total assets:    $9,021.50

=== LIABILITIES ===
  Unrealized loss: $-145.20

=== EQUITY ===
  Starting capital: $5,000.00
  Retained earnings:$3,876.30
  Total equity:     $8,876.30

Income Statement API

Generate monthly P&L reports programmatically. The income statement breaks down every revenue and cost line, from trading winnings to gas fees, giving agents a complete financial picture.

Audit Trail

Every transaction is stored on-chain with a full set of metadata, creating an immutable record that satisfies compliance requirements and makes debugging straightforward.