Developers & Pricing

What RWA Kernel Provides

TypeScript SDK

npm install @rwakernel/sdk

import { RwaKernel } from "@rwakernel/sdk";

// Initialize with your API key
const kernel = new RwaKernel({ apiKey: "rwa_live_xxx" });

// Get live metrics with full provenance
const metrics = await kernel.getMetrics("buidl");
console.log(`AUM: $${metrics.metrics.aumUsd?.value}`);
console.log(`Source: ${metrics.metrics.aumUsd?.sourceType}`); // "onchain_contract"

// Get all treasury assets
const treasuries = await kernel.getAssets({ assetClass: "treasury" });

// Inspect a token (for AI agents)
const info = await kernel.inspectToken(1, "0x7712c34...");

// Check eligibility
const eligible = await kernel.checkEligibility({
  region: "US",
  investorType: "accredited",
});

Full TypeScript types included. Zero dependencies.

MCP Server for AI Tools

// claude_desktop_config.json
{
  "mcpServers": {
    "rwakernel": {
      "command": "npx",
      "args": ["@rwakernel/mcp-server"]
    }
  }
}

API Endpoints

curl -H "x-api-key: rwa_xxx" "https://rwakernel.com/api/metrics/buidl?mode=verified"

curl "https://rwakernel.com/api/assets?assetClass=treasury&includeMetrics=true"

curl "https://rwakernel.com/api/assets/buidl?includeMetrics=true"

curl "https://rwakernel.com/api/assets/by-address/1/0x7712..."

curl "https://rwakernel.com/api/inspect/1/0x7712..."

curl "https://rwakernel.com/api/eligibility?region=US&investorType=accredited"

curl "https://rwakernel.com/api/stats"

curl "https://rwakernel.com/api/labs/krs"

Provider APIs

Specialized endpoints for third-party provider collections with dedicated data pipelines.

curl "https://rwakernel.com/api/providers/ondo-gm?format=enriched&include=all"

// GET /api/providers/ondo-gm?format=enriched&ticker=TSLA&include=all
{
  "provider": { "id": "ondo-gm", "name": "Ondo Global Markets", ... },
  "assets": [{
    "tokenTicker": "TSLAon",
    "underlyingTicker": "TSLA",
    "underlyingName": "Tesla, Inc.",
    "exchange": "NASDAQ",
    "category": "stock",
    "chains": [{ "chainId": 1, "chainName": "Ethereum", "tokenAddress": "0x..." }],
    "underlyingPrice": {        // From Yahoo Finance
      "price": 435.20,
      "changePercent": -0.53,
      "dayHigh": 442.50,
      "dayLow": 432.10,
      "fiftyTwoWeekHigh": 498.83,
      "fiftyTwoWeekLow": 214.25,
      "volume": 49000000
    },
    "tokenPrice": {             // From CoinMarketCap/CoinGecko
      "price": 437.19,
      "changePercent24h": -1.62
    },
    "onChainMetrics": {         // From The Graph subgraph
      "totalSupply": "125000000000000000000000",
      "holderCount": 1250,
      "transferCount24h": 45,
      "transferVolume24h": 2500000
    },
    "marketStatus": { "isUSMarketOpen": false, "nextOpen": "..." }
  }],
  "summary": { "totalAssets": 115, "stocks": 85, "etfs": 30 },
  "dataSources": {
    "official": { "success": true, "count": 115 },
    "subgraph": { "success": true, "count": 98 },
    "yahooFinance": { "success": true, "count": 112 }
  }
}

Schema Overview

NEW: The /api/metrics/:id endpoint returns live metrics with provenance:

interface MetricsResponse {
  assetId: string;
  symbol: string;
  request: {                    // Shows what mode was used
    mode: "verified" | "expanded";  // Default: expanded
    minQuality: number;         // Quality threshold used
  };
  provenance: "collector" | "onchain" | "aggregator" | "static" | "estimated";
  hasLiveData: boolean;         // True if live collector data exists
  usedStaticFallback: boolean;  // True if static JSON was used
  qualityGate?: {               // What was filtered out
    minScoreThreshold: number;
    verifiedOnly: boolean;
    withheldMetrics: Array<{ metric: string; reason: string }>;
  };
  metrics: {
    aumUsd?: SourcedMetric;     // AUM (or null if withheld)
    yieldApy?: SourcedMetric;   // Yield APY (or null if withheld)
    navUsd?: SourcedMetric;     // NAV per share
    overallQuality: 1-5;
    qualitySummary: string;
  };
}

interface SourcedMetric {
  value: number;
  sourceType: "onchain_contract" | "onchain_oracle" | "issuer_official" 
            | "aggregator" | "estimated";
  sourceRef: string;
  qualityScore: 1-5;
  isStale: boolean;
  timestamp: string;
}

Every asset conforms to the RwaAsset interface:

interface RwaAsset {
  id: string;                // Unique identifier
  slug: string;              // URL-friendly slug
  name: string;              // Full name
  symbol?: string;           // Token symbol
  assetClass: AssetClass;    // "treasury" | "money_market_fund" | ...
  description: string;       // Short description

