QXMP Oracle
Integration Guide

GET https://api.qxmp.ai/api/v1/rwa/assets?page=1&limit=100

Response:
{
  "success": true,
  "data": {
    "assets": [
      {
        "assetCode": "QXMP:RHENO-JORC-ZA",
        "name": "Rhenosterspruit / Syferfontein Mining Project",
        "type": "Rare Earth Elements",
        "jurisdiction": "ZA",
        "valueUSD": "113989838841.85",
        "status": "registered",
        "holder": "0x...",
        "assetCodeHash": "0x...",
        "txHash": "0x...",
        "registeredAt": "2025-06-15T...",
        "updatedAt": "2026-02-10T...",
        "onChain": {
          "registryValue": "113989838841.85",
          "holder": "0x...",
          "registeredAt": "2025-06-15T...",
          "lastUpdated": "2026-02-10T..."
        },
        "latestProof": {
          "valueUSD": "113989838841.85",
          "timestamp": "2026-02-10T12:00:00.000Z",
          "ageHours": "23.5",
          "isFresh": true,
          "submitter": "0x..."
        },
        "proofHistory": [
          {
            "valueUSD": "113989838841.85",
            "timestamp": "2026-02-10T12:00:00.000Z"
          }
        ]
      }
    ],
    "pagination": { "page": 1, "limit": 100, "total": 12, "totalPages": 1 },
    "summary": { "count": 12, "totalValue": "1090958787645.94", "currency": "USD" }
  }
}

// Base URL for the QXMP Oracle API
const API_BASE = 'https://api.qxmp.ai/api/v1/rwa';

// ─── Get all RWA assets ───────────────────────────────
async function getAllAssets(page = 1, limit = 100) {
  const response = await fetch(
    `${API_BASE}/assets?page=${page}&limit=${limit}`
  );
  const result = await response.json();

  if (!result.success) {
    throw new Error(result.error || 'API request failed');
  }

  // Parse string values to numbers for display
  const assets = result.data.assets.map(asset => ({
    ...asset,
    valueUSD: parseFloat(asset.valueUSD),
    registeredAt: new Date(asset.registeredAt),
    updatedAt: new Date(asset.updatedAt),
    latestProof: asset.latestProof ? {
      ...asset.latestProof,
      valueUSD: parseFloat(asset.latestProof.valueUSD),
      timestamp: new Date(asset.latestProof.timestamp),
      ageHours: parseFloat(asset.latestProof.ageHours)
    } : null
  }));

  return {
    assets,
    pagination: result.data.pagination,
    summary: {
      count: result.data.summary.count,
      totalValue: parseFloat(result.data.summary.totalValue),
      currency: result.data.summary.currency
    }
  };
}

// ─── Get portfolio statistics ─────────────────────────
async function getPortfolioStats() {
  const response = await fetch(`${API_BASE}/stats`);
  const result = await response.json();

  if (!result.success) {
    throw new Error(result.error || 'API request failed');
  }

  return {
    totalAssets: result.data.totalAssets,
    totalValue: parseFloat(result.data.totalValue),
    averageValue: parseFloat(result.data.averageValue),
    currency: result.data.currency,
    byType: result.data.byType.map(item => ({
      type: item.type,
      count: item.count,
      value: parseFloat(item.value),
      percentage: parseFloat(item.percentage)
    })),
    byJurisdiction: result.data.byJurisdiction.map(item => ({
      jurisdiction: item.jurisdiction,
      count: item.count,
      value: parseFloat(item.value),
      percentage: parseFloat(item.percentage)
    }))
  };
}

// ─── Get a single asset with full details ─────────────
async function getAsset(assetCode) {
  const response = await fetch(
    `${API_BASE}/assets/${assetCode}`
  );
  const result = await response.json();

  if (!result.success) {
    throw new Error(result.error || 'API request failed');
  }

  return result.data;
}

// ─── Check API health ─────────────────────────────────
async function checkHealth() {
  const response = await fetch(`${API_BASE}/health`);
  return await response.json();
}

// ─── Example usage ────────────────────────────────────
const data = await getAllAssets();
console.log(`Total: ${data.summary.count} assets worth $${data.summary.totalValue.toLocaleString()}`);

for (const asset of data.assets) {
  const proof = asset.latestProof?.isFresh ? '✅ Fresh' : '⚠️ Stale';
  console.log(`  ${asset.assetCode}: $${asset.valueUSD.toLocaleString()} [${proof}]`);
}