coinfound-rwa-read

# CoinFound RWA Read Self-contained read-only access to CoinFound RWA `GET` endpoints. ## Scope - Supports `aggregates`, `timeseries`, `pie`, `list`, and `dataset` routes under `v1/c/rwa/*`. - Does not refresh schema snapshots. Hand unresolved schema gaps to `$coinfound-rwa-schema-probe`. ## Workflow 1. Read the bundled endpoint catalog and schema snapshots before constructing a request. 2. Resolve the route by `endpoint_key` or by `asset_class + family + metric`. 3. Run the bundled fetch script and return both the envelope and normalized payload. 4. If the schema is missing or conflicts with live data, delegate to `$coinfound-rwa-schema-probe`. ## Bundled Resources Read first: - `shared/coinfound_rwa/data/endpoint_catalog.json` - `shared/coinfound_rwa/data/schema_snapshots/` Run: - `shared/coinfound_rwa/scripts/fetch_rwa.py` ## Minimal Examples ```bash python3 shared/coinfound_rwa/scripts/fetch_rwa.py \ --endpoint-key stable-coin.market-cap.timeseries \ --query '{"groupBy":"network"}' ``` ```bash python3 shared/coinfound_rwa/scripts/fetch_rwa.py \ --asset-class private-credit \ --family aggregates ``` ## Expected Output Default output should include: - `request` - `response_envelope` - `normalized_data` - `display_data` - `shape_family` - `schema_source` ## References - `references/rwa-read-workflow.md` - `references/rwa-read-capabilities.md` - `references/rwa-read-integration-notes.md`