RWA

Canonical real-world-asset registry, coverage, sources, history, and asset detail.

GET /v1/rwa

List tokenized treasury, T-bill-backed stable, credit, commodity-backed, and tokenized-equity deployments with institutional metadata.

product_id is the only canonical product identity. It is null until a signed review maps the deployment. canonical_product_id is a deprecated UPPER(symbol) compatibility field and must not be used for aggregation.

Query Parameters

Parameter	Type	Default	Description
page	number	1	Page number
limit	number	20	Results per page
chain	number or string	-	Chain: integer id or slug (e.g. `1`, `ethereum`)
category	string	-	`tokenized_treasury`, `t_bill_backed_stable`, `rwa_credit`, `commodity_backed`, or `tokenized_equity`
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

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

Response

{
  "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,
      "product_id": "07cd5da4-1e52-4c0a-8f75-59f2b26f6024",
      "identity_status": "reviewed",
      "canonical_product_id": "BUIDL",
      "aum_scope": "product",
      "canonical_aum": {
        "snapshot_date": "2026-08-24",
        "included": true,
        "exclusion_reason": null,
        "value_usd": 100000000,
        "source_id": "rwa-xyz-api",
        "effective_at": "2026-08-24T00:00:00Z",
        "age_hours": 12,
        "carried_forward": false,
        "observation_ids": ["76bf70de-2161-4a23-a075-847f672caab8"],
        "caveats": []
      },
      "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
  }
}

canonical_aum is a persisted product-level reconciliation decision. Missing or excluded products remain null/explicitly excluded and are never treated as zero. institutional.aum_usd and aum_scope are legacy deployment fields.

GET /v1/rwa/coverage

Return the honest coverage and source-quality census. This includes reviewed identity mapping, legacy and canonical field coverage, explicit market-catalog match rate, canonical and legacy source concentration, every typed data source's operational state, and deterministic P0/P1/P2 SLA findings.

curl https://api.philidor.io/v1/rwa/coverage

Source states are active, stale, failing, unseen, registered, and disabled. A configured source is not reported active until it has a fresh immutable publication.

discovery.candidates is the open review queue, not a lifetime ingestion counter. It includes only discovered or classifying deployments with evidence from at least one currently enabled discovery source. Classified, rejected, and retired-source rows remain in the audit history but are excluded from this partner-facing count. Typed issuer API publications such as Superstate and Nest are reported under data_sources; they are not counted as legacy HTML discovery sources.

GET /v1/rwa/stats/history

Return persisted, revisioned canonical AUM history. Requires the Data tier.

Parameter	Values	Default
range	`7d`, `30d`, `90d`, `1y`	`30d`
breakdown	`chain`, `category`	`chain`

curl -H "Authorization: Bearer $PHILIDOR_API_KEY" \
  "https://api.philidor.io/v1/rwa/stats/history?range=30d&breakdown=chain"

Every point reports included and excluded product counts, product/chain coverage, unallocated value, source mix, revision, and caveats. Totals are not reconstructed from ticker groups.

GET /v1/rwa/facets

Return aggregate counts for filters.

Example

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

Response

{
  "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

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

Response

{
  "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"
    }
  }
}

On this page