Skip to main content
GET
Get v3 RWA / stablecoin risk detail (Webacy-native)
Higher score = more risk. composite.score and every categories.*.score run 0–100, where 0 = no structural risk and 100 = maximum risk (grade A+ ≈ 0, F ≈ 100) — the opposite of yield or performance scores. See Score Polarity for the full grade bands.

Assessing freshness

This endpoint does not return a response-level stale flag or generated_at. For a freshness signal, read the RWA grades list (GET /v3/rwa/grades), which carries generated_at and stale.Treat missing, stale, or errored data as unknown — never as safe. See Hard-gating and fail behavior.

Segment and classification

metadata.segment carries the derived category — stablecoin or rwa — alongside the classification fields it comes from (metadata.asset_class, metadata.subclass). metadata.asset_type holds the same value as segment and predates the split; prefer segment in new integrations. metadata.asset_class = "fiat" means the token is denominated in a government currency, not that it is cash-backed.
classification_available: false means the classification could not be loaded for this request. The response still succeeds, but the classification fields are not trustworthy — treat them as unknown.
For a stablecoin-only route that answers 404 for an RWA, see GET /v3/stablecoins/{address}.

Authorizations

x-api-key
string
header
required

Path Parameters

address
string
required

Token contract address.

Query Parameters

chain
enum<string>
required

Chain identifier (e.g. eth, base, pol). Required.

Available options:
eth,
base,
bsc,
pol,
opt,
arb,
avax,
sol,
stellar,
hedera,
tron,
sui,
ton,
sei,
btc,
gnosis
grading_scheme
enum<string>
default:v2

Grading scheme to pin — selects the per-category weights and letter-grade band table. Default v2 (alias of v1's weights, standard 11-band grade scale). peg is the peg-loss-focused weighting. v3/v4/peg-liquidity are registered but withheld behind the v3-grading-scheme feature flag. Unknown values return 400 with the supported list.

Available options:
v1,
v2,
peg

Response

Webacy-native v3 RWA / stablecoin detail.

Webacy-native v3 RWA / stablecoin detail. Same shape family as VaultV3Response, minus the risk pass-through (the v2 RWA grade has no risk envelope; the headline signal is composite, floored by upstream_risk).

schema_version
string
required
Example:

"3.5"

metadata
object
required

Structural fact sheet for an RWA / stablecoin — identities only.

composite
object
required

Headline grade block. POLARITY (load-bearing): score is 0–100, HIGHER = WORSE (A+ = 0, F = 100) — same direction as the v2 risk.score on the same response. score = max(Σ contributors·weight, upstream_risk): floored from below by the upstream pipeline risk.

categories
object
required
coverage
object
required

How many criteria are live today vs defined by the framework — so what the grade reflects is on the wire, not just in docs.

attributes
object
required

Curated, grouped passthrough of the RWA grade record's detail-only facts. Always present as a block; individual leaves are null when the underlying value is not available. The safety score/grade are intentionally excluded — composite remains the only grade.

classification_available
boolean

false when the asset classification could not be loaded — metadata.asset_type falls back to stablecoin and asset_class / subclass are null. GET /v3/stablecoins/{address} fails closed (503) in that state.