credex-sdk 0.1.0

Official Python SDK for the CredEx AI Exchange — the financial exchange for AI compute on XRPL

credex-sdk

The official Python SDK for the CredEx AI platform — the financial exchange for AI compute on the XRP Ledger.

Installation

pip install credex-sdk

Quick Start

from credex import CredExClient

client = CredExClient(api_key="your-api-key")

# ── Exchange ──────────────────────────────────────
orderbook = client.exchange.get_orderbook("openai")
print(f"Best bid: {orderbook['best_bid']} CREDX")
print(f"Best ask: {orderbook['best_ask']} CREDX")

# Place a limit order
order = client.exchange.place_order(
    provider="anthropic",
    side="buy",
    amount=100,
    price=0.85,
)

# ── Marketplace ───────────────────────────────────
agents = client.marketplace.list_agents(tier="platinum")

# Hire an agent
job = client.marketplace.hire_agent(
    agent_id=42,
    description="Summarize quarterly earnings",
    max_cost=5.0,
)

# ── x402 Services ─────────────────────────────────
result = client.services.call(
    service_id=1,
    payload={"text": "Your document here..."},
)
print(f"Cost: {result['cost']} CREDX")

# ── Derivatives ───────────────────────────────────
futures = client.derivatives.list_futures(provider="openai")

position = client.derivatives.open_position(
    contract_id=futures[0]["id"],
    side="long",
    size=1000,
    leverage=10,
)

# ── Lending ───────────────────────────────────────
rate = client.lending.get_rate()
print(f"Your APR: {rate['apr']}% ({rate['tier']} tier)")

# ── Analytics ─────────────────────────────────────
index = client.analytics.get_index("CRAI-50")
print(f"CRAI-50: {index['value']}")

Async Support

from credex import AsyncCredExClient

async def main():
    client = AsyncCredExClient(api_key="your-api-key")
    orderbook = await client.exchange.get_orderbook("openai")
    agents = await client.marketplace.list_agents()
    await client.close()

Authentication

# Option 1: API key
client = CredExClient(api_key="your-api-key")

# Option 2: Environment variable (CREDEX_API_KEY)
client = CredExClient()

# Option 3: Email/password login
client = CredExClient(base_url="https://credexai.live/api")
client.login("[e-mail]", "password")

Project Structure

credex-sdk-python/
├── credex/
│   ├── __init__.py         # Exports
│   ├── client.py           # CredExClient & AsyncCredExClient
│   ├── exchange.py         # Credit exchange
│   ├── marketplace.py      # Agent marketplace
│   ├── services.py         # x402 services
│   ├── derivatives.py      # Futures & options
│   ├── lending.py          # Lending
│   ├── staking.py          # Staking
│   ├── analytics.py        # Benchmarks & indices
│   ├── governance.py       # Governance
│   └── exceptions.py       # Error types
├── examples/
│   ├── basic_trading.py
│   ├── hire_agent.py
│   ├── x402_service_call.py
│   ├── hedge_compute.py
│   └── async_example.py
├── tests/
├── pyproject.toml
├── README.md
└── LICENSE

Requirements

• Python 3.9+
• httpx for HTTP requests (sync + async)

Links

• API Documentation
• CredEx Platform
• TypeScript SDK
• Twitter

License

MIT License — see LICENSE for details.