Product Fees API

# By ticker
curl -X GET "https://swarms.world/api/product/fees?ticker=RSRCH" \
  -H "Authorization: Bearer YOUR_API_KEY"

# By UUID
curl -X GET "https://swarms.world/api/product/fees?id=1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d" \
  -H "Authorization: Bearer YOUR_API_KEY"

# By full Swarms URL (auto-detected via `product`)
curl -X GET "https://swarms.world/api/product/fees?product=https://swarms.world/agent/1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

BASE_URL = "https://swarms.world"
API_KEY = "YOUR_API_KEY"

# `product` auto-detects a ticker, UUID, or full Swarms URL
response = requests.get(
    f"{BASE_URL}/api/product/fees",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"product": "RSRCH"},
    timeout=60,
)

data = response.json()
if response.ok:
    print(f"{data['name']} ({data['uuid']})")
    print(f"  Total:     {data['totalFees']} SOL")
    print(f"  Unclaimed: {data['unclaimedFees']} SOL")
    print(f"  Claimed:   {data['claimedFees']} SOL")
    print(f"  As of:     {data['timestamp']}")
else:
    print("Error:", data.get("error", response.text))

interface ProductFeesResponse {
  name: string | null;
  uuid: string;
  claimedFees: number;
  unclaimedFees: number;
  totalFees: number;
  timestamp: string;
}

async function getProductFees(
  apiKey: string,
  product: string // ticker, UUID, or full Swarms URL
): Promise<ProductFeesResponse> {
  const url = new URL("https://swarms.world/api/product/fees");
  url.searchParams.set("product", product);

  const response = await fetch(url.toString(), {
    method: "GET",
    headers: { Authorization: `Bearer ${apiKey}` },
  });

  const data = await response.json();
  if (!response.ok) {
    throw new Error(data.error || "Unknown error");
  }
  return data as ProductFeesResponse;
}

// Usage
getProductFees("YOUR_API_KEY", "RSRCH").then((data) => {
  console.log(`${data.name} (${data.uuid})`);
  console.log(`  Total: ${data.totalFees} SOL`);
  console.log(`  Unclaimed: ${data.unclaimedFees} SOL`);
  console.log(`  Claimed: ${data.claimedFees} SOL`);
});