> ## 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 the vaults behind the Dollar Rate

> Every USDC and USDT vault considered for the rate on the newest day, with eligibility, exclusion reason, Webacy grade, TVL, realized 90-day APY and weights. With `date`, the vaults of that day as published, with its `content_hash`: a past day changes only through a logged restatement (see `/yield/dollar-rate/restatements`). The current UTC day is still provisional: it is recomputed several times a day until it ends, a `date` response can be up to an hour old, and a day published in the last few minutes can still return 404. Filters are strict, so a typo is a 400 rather than wrong data. The Webacy On-Chain Dollar Rate is an indicative index for information only, not a regulated benchmark. Methodology: https://docs.webacy.com/dollar-rate. Beta: the Dollar Rate endpoints and their response shape may still change, including between minor versions of this specification. Requires `x-api-key`. Not available with keyless pay-per-call (x402) access or with an OAuth bearer token. Included at no compute-unit cost during the beta.



## OpenAPI

````yaml GET /yield/dollar-rate/constituents
openapi: 3.0.1
info:
  title: Risk Score API
  description: API definition for Webacy Risk Scores
  version: 1.35.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: Webhooks
    description: >-
      Subscribe to and manage real-time event notifications (currently
      DEPEG_TIER_CHANGE)
  - 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.
  - name: RWA Risk v3
    description: >-
      Webacy-native v3 RWA / stablecoin risk surface — composite grade,
      structural-health criteria, and batch scoring.
  - name: Stablecoins v3
    description: >-
      Stablecoin-only aliases of the v3 RWA routes: same grades, same shapes,
      `segment` fixed to `stablecoin`.
  - name: Yield
    description: >-
      The Webacy On-Chain Dollar Rate: an indicative daily index of the realized
      yield depositors earn lending USDC and USDT in DeFi vaults, with its
      history, constituents and restatement log. How the rate is built
      (eligibility, weighting, grade tiers):
      https://docs.webacy.com/dollar-rate. Beta: the Dollar Rate endpoints and
      their response shape may still change, including between minor versions of
      this specification. The Dollar Rate endpoints require an API key
      (`x-api-key`) and are included at no compute-unit cost during the beta.
