Skip to main content
GET
/
v3
/
rwa
/
grades
List v3 RWA / stablecoin grades
curl --request GET \
  --url https://api.webacy.com/v3/rwa/grades \
  --header 'x-api-key: <api-key>'
{
  "schema_version": "3.0",
  "items": [
    {
      "symbol": "usdb",
      "name": "USDBridge",
      "chain": "base",
      "address": "0x100faa513ac917181eb29f73b64bf7a434a206fe",
      "market_cap_usd": null,
      "tier": "ok",
      "composite": {
        "grading_scheme": "v2",
        "grade": "A-",
        "stars": 5,
        "score": 14.5,
        "contributors": {
          "smart_contract": {
            "score": 41.5,
            "weight": 0.2
          },
          "operational_governance": {
            "score": 41.5,
            "weight": 0.15
          },
          "asset_collateral": {
            "score": 0,
            "weight": 0.3
          },
          "market_liquidity": {
            "score": 0,
            "weight": 0.2
          },
          "counterparty": {
            "score": 0,
            "weight": 0
          },
          "hack_exploit_history": {
            "score": 0,
            "weight": 0.15
          },
          "chain_infrastructure": {
            "score": 0,
            "weight": 0
          }
        },
        "upstream_risk": 12,
        "clamped_by_upstream": false
      }
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "pageSize": 50,
    "totalPages": 1
  },
  "grade_counts": {
    "A-": 1
  },
  "generated_at": "2026-06-02T09:49:36Z",
  "stale": false
}
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 /api/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).

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