Get Started with the Wallgent Python SDK

pip install wallgent

from wallgent import Wallgent

wg = Wallgent(api_key="wg_test_your_key_here")

# Create a wallet
wallet = wg.wallets.create(name="my-agent", agent_name="demo-bot")
print(f"Wallet: {wallet.id}")

# Fund it
wg.wallets.fund(wallet.id, amount="100.00")

txn = wg.payments.send(
    from_wallet=wallet.id,
    to_wallet="wal_vendor_01",
    amount="25.00",
    description="API subscription",
)
print(f"Payment: {txn.id} — {txn.state}")

balance = wg.wallets.get_balance(wallet.id)
print(f"Available: ${balance.available}")
print(f"Pending:   ${balance.pending}")

from wallgent.exceptions import InsufficientFundsError, PolicyDeniedError

try:
    wg.payments.send(
        from_wallet=wallet.id,
        to_wallet="wal_vendor_01",
        amount="999999.00",
    )
except InsufficientFundsError as e:
    print(f"Not enough funds: {e.available} available")
except PolicyDeniedError as e:
    print(f"Blocked by policy: {e.policy_name} — {e.reason}")

import asyncio
from wallgent import AsyncWallgent

async def main():
    wg = AsyncWallgent(api_key="wg_test_your_key_here")
    balance = await wg.wallets.get_balance("wal_ops")
    print(f"Available: ${balance.available}")

asyncio.run(main())

import requests

API_KEY = "wg_test_your_key_here"
BASE = "https://api.wallgent.com"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# Create a wallet
resp = requests.post(f"{BASE}/v1/wallets", headers=HEADERS, json={"name": "my-agent"})
wallet = resp.json()

# Fund it
requests.post(f"{BASE}/v1/wallets/{wallet['id']}/fund", headers=HEADERS, json={"amount": "100.00"})

# Send a payment
resp = requests.post(
    f"{BASE}/v1/payments",
    headers=HEADERS,
    json={"from": wallet["id"], "to": "wal_vendor_01", "amount": "25.00"},
)
print(resp.json())