# RWA

> Real-world-asset registry, facets, and institutional asset detail.

## GET /v1/rwa

List tokenized treasury, T-bill-backed stable, and RWA credit assets with institutional metadata.

### Query Parameters

| Parameter          | Type   | Default | Description                                                   |
| ------------------ | ------ | ------- | ------------------------------------------------------------- |
| page               | number | 1       | Page number                                                   |
| limit              | number | 20      | Results per page                                              |
| chain              | number | -       | Chain ID                                                      |
| category           | string | -       | `tokenized_treasury`, `t_bill_backed_stable`, or `rwa_credit` |
| review_status      | string | -       | `reviewed`, `provisional`, or `unreviewed`                    |
| risk_tier          | string | -       | `Prime`, `Core`, or `Edge`                                    |
| regulatory_wrapper | string | -       | Regulatory wrapper filter                                     |
| kyc_gate           | string | -       | Investor eligibility filter                                   |
| search             | string | -       | Symbol or address search                                      |

### Example

```bash
curl "https://api.philidor.io/v1/rwa?category=tokenized_treasury&limit=5"
```

### Response

```json
{
  "data": [
    {
      "asset_id": "3881",
      "asset_version_id": "9001",
      "address": "0x...",
      "chain_id": 1,
      "symbol": "BUIDL",
      "name": "BUIDL",
      "category": "tokenized_treasury",
      "review_status": "reviewed",
      "risk_score": 8.7,
      "risk_tier": "Prime",
      "issuer": {
        "id": "blackrock",
        "name": "BlackRock"
      },
      "in_basket_a": true,
      "dimensions": {
        "issuer_custody": 9,
        "reserve_transparency": 9,
        "redeemability": 8,
        "protocol_security": 8,
        "liquidity": 7
      },
      "institutional": {
        "regulatory_wrapper": "reg_d_506c",
        "regulatory_jurisdiction": "US",
        "kyc_gate": "qualified_purchaser",
        "custodian_name": "Custodian",
        "auditor_name": "Auditor",
        "attestation_cadence": "monthly",
        "redemption_window": "T+1",
        "currency": "USD",
        "yield_basis": "sec_7_day"
      },
      "freshness": {
        "last_refresh_at": "2026-07-01T00:00:00Z",
        "age_hours": 4,
        "status": "fresh",
        "last_status": "updated"
      },
      "dependency_chain": [],
      "methodology_version": "v1.3",
      "chain_overlay": null,
      "canonical_product_id": "BUIDL",
      "aum_scope": "product",
      "metrics": {
        "fund_aum_usd": 100000000,
        "global_issued_value_usd": 100000000,
        "deployment_circulating_value_usd": 25000000,
        "apy_7d_pct": 4.8,
        "apy_30d_pct": 4.9,
        "duration_days": 90
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 5,
    "total": 1,
    "totalPages": 1
  }
}
```

---

## GET /v1/rwa/facets

Return aggregate counts for filters.

### Example

```bash
curl https://api.philidor.io/v1/rwa/facets
```

### Response

```json
{
  "data": {
    "chains": [{ "chain_id": 1, "count": 12 }],
    "categories": [{ "category": "tokenized_treasury", "count": 8 }],
    "review_statuses": [{ "review_status": "reviewed", "count": 8 }],
    "risk_tiers": [{ "risk_tier": "Prime", "count": 3 }],
    "regulatory_wrappers": [{ "regulatory_wrapper": "reg_d_506c", "count": 2 }],
    "kyc_gates": [{ "kyc_gate": "qualified_purchaser", "count": 2 }],
    "jurisdictions": [{ "jurisdiction": "US", "count": 5 }],
    "custodians": [{ "custodian": "Custodian", "count": 5 }],
    "auditors": [{ "auditor": "Auditor", "count": 5 }]
  }
}
```

---

## GET /v1/rwa/\{asset_id\}

Get one RWA asset with version history, attestation history, discovery provenance, and a risk-score reconstruction.

### Path Parameters

| Parameter | Type   | Description      |
| --------- | ------ | ---------------- |
| asset_id  | string | Numeric asset ID |

### Example

```bash
curl https://api.philidor.io/v1/rwa/3881
```

### Response

```json
{
  "data": {
    "asset_id": "3881",
    "symbol": "BUIDL",
    "risk_score": 8.7,
    "risk_tier": "Prime",
    "version_history": [
      {
        "asset_version_id": "9001",
        "recorded_at": "2026-07-01T00:00:00Z",
        "risk_score": 8.7,
        "risk_tier": "Prime",
        "review_status": "reviewed"
      }
    ],
    "attestation_history": [],
    "discovery": {
      "source_slug": "registry",
      "discovered_at": "2026-07-01T00:00:00Z",
      "last_seen_at": "2026-07-01T00:00:00Z"
    },
    "risk_score_breakdown": {
      "category": "tokenized_treasury",
      "weights": { "issuer_custody": 0.25 },
      "dimensions": { "issuer_custody": 9 },
      "weighted_sum": 8.7,
      "overlays_applied": [],
      "score": 8.7,
      "tier": "Prime",
      "methodology_version": "v1.3"
    }
  }
}
```