  chains: ChainLocation[];   // Where deployed
  legal: LegalInfo;          // Issuer, jurisdiction, wrapper
  eligibility: Eligibility;  // KYC, accreditation, regions
  cashFlow: CashFlowModel;   // Type, frequency, rates
  risk: RiskFlags;           // Contract, custody, regulatory
  riskProfile?: RiskProfile; // Multi-dimensional risk grid
  links: AssetLinks;         // Official site, docs, explorers

              metrics?: AssetMetrics;    // AUM, yield (returned only when includeMetrics=true)
  tags?: string[];           // For filtering
  isLabAsset?: boolean;      // True for simulated assets
}

The /api/inspect endpoint returns:

interface InspectResponse {
  asset: RwaAsset | null;    // Full asset data, or null if not found
  classification: "rwa" | "unknown";
  summary: string;           // Human-readable summary
  details: string[];         // Bullet points of key properties
  agentSummary: string;      // Concise summary for AI agents
  promptSnippet: string;     // Instructions for agent interpretation
}

NEW: The RiskProfile provides machine-readable risk analysis:

interface RiskProfile {
  underlyingCredit?: RiskDimension;  // Credit risk of backing
  marketRate?: RiskDimension;        // Interest rate exposure
  structural?: RiskDimension;        // Legal/structural complexity
  legalRegulatory?: RiskDimension;   // Regulatory clarity
  smartContract?: RiskDimension;     // Technical/audit risk
  liquidity?: RiskDimension;         // Redemption/trading risk
  lastReviewedAt?: string;
}

interface RiskDimension {
  level: "low" | "medium" | "high";
  rationale: string;
}

Asset Class Extensions

Beyond financial RWAs, the registry includes Compute, IP, Carbon, Energy, and Data assets. Each class has an optional extension with specialized fields:

// Asset classes
type AssetClass = 
  | "treasury" | "money_market_fund" | "credit" | "stablecoin"
  | "tokenized_equity" | "fund" | "real_estate"
  | "compute"   // GPU, AI inference, storage
  | "ip"        // Music royalties, patents, biotech
  | "carbon"    // Carbon credits, environmental
  | "energy"    // RECs, solar revenue
  | "data"      // Data marketplaces, streams
  | "other";

// Extended RwaAsset for non-financial classes
interface RwaAsset {
  // ... core fields ...
  
  compute?: ComputeExtension;  // When assetClass === "compute"
  ip?: IpExtension;            // When assetClass === "ip"
  carbon?: CarbonExtension;    // When assetClass === "carbon"
  energy?: EnergyExtension;    // When assetClass === "energy"
  data?: DataExtension;        // When assetClass === "data"
}

{
  resource: {
    computeType: "gpu_rendering",
    networkCapacity: {
      totalNodes: 5000,
      totalGpus: 10000,
      utilizationRate: 0.75
    }
  },
  economics: {
    tokenUtility: "Payment + Staking",
    stakingYield: { currentApy: 8.5 }
  }
}

{
  ipType: "music",
  rights: {
    rightsType: "royalty_share",
    duration: "perpetual"
  },
  revenue: {
    paymentFrequency: "quarterly",
    historicalRevenue: {
      amount: 2500000
    }
  }
}

{
  credit: {
    creditType: "voluntary_offset",
    standard: "Verra VCS",
    vintage: "2020-2023"
  },
  environmental: {
    co2EquivalentTonnes: 25000000
  }
}

{
  dataAsset: {
    dataType: "data_marketplace",
    accessModel: "token_gated",
    updateFrequency: "real-time"
  },
  economics: {
    pricingModel: "pay_per_query"
  }
}

Filtering by Asset Class

Use the assetClass query parameter to filter assets:

# Get all compute/GPU tokens
GET /api/assets?assetClass=compute

# Get all carbon credit tokens
GET /api/assets?assetClass=carbon

# Get all IP/royalty tokens
GET /api/assets?assetClass=ip

# Combine with other filters
GET /api/assets?assetClass=compute&chainId=1
GET /api/assets?assetClass=treasury&tag=featured

Building AI Agents on RWA Kernel

Example: Agent Lookup Flow

curl https://rwakernel.com/api/inspect/1/0x7712c34...

{
  "classification": "rwa",
  "agentSummary": "BlackRock USD Institutional Digital Liquidity Fund (BUIDL) is a money market fund issued by BlackRock / Securitize. Backed by US Treasury bills, repo agreements, cash. 2.95% yield, $2.3B AUM. KYC required, accredited investors only, $5M minimum.",
  "promptSnippet": "When you see this token, treat it as exposure to a money market fund holding short-term, high-quality debt. Yield accrues daily, typically via NAV appreciation or rebasing. The holder earns yield passively. Important: only whitelisted (KYC'd) addresses can hold this token, holders must be accredited/qualified investors. This token is NOT freely tradeable on public DEXs.",
  "asset": { ... }
}

More Agent Examples

{ "classification": "rwa", "agentSummary": "BlackRock USD Institutional...", "promptSnippet": "When you see this token...", "asset": {...} }

{ "assets": [{ "id": "usdy", ... }, { "id": "usdm", ... }], "total": 3 }

{ "asset": { "cashFlow": { "type": "money_market_yield", "frequency": "daily", ... } } }