Skip to main content
GET
List v3 RWA / stablecoin grades
Returns every graded RWA / stablecoin token with its headline composite grade (letter + 0–100 risk score + per-category contributors), filterable, sortable, and paginated. This is the bulk list companion to the per-token detail endpoint GET /v3/rwa/{address}.
grade_counts is a histogram over the full filtered set (every matching token), not just the returned page. Grades are emitted in the resolved grading_scheme’s letters (default v2).

Freshness

The response carries two top-level freshness fields: generated_at (when this snapshot was produced) and stale (true when the snapshot is older than the expected refresh cadence). Unlike the RWA detail endpoint, this list gives you a stale flag you can hard-gate on. See Hard-gating and fail behavior.

Authorizations

x-api-key
string
header
required

Query Parameters

chain
string

Filter by chain slug (e.g. eth, base, pol).

grade
enum<string>

Filter to a single grade letter. Accepts any letter from either scheme (the enum is the union); a letter the resolved grading_scheme never emits — e.g. E under v2 or C+ under v1 — simply matches no tokens.

Available options:
A+,
A,
A-,
B+,
B,
B-,
C+,
C,
C-,
D,
E,
F
minScore
number

Minimum composite (risk) score, 0–100.

Required range: 0 <= x <= 100
sort
enum<string>

Sort field.

Available options:
score,
symbol,
chain,
grade,
market_cap_usd
order
enum<string>
default:asc

Sort order. Default asc (best grade first).

Available options:
asc,
desc
page
integer
default:1

1-based page number.

Required range: x >= 1
pageSize
integer
default:50

Items per page (default 50).

grading_scheme
enum<string>
default:v2

Grading scheme to pin — selects the letter-grade band table. Default v2 (the standard 11-band scale: no E, adds C+). v1 is frozen and deprecated. Independent of the API version (v3) and of framework_version.

Available options:
v1,
v2

Response

Paginated list of graded tokens. grade_counts reflects the full filtered set, not just the returned page.

schema_version
string
required
Example:

"3.0"

items
object[]
required
pagination
object
required
grade_counts
object
required

Grade-letter histogram over the full filtered set, in the resolved scheme's letters.

generated_at
string
required
stale
boolean
required