> ## Documentation Index > Fetch the complete documentation index at: https://docs.webacy.com/llms.txt > Use this file to discover all available pages before exploring further. # List RWA Grades > Paginated list of every graded RWA / stablecoin token with its v3 risk-polarity `composite` grade (letter + 0–100 score + per-category contributors). Filterable by chain / grade / minimum score, sortable, and paginated — the bulk companion to `GET /v3/rwa/{address}`. `grade_counts` is a histogram over the FULL filtered set, not just the returned page. POLARITY: scores 0–100, higher = worse. **CU cost:** 1 CU per request (`v3-rwa-grades-list`). 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}`](/api-reference/rwa-v3/get-rwa-risk-detail). `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`). ## OpenAPI ````yaml GET /v3/rwa/grades openapi: 3.0.1 info: title: Risk Score API description: API definition for Webacy Risk Scores version: 1.2.0 servers: - url: https://api.webacy.com description: Webacy Risk Score API (Production) - url: https://api-development.webacy.com description: Webacy Risk Score API (Development) - url: http://0.0.0.0:3030/api/v1/risk-score description: Webacy Risk Score API - Local security: - api_key: [] tags: - name: Threat Risks description: Analyze addresses for security threats and malicious activity - name: Sanction Checks description: Check addresses against OFAC and other sanction lists - name: Approval Risks description: Analyze token approvals and associated risks - name: Transaction Risks description: Assess risk details for blockchain transactions - name: Exposure Risk description: Understand risk profile and exposure of addresses - name: Contract Risk description: Real-time smart contract security analysis - name: URL Risks description: Analyze URLs for phishing and security threats - name: API Usage description: Monitor and manage API consumption - name: Holder Analysis description: Token holder distribution and sniper detection - name: Address Poisoning description: Detect address poisoning attack patterns - name: Token Analysis description: Comprehensive token security and market analysis - name: Pool Analysis description: Liquidity pool data and analysis - name: Transaction Scanning description: Scan and simulate transactions for risks - name: trading-lite description: Lightweight trading risk assessment - name: RWA & Pegged Tokens description: >- Real-world asset and pegged-token analytics (supply flows, mint/burn velocity) - name: Vault Risk v3 description: >- Webacy-native v3 vault risk surface — composite grade, categories, coverage, and the framework taxonomy (RFC-019). - name: RWA Risk v3 description: >- Webacy-native v3 RWA / stablecoin risk surface — composite grade, structural-health criteria, and batch (RFC-019). paths: /v3/rwa/grades: get: tags: - RWA Risk v3 summary: List v3 RWA / stablecoin grades description: >- Paginated list of every graded RWA / stablecoin token with its v3 risk-polarity `composite` grade (letter + 0–100 score + per-category contributors). Filterable by chain / grade / minimum score, sortable, and paginated — the bulk companion to `GET /v3/rwa/{address}`. `grade_counts` is a histogram over the FULL filtered set, not just the returned page. POLARITY: scores 0–100, higher = worse. **CU cost:** 1 CU per request (`v3-rwa-grades-list`). operationId: getRwaGradesV3 parameters: - name: chain in: query required: false schema: type: string description: Filter by chain slug (e.g. eth, base, pol). - name: grade in: query required: false schema: type: string enum: - A+ - A - A- - B+ - B - B- - C+ - C - C- - D - E - F description: >- 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. - name: minScore in: query required: false schema: type: number minimum: 0 maximum: 100 description: Minimum composite (risk) score, 0–100. - name: sort in: query required: false schema: type: string enum: - score - symbol - chain - grade - market_cap_usd description: Sort field. - name: order in: query required: false schema: type: string enum: - asc - desc default: asc description: Sort order. Default asc (best grade first). - name: page in: query required: false schema: type: integer minimum: 1 default: 1 description: 1-based page number. - name: pageSize in: query required: false schema: type: integer default: 50 description: Items per page (default 50). - name: grading_scheme in: query required: false schema: type: string enum: - v1 - v2 default: v2 description: >- 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`. responses: '200': description: >- Paginated list of graded tokens. grade_counts reflects the full filtered set, not just the returned page. content: application/json: schema: type: object required: - schema_version - items - pagination - grade_counts - generated_at - stale properties: schema_version: type: string example: '3.0' items: type: array items: type: object required: - symbol - name - chain - address - market_cap_usd - tier - composite properties: symbol: type: string name: type: string nullable: true chain: type: string address: type: string market_cap_usd: type: number nullable: true tier: type: string nullable: true enum: - critical - warning - watch - ok description: Risk tier from the depeg pipeline. composite: $ref: '#/components/schemas/V3Composite' pagination: type: object required: - total - page - pageSize - totalPages properties: total: type: integer page: type: integer pageSize: type: integer totalPages: type: integer grade_counts: type: object additionalProperties: type: integer description: >- Grade-letter histogram over the full filtered set, in the resolved scheme's letters. generated_at: type: string stale: type: boolean example: 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 '400': description: Invalid chain or grading_scheme. '403': description: Missing or invalid x-api-key. security: - api_key: [] components: schemas: V3Composite: type: object description: >- 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. The letter set in `grade` depends on `grading_scheme`: `v2` (default, standard 11-band scale) emits `C+` and never `E`; `v1` (frozen legacy scale) emits `E` and never `C+`. allOf: - oneOf: - title: grading_scheme v2 (standard) properties: grading_scheme: type: string enum: - v2 grade: type: string enum: - A+ - A - A- - B+ - B - B- - C+ - C - C- - D - F - title: grading_scheme v1 (legacy) properties: grading_scheme: type: string enum: - v1 grade: type: string enum: - A+ - A - A- - B+ - B - B- - C - C- - D - E - F properties: grading_scheme: type: string enum: - v1 - v2 example: v2 grade: type: string description: >- Letter grade. Valid set depends on `grading_scheme` (see the `oneOf` above): v2 → no `E`, has `C+`; v1 → has `E`, no `C+`. The enum here is the union across both schemes. enum: - A+ - A - A- - B+ - B - B- - C+ - C - C- - D - E - F stars: type: integer minimum: 1 maximum: 5 score: type: number description: 0–100, higher = worse; rounded to one decimal. contributors: type: object description: 'Dense map: every WebacyCategory key is present.' additionalProperties: $ref: '#/components/schemas/V3Contributor' upstream_risk: type: number description: >- Verbatim upstream pipeline risk (0–100, higher = worse). Acts as a lower bound on `score`. clamped_by_upstream: type: boolean description: >- true iff upstream_risk exceeded the framework composite and pulled `score` up. required: - grading_scheme - grade - stars - score - contributors - upstream_risk - clamped_by_upstream V3Contributor: type: object description: >- One row of `composite.contributors`: a category's resolved score and its weight under the current grading scheme. properties: score: type: number description: 0–100, higher = worse. Integer. weight: type: number description: >- Category weight under the grading scheme (sums to 1 across categories). required: - score - weight securitySchemes: api_key: type: apiKey in: header name: x-api-key ````