paths:
  /yield/dollar-rate/constituents:
    get:
      tags:
        - Yield
      summary: List the vaults behind the Dollar Rate
      description: >-
        Every USDC and USDT vault considered for the rate on the newest day,
        with eligibility, exclusion reason, Webacy grade, TVL, realized 90-day
        APY and weights. With `date`, the vaults of that day as published, with
        its `content_hash`: a past day changes only through a logged restatement
        (see `/yield/dollar-rate/restatements`). The current UTC day is still
        provisional: it is recomputed several times a day until it ends, a
        `date` response can be up to an hour old, and a day published in the
        last few minutes can still return 404. Filters are strict, so a typo is
        a 400 rather than wrong data. The Webacy On-Chain Dollar Rate is an
        indicative index for information only, not a regulated benchmark.
        Methodology: https://docs.webacy.com/dollar-rate. Beta: the Dollar Rate
        endpoints and their response shape may still change, including between
        minor versions of this specification. Requires `x-api-key`. Not
        available with keyless pay-per-call (x402) access or with an OAuth
        bearer token. Included at no compute-unit cost during the beta.
      operationId: listDollarRateConstituents
      parameters:
        - name: date
          in: query
          required: false
          description: >-
            A published day (YYYY-MM-DD); omit for the newest day. Returns 404
            when that day has not been published. The current UTC day is
            provisional: it can still change until the day ends, a response for
            it can be up to an hour old, and once a day has returned 404 it
            keeps returning 404 for up to 5 minutes after it is published.
          schema:
            type: string
            format: date
          example: '2026-11-10'
        - name: asset
          in: query
          required: false
          description: >-
            Only vaults of this asset: `USDC` or `USDT`, in uppercase. A vault
            whose deposit token could not be identified (`asset` null) never
            matches.
          schema:
            type: string
            enum:
              - USDC
              - USDT
          example: USDC
        - name: eligible
          in: query
          required: false
          description: >-
            Only vaults that passed (`true`) or failed (`false`) the eligibility
            rules.
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
          example: 'true'
      responses:
        '200':
          description: >-
            The day's vaults. Example: `?asset=USDC&eligible=true`, trimmed to
            two vaults.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DollarRateConstituentsResponse'
              example:
                date: '2026-11-17'
                computed_at: '2026-11-17T18:06:10.203129+00:00'
                methodology_version: dollar-rate-v0.1.2
                stats_version: dollar-rate-stats-v0.4.0
                content_hash: >-
                  sha256:ebac319ca887861c75720ca1c3c90852e0b134a9230a4fe42e2882e8c6e8bc83
                vaults:
                  - vault: eth:0x98c23e9d8f34fefb1b7bd6a91b7ff122f4e16f5c
                    name: Aave V3 USDC
                    chain: eth
                    protocol: aave
                    asset: USDC
                    grade: A
                    eligible: true
                    excluded_reason: null
                    tvl_usd: 2782730648.96
                    realized_90d: 0.04109712
                    weight: 0.25
                    composite_weight: 0.1612
                  - vault: base:0xbeeff2490feffa212fac2f6553682c219e6a8845
                    name: Steakhouse High Yield USDC Edition
                    chain: base
                    protocol: morpho
                    asset: USDC
                    grade: A
                    eligible: true
                    excluded_reason: null
                    tvl_usd: 451922896.71
                    realized_90d: 0.03162264
                    weight: 0.104939
                    composite_weight: 0.067665
                total: 108
                stale: false
                field_notes:
                  composite: >-
                    The USDC and USDT rates blended by their eligible TVL, so it
                    always lies between the two. Null when either rate is
                    withheld.
                  indicative: >-
                    Indicative index for information only: not a regulated
                    benchmark.
        '400':
          description: >-
            `asset` is not USDC or USDT, `eligible` is not true or false, `date`
            is not a YYYY-MM-DD date, or a parameter is repeated.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              examples:
                unknownAsset:
                  summary: '`asset` is not USDC or USDT'
                  value:
                    statusCode: 400
                    timestamp: '2026-11-18T09:12:44.517Z'
                    path: /api/v2/yield/dollar-rate/constituents?asset=DAI
                    message: asset must be USDC or USDT
                badEligible:
                  summary: '`eligible` is not true or false'
                  value:
                    statusCode: 400
                    timestamp: '2026-11-18T09:12:44.517Z'
                    path: /api/v2/yield/dollar-rate/constituents?eligible=yes
                    message: eligible must be true or false
                malformedDate:
                  summary: '`date` is not a YYYY-MM-DD date'
                  value:
                    statusCode: 400
                    timestamp: '2026-11-18T09:12:44.517Z'
                    path: /api/v2/yield/dollar-rate/constituents?date=2026-11-31
                    message: date must be a date in YYYY-MM-DD
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          description: >-
            Refused: these endpoints need a valid `x-api-key`. A request without
            one, including a request that carries only an OAuth bearer token,
            gets `Unauthorized`. A keyless pay-per-call (x402) request gets the
            keyless message. Send an `x-api-key`.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              examples:
                noApiKey:
                  summary: No valid x-api-key (including an OAuth bearer token)
                  value:
                    statusCode: 403
                    timestamp: '2026-11-18T09:12:44.517Z'
                    path: /api/v2/yield/dollar-rate/constituents
                    message: Unauthorized
                keylessX402:
                  summary: Keyless pay-per-call (x402) request
                  value:
                    statusCode: 403
                    timestamp: '2026-11-18T09:12:44.517Z'
                    path: /api/v2/yield/dollar-rate/constituents
                    message: >-
                      This route requires an API key in the x-api-key header; it
                      is not available via keyless x402 payment
        '404':
          description: >-
            No Dollar Rate was published for the requested `date`. A day that
            has just been published can keep returning 404 for up to 5 minutes.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              example:
                statusCode: 404
                timestamp: '2026-11-18T09:12:44.517Z'
                path: /api/v2/yield/dollar-rate/constituents?date=2020-01-01
                message: no dollar rate published for 2020-01-01
        '503':
          description: >-
            The requested `date` could not be read right now (upstream data
            outage). Retry later. Without `date` the endpoint does not return
            503: it serves the last good copy (or an empty result) marked
            `stale`.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              example:
                statusCode: 503
                timestamp: '2026-11-18T09:12:44.517Z'
                path: /api/v2/yield/dollar-rate/constituents?date=2026-11-10
                message: dollar rate archive unavailable
      security:
        - api_key: []
