Python SDK

pip install dual-sdk

import os
from dual_sdk import DualClient

client = DualClient(
    token=os.environ["DUAL_API_KEY"],
    auth_mode="api_key",
)

# Returns a typed Wallet model
wallet = client.wallets.me()
print(wallet.id, wallet.email)

# Returns PaginatedResponse[Template]
page = client.templates.list(limit=20)
for tmpl in page.items:
    print(tmpl.name)

# Mint an object via the Event Bus
result = client.event_bus.execute(
    action={"mint": {"template_id": "tmpl_abc123", "custom": {"name": "My First Token"}}}
)
print(result.action_id)

import asyncio
from dual_sdk import AsyncDualClient

async def main():
    async with AsyncDualClient(token=os.environ["DUAL_API_KEY"], auth_mode="api_key") as client:
        wallet = await client.wallets.me()
        templates = await client.templates.list(limit=20)

        # Concurrent requests
        import asyncio
        results = await asyncio.gather(
            client.objects.list(limit=10),
            client.templates.list(limit=10),
            client.organizations.list(limit=10),
        )

asyncio.run(main())

from dual_sdk import DualClient

# API key auth (default)
client = DualClient(
    token=os.environ["DUAL_API_KEY"],
    auth_mode="api_key",
    base_url="https://gateway-48587430648.europe-west6.run.app",  # default
    timeout=10.0,       # seconds
    max_retries=3,      # retry on 429/5xx
    backoff=1.0,        # exponential backoff base
)

# JWT bearer token auth
jwt_client = DualClient(
    token=os.environ["DUAL_JWT"],
    auth_mode="bearer",
)

from dual_sdk import DualClient, DualError, DualAuthError, DualRateLimitError

client = DualClient(token=os.environ["DUAL_API_KEY"], auth_mode="api_key")

try:
    wallet = client.wallets.me()
except DualAuthError as e:
    print(f"Auth failed [{e.status}]: {e.code}")
except DualRateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except DualError as e:
    print(f"API error [{e.status}]: {e.message}")
    print("Details:", e.body)