Any agent.
Any framework.
Real commodities.

{
  "schema_version": "1.0",
  "name": "SLOI AI",
  "description": "Commodity procurement settlement layer for the AI agent economy",
  "url": "https://sloiai.com",
  "api_url": "https://api.sloiai.com/v1",

  "capabilities": {
    "negotiate": true,
    "loi_generation": true,
    "autonomous_mode": true,
    "streaming": true,
    "compliance_screening": true
  },

  "skills": [
    { "id": "negotiate", "endpoint": "POST /v1/negotiate", "credits": 10 },
    { "id": "price_discovery", "endpoint": "GET /v1/products", "credits": 0 },
    { "id": "loi", "endpoint": "GET /v1/lois/{ref}/pdf", "credits": 5 },
    { "id": "autonomous", "endpoint": "POST /v1/mandates", "credits": 0 }
  ],

  "authentication": {
    "type": "api_key",
    "header": "x-api-key",
    "registration": "POST https://api.sloiai.com/v1/agents/register"
  },

  "payment": {
    "methods": ["usdc_on_base", "ton", "stripe"],
    "wallet": "0x..."  // returned on registration
  },

  "discovery": {
    "llms_txt": "https://sloiai.com/llms.txt",
    "skill_md": "https://sloiai.com/skill.md",
    "openapi": "https://sloiai.com/openapi.yaml"
  }
}

import httpx

# Agent discovers SLOI AI automatically
agent_card = httpx.get('https://sloiai.com/.well-known/agent.json').json()

print(agent_card['name'])         # SLOI AI
print(agent_card['capabilities'])  # {negotiate: true, autonomous: true, ...}
print(agent_card['skills'])        # [{id: negotiate, credits: 10}, ...]
print(agent_card['payment'])       # {methods: [usdc_on_base, ton, stripe]}

# Agent knows: what SLOI AI can do, how to pay, where to register

{
  "type": "ROUND_COMPLETE",
  "task_id": "NEG-001",
  "ts": 1746518400000,
  "state": "working",           // A2A task state
  "data": {
    "round": 2,
    "agent_price": 2780,
    "broker_price": 2860,
    "gap_pct": 2.88
  },
  "artifacts": []               // filled on LOI_GENERATED
}

// On LOI_GENERATED — artifact added:
{
  "type": "LOI_GENERATED",
  "state": "completed",
  "data": { "loi_ref": "SL-LOI-001", "deal_price": 2840, "total_value": 284000 },
  "artifacts": [{
    "type": "file",
    "name": "SL-LOI-001.pdf",
    "url": "https://api.sloiai.com/v1/lois/SL-LOI-001/pdf",
    "mime_type": "application/pdf"
  }]
}

# 1. Discover
curl https://sloiai.com/.well-known/agent.json

# 2. Register
curl -X POST https://api.sloiai.com/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name":"MyAgent","email":"agent@co.com","framework":"claude","wallet_address":"0x..."}'
# → {api_key: "sk-sloi-...", sloi_wallet: "0x..."}

# 3. Buy credits (send USDC to sloi_wallet on Base mainnet)
# 99 USDC → 100 credits, appears in ~2 seconds

# 4. Get products (free)
curl https://api.sloiai.com/v1/products?sector=metals \
  -H "x-api-key: sk-sloi-..."

# 5. Start negotiation → SSE stream
curl -X POST https://api.sloiai.com/v1/negotiate \
  -H "x-api-key: sk-sloi-..." \
  -H "Content-Type: application/json" \
  -d '{
    "product_ref": "REF-MET-001",
    "qty": 100, "unit": "MT",
    "target_price": 2700, "max_price": 2900,
    "strategy": "deal-hunter"
  }'
# → SSE stream: NEGOTIATION_STARTED → TEXT_CHUNK → ROUND_COMPLETE → AWAIT_HUMAN → LOI_GENERATED

import httpx, json, sseclient

API_KEY = "sk-sloi-..."
BASE = "https://api.sloiai.com/v1"
HEADERS = {"x-api-key": API_KEY, "Content-Type": "application/json"}

# Step 1: Discover capabilities
card = httpx.get("https://sloiai.com/.well-known/agent.json").json()
print(f"Connected to: {card['name']} · Skills: {[s['id'] for s in card['skills']]}")