components:
  headers:
    XRequestId:
      description: >-
        Server-issued id for this request, returned on every response, success
        or error. Quote it to Webacy support to find the request. On risk
        endpoints it equals the `check_id` body field.
      schema:
        type: string
        format: uuid
        example: 3f1c2b9e-7a4d-4e1b-9c55-0d6a2f8e4b71
  schemas:
    DollarRateConstituentsResponse:
      type: object
      description: >-
        A day's vaults. When nothing has been published yet, `date`,
        `computed_at` and `methodology_version` are null, `vaults` is empty and
        `stale` is true.
      required:
        - date
        - computed_at
        - methodology_version
        - vaults
        - total
        - stale
        - field_notes
      properties:
        date:
          type: string
          description: The day (YYYY-MM-DD).
          format: date
          nullable: true
          example: '2026-11-17'
        computed_at:
          type: string
          description: When the day was computed.
          format: date-time
          nullable: true
          example: '2026-11-17T18:06:10.203129+00:00'
        methodology_version:
          type: string
          description: Rate formula version.
          nullable: true
          example: dollar-rate-v0.1.2
        stats_version:
          type: string
          description: Version of the statistics output.
          example: dollar-rate-stats-v0.4.0
        content_hash:
          type: string
          description: >-
            sha256 over the day's rate-bearing fields (date, methodology
            version, and each vault's membership, exclusion reason, TVL,
            realized yield and weights; names and grades are display-only and
            left out). A past day changes only through a logged restatement, so
            the hash lets you verify it has not changed since publication. The
            current UTC day is recomputed several times a day until it ends, so
            its hash can still change. Absent on days published before hashing.
          example: >-
            sha256:ebac319ca887861c75720ca1c3c90852e0b134a9230a4fe42e2882e8c6e8bc83
        vaults:
          type: array
          items:
            $ref: '#/components/schemas/DollarRateConstituent'
        total:
          type: integer
          description: Vaults returned after the `asset` / `eligible` filters.
          example: 108
        date_mismatch:
          type: boolean
          description: >-
            Present and true when the newest vault list and the newest day are
            briefly on different days during a publish; the response is then
            also `stale`. Never set with `date`.
          example: true
        stale:
          type: boolean
          description: >-
            True when the data is more than 48h old or was served from a
            fallback copy. Always false with `date`, including for the current
            UTC day, which can still change: see the `date` parameter.
          example: false
        field_notes:
          $ref: '#/components/schemas/DollarRateFieldNotes'
    DollarRateConstituent:
      type: object
      description: >-
        One USDC or USDT vault on the day, or a vault on a USDC / USDT chain
        whose deposit token could not be identified (`asset` null, never
        eligible). Days published before methodology `dollar-rate-v0.1.3` list
        no such vault.
      required:
        - vault
        - name
        - chain
        - protocol
        - asset
        - grade
        - eligible
        - excluded_reason
        - tvl_usd
        - realized_90d
        - weight
        - composite_weight
      properties:
        vault:
          type: string
          description: The vault, as `chain:address`.
          example: eth:0x98c23e9d8f34fefb1b7bd6a91b7ff122f4e16f5c
        name:
          type: string
          description: Vault name.
          nullable: true
          example: Aave V3 USDC
        chain:
          type: string
          description: Chain.
          example: eth
        protocol:
          type: string
          description: Venue (base protocol when set, else protocol).
          example: aave
        asset:
          description: >-
            Underlying asset. Null when the vault's deposit token could not be
            identified: such a vault is never eligible, its `excluded_reason` is
            `unresolved_underlying`, it carries `unresolved_reason`, and the
            `asset` filter never returns it (`eligible=false` does).
          anyOf:
            - type: string
              enum:
                - USDC
                - USDT
            - type: string
              nullable: true
              enum:
                - null
          example: USDC
        grade:
          type: string
          description: >-
            The vault's Webacy grade bucket (A to F) for that day; null when
            ungraded.
          nullable: true
          example: A
        eligible:
          type: boolean
          description: True when the vault passed every eligibility rule.
          example: true
        excluded_reason:
          type: string
          description: >-
            The rule that removed it (the same names as the `stats.funnel`
            stages of `/yield/dollar-rate`), e.g. `tvl_below_floor`, or
            `unresolved_underlying` for a vault whose deposit token could not be
            identified (`asset` null); null when eligible.
          nullable: true
        unresolved_reason:
          type: string
          description: >-
            Why the vault's deposit token could not be identified; present only
            on a row whose `excluded_reason` is `unresolved_underlying`.
            `onchain_asset_unreadable`: the vault contract answered its on-chain
            `asset()` call with no token. `rpc_error`: the on-chain read failed
            and is retried on the next update. `no_rpc`: the chain could not be
            read. `no_underlying_source`: no record of the deposit token and it
            could not be read. New values may be added.
          nullable: true
          example: onchain_asset_unreadable
        tvl_usd:
          type: number
          description: TVL in USD; null when unknown or known to be wrong.
          nullable: true
          example: 2782730648.96
        realized_90d:
          type: number
          description: >-
            Annualized growth of the vault's share price over the last 90 days,
            net of fees, excluding incentives. Decimal (0.0438 = 4.38%).
          nullable: true
          example: 0.04109712
        weight:
          type: number
          description: >-
            Share of its asset's rate after the per-vault cap; null when not
            eligible.
          nullable: true
          example: 0.25
        composite_weight:
          type: number
          description: >-
            Share of the composite: `weight` times its asset's share of eligible
            TVL; null when not eligible.
          nullable: true
          example: 0.1612
    DollarRateFieldNotes:
      type: object
      description: >-
        Plain-language definitions of the served fields, keyed by field name
        (for example `rate`, `composite`, `spread`, `index`, `content_hash`),
        for display next to the numbers (for example as tooltips). The same map
        is returned by all four endpoints. Informational text only, not part of
        the data contract: the wording can change and keys can be added or
        removed at any time, so do not parse it or depend on a key being
        present.
      additionalProperties:
        type: string
      example:
        composite: >-
          The USDC and USDT rates blended by their eligible TVL, so it always
          lies between the two. Null when either rate is withheld.
        indicative: 'Indicative index for information only: not a regulated benchmark.'
  responses:
    UnauthorizedError:
      description: Authorization information is missing or invalid
      content:
        application/json:
          example:
            message: Unauthorized
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.