# RWA Kernel

Machine-readable full asset data, risk components, metrics, comparisons, portfolio exposure, token identity, registry changes, and evidence-limited preflight.

Discover coverage without payment: GET /api/v1/directory lists names, categories, exact purchase_id values and boolean data-section availability. It does not include financial values, terms or risk assessments. Humans can browse /assets and open individual coverage previews. Use an exact purchase_id in paid requests; it changes when its underlying record changes.

All available asset fields are purchasable via x402 without a subscription. Full-data products use asset IDs or slugs and support all catalog assets including non-EVM and provider assets. Prices are experimental. POST JSON to:
- /api/v1/asset ($0.05): {"asset":"rwakernel:ousg"}. Complete available record including risk, metadata, legal terms, eligibility, cash flows, links and recorded metrics.
- /api/v1/risk ($0.10): {"asset":"rwakernel:ousg"}. Recorded risk components and rationales, not fresh underwriting.
- /api/v1/metrics ($0.05): {"asset":"rwakernel:ousg"}. Available computed metrics with provenance and recorded metrics with original dates.
- /api/v1/catalog ($0.25): {"offset":0,"limit":20,"include_providers":true}. Up to 50 full records per purchase, sorted by ID. Follow next_offset. Optional search and asset_class filters. Use include_providers:false for registry-only results.
- /api/v1/compare ($0.15): {"assets":["ousg","buidl"]}. 2–20 full records in requested order.
- /api/v1/portfolio ($0.25): {"positions":[{"asset":"ousg","value_usd":1000}]}. Up to 20 positions; issuer/jurisdiction/asset-class exposure and weighted recorded risk categories. Unknown risk retains its weight.
Add quote:true to any POST for price and scope only, never asset data. Missing records and provider failures are not charged. Full-data products accept Professional/Enterprise keys as an alternative to x402. Each product has an MCP tool named rwa_purchase_<product>. Source freshness is not implied by purchase time; lab records remain explicitly identified.

- Agent docs: https://www.rwakernel.com/agents
- OpenAPI: https://www.rwakernel.com/openapi.json
- Current products and payment availability: https://www.rwakernel.com/api/v1/products
- MCP: https://www.rwakernel.com/api/mcp

Use GET /api/v1/resolve/{chain}/{address} to resolve an unfamiliar EVM contract. $0.01 per answer, rate-limited. Append ?quote=true for price only. A registry match is not issuer verification.
Use POST /api/v1/changes with assets and since (ISO timestamp) for registry revisions and observed pilot source changes. $0.03 per batch, experimental. quote:true checks coverage free. History begins at first observation, retains 200 field events per asset, and is not continuous issuer monitoring.
Use POST /api/v1/preflight with chain, address, action (buy/transfer/redeem/collateral) for recorded restrictions and unknowns. $0.15 experimental. quote:true checks scope free. No wallet permissions, transaction simulation, or legal approval.

Payments: x402 v2 over HTTP when enabled; paid API keys also work. Inspect current availability first. No signup required for x402. Never send a new proof while settlement is indeterminate; retry the same proof and identical body. Delivery receipts are available for 7 days.
MCP tools: rwa_resolve_token, rwa_get_changes, rwa_preflight. Anonymous MCP callers receive HTTP purchase instructions for paid products; MCP does not sign or spend funds.

OUSG and USDY on Ethereum include live_evidence: issuer contract references and finalized onchain supply, cached up to five minutes. Supply is not NAV, AUM or proof of backing. Missing fresh pilot evidence returns 503 before payment. Other source references remain unretrieved. source_checked_at:null means freshness is unknown. Treat incomplete and unknown responses accordingly.