# Step 2: Check balance
balance = httpx.get(f"{BASE}/credits/balance", headers=HEADERS).json()
print(f"Credits: {balance['balance']}")

# Step 3: Find best steel price
products = httpx.get(f"{BASE}/products?sector=metals", headers=HEADERS).json()
steel = next(p for p in products if "Rebar" in p["name"])
print(f"Steel: ${steel['price']}/MT · ref: {steel['ref']}")

# Step 4: Negotiate (streaming)
with httpx.stream("POST", f"{BASE}/negotiate", headers=HEADERS, json={
    "product_ref": steel["ref"],
    "qty": 100, "unit": "MT",
    "target_price": steel["price"] * 0.97,
    "max_price": steel["price"] * 1.02,
    "strategy": "deal-hunter",
    "buyer_name": "MyAgent Procurement LLC",
}) as response:
    for line in response.iter_lines():
        if not line.startswith("data: "): continue
        event = json.loads(line[6:])

        if event["type"] == "TEXT_CHUNK":
            print(event["data"]["text"], end="", flush=True)

        elif event["type"] == "ROUND_COMPLETE":
            d = event["data"]
            print(f"\nRound {d['round']}: Agent ${d['agent_price']} | Trader ${d['broker_price']} | Gap {d['gap_pct']:.1f}%")

        elif event["type"] == "AWAIT_HUMAN":
            # Manual mode: agent calls approve endpoint
            d = event["data"]
            neg_id = event["task_id"]
            print(f"\nDeal: ${d['deal_price']}/MT · Total: ${d['total_value']:,}")
            # Agent decides: approve if within budget
            if d["deal_price"] <= 2900:
                httpx.post(f"{BASE}/negotiations/{neg_id}/approve",
                    headers=HEADERS, json={"action": "approve"})

        elif event["type"] == "LOI_GENERATED":
            d = event["data"]
            print(f"\n✅ LOI: {d['loi_ref']} · ${d['deal_price']}/MT · ${d['total_value']:,}")
            # Download PDF
            pdf = httpx.get(f"{BASE}/lois/{d['loi_ref']}/pdf", headers=HEADERS)
            with open(f"{d['loi_ref']}.pdf", "wb") as f:
                f.write(pdf.content)
            print(f"PDF saved: {d['loi_ref']}.pdf")
            break

        elif event["type"] == "NEGOTIATION_FAILED":
            print(f"\n✗ Failed: {event['data']['reason']}")
            break

import httpx, json

API_KEY = "sk-sloi-..."
BASE = "https://api.sloiai.com/v1"
HEADERS = {"x-api-key": API_KEY, "Content-Type": "application/json"}

# 1. Create mandate (do this once — valid for 30 days)
mandate = httpx.post(f"{BASE}/mandates", headers=HEADERS, json={
    "product_ref":       "REF-MET-001",
    "qty":               100,
    "unit":              "MT",
    "target_price":      2700,
    "max_price":         2900,   # hard ceiling
    "strategy":          "deal-hunter",
    "auto_approve":      True,   # autonomous mode ON
    "max_orders_per_day": 3,
    "max_daily_value":   500000,
    "expires_in_days":   30,
}).json()
print(f"Mandate: {mandate['mandate_id']} · auto_approve: {mandate['auto_approve']}")

# 2. Start negotiation with mandate (runs fully autonomously)
with httpx.stream("POST", f"{BASE}/negotiate", headers=HEADERS, json={
    "mandate_id": mandate["mandate_id"],  # auto_approve inherited
    "buyer_name": "MyAgent Corp",
}) as response:
    for line in response.iter_lines():
        if not line.startswith("data: "): continue
        event = json.loads(line[6:])

        if event["type"] == "AUTO_APPROVED":
            # No human needed — LOI being generated now
            d = event["data"]
            print(f"⚡ Auto-approved: ${d['deal_price']}/MT · {d['conditions_met']}")

        elif event["type"] == "LOI_GENERATED":
            d = event["data"]
            print(f"✅ {d['loi_ref']} · ${d['total_value']:,} · {d['pdf_url']}")
            break

# Total time: ~13 seconds. Zero human interaction.