> ## 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.

# Get the newest Dollar Rate

> The Webacy On-Chain Dollar Rate for the newest published day: the realized 90-day APY depositors earned lending USDC and USDT in DeFi vaults, net of fees and excluding reward programs, TVL-weighted across eligible vaults with a per-vault cap. Returns the USDC, USDT and composite rates, the rate within each Webacy grade bucket (`curve`) and grade tier (`tiers`), a by-venue breakdown, the eligibility funnel, what moved the composite since the previous day (`stats.attribution`) and the spread over 3-month US Treasury bills (`benchmark`). Updated several times a day. `attribution` and `benchmark` are absent on days published before they were added. 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
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:
    get:
      tags:
        - Yield
      summary: Get the newest Dollar Rate
      description: >-
        The Webacy On-Chain Dollar Rate for the newest published day: the
        realized 90-day APY depositors earned lending USDC and USDT in DeFi
        vaults, net of fees and excluding reward programs, TVL-weighted across
        eligible vaults with a per-vault cap. Returns the USDC, USDT and
        composite rates, the rate within each Webacy grade bucket (`curve`) and
        grade tier (`tiers`), a by-venue breakdown, the eligibility funnel, what
        moved the composite since the previous day (`stats.attribution`) and the
        spread over 3-month US Treasury bills (`benchmark`). Updated several
        times a day. `attribution` and `benchmark` are absent on days published
        before they were added. 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: getDollarRate
      responses:
        '200':
          description: 'The newest day. `date: null` means nothing has been published yet.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DollarRateLatestResponse'
              example:
                date: '2026-11-17'
                computed_at: '2026-11-17T18:06:10.203129+00:00'
                published_at: '2026-11-17T18:06:10.577308+00:00'
                name: Webacy On-Chain Dollar Rate (indicative)
                indicative: true
                methodology_version: dollar-rate-v0.1.2
                measure: realized_90d
                net_of_fees: true
                incentives: excluded
                cap: 0.25
                min_tvl_usd: 1000000
                negative_apy_vaults: 0
                rates:
                  USDC:
                    vaults: 108
                    tvl_usd: 6012616549.23
                    rate: 0.043799
                    rate_uncapped: 0.043033
                    median: 0.049717
                    capped_vaults: 1
                    top_vault: eth:0x98c23e9d8f34fefb1b7bd6a91b7ff122f4e16f5c
                    top_weight: 0.25
                  USDT:
                    vaults: 29
                    tvl_usd: 3311499028
                    rate: 0.035582
                    rate_uncapped: 0.038023
                    median: 0.034029
                    capped_vaults: 1
                    top_vault: eth:0x23878914efe38d27c4d67ab83ed1b93a74d4086a
                    top_weight: 0.25
                composite:
                  method: B_eligible_tvl_blend
                  rate: 0.040881
                  vaults: 137
                  tvl_usd: 9324115577.23
                  weights:
                    USDC: 0.6448
                    USDT: 0.3552
                excluded:
                  counterparty_lp: 2
                  deposits_not_open: 27
                  no_realized_90d: 28
                  no_yield: 5
                  rwa_fund: 25
                  tvl_below_floor: 88
                constituents_hash: >-
                  sha256:ebac319ca887861c75720ca1c3c90852e0b134a9230a4fe42e2882e8c6e8bc83
                benchmark:
                  source: US Treasury daily par yield curve, 3 Mo (home.treasury.gov)
                  basis: APY, 91-day compounding
                  window_start: '2026-08-19'
                  tbill_window_date: '2026-08-19'
                  tbill_window_apy: 0.039163
                  tbill_spot_date: '2026-11-16'
                  tbill_spot_apy: 0.044112
                  spread: 0.001718
                  spread_spot: -0.003231
                stale: false
                curve:
                  USDC:
                    A:
                      vaults: 84
                      tvl_usd: 5841570703.48
                      rate: 0.042718
                      rate_uncapped: 0.042229
                      median: 0.045588
                      capped_vaults: 1
                      top_vault: eth:0x98c23e9d8f34fefb1b7bd6a91b7ff122f4e16f5c
                      top_weight: 0.25
                    D:
                      vaults: 0
                      tvl_usd: 0
                      rate: null
                      reason: fewer_than_5_vaults
                    grade_coverage_tvl: 1
                tiers:
                  version: grade-tiers-v2
                  A:
                    grades:
                      - A
                    rates:
                      USDC:
                        vaults: 84
                        tvl_usd: 5841570703.48
                        rate: 0.042718
                        rate_uncapped: 0.042229
                        median: 0.045588
                        capped_vaults: 1
                        top_vault: eth:0x98c23e9d8f34fefb1b7bd6a91b7ff122f4e16f5c
                        top_weight: 0.25
                      USDT:
                        vaults: 23
                        tvl_usd: 3244804231.22
                        rate: 0.035941
                        rate_uncapped: 0.038145
                        median: 0.033818
                        capped_vaults: 1
                        top_vault: eth:0x23878914efe38d27c4d67ab83ed1b93a74d4086a
                        top_weight: 0.25
                    composite:
                      method: B_eligible_tvl_blend
                      rate: 0.040298
                      vaults: 107
                      tvl_usd: 9086374934.7
                      weights:
                        USDC: 0.6429
                        USDT: 0.3571
                stats:
                  version: dollar-rate-stats-v0.4.0
                  grouping: base_protocol_else_protocol
                  by_protocol:
                    - protocol: morpho
                      vaults: 102
                      tvl_usd: 2994741541.58
                      share_of_tvl: 0.321182
                      share_of_rate: 0.597071
                      realized_90d: 0.043893
                    - protocol: aave
                      vaults: 13
                      tvl_usd: 6232521820.34
                      share_of_tvl: 0.66843
                      share_of_rate: 0.382435
                      realized_90d: 0.039593
                  funnel:
                    - stage: tracked
                      count: 312
                    - stage: rwa_fund
                      count: 25
                    - stage: counterparty_lp
                      count: 2
                    - stage: deposits_not_open
                      count: 27
                    - stage: no_realized_90d
                      count: 28
                    - stage: no_yield
                      count: 5
                    - stage: tvl_below_floor
                      count: 88
                    - stage: in_rate
                      count: 137
                  attribution:
                    from: '2026-11-16'
                    change: 0.00014645
                    yield_effect: 0.00009888
                    weight_effect: -0.0000268
                    entries:
                      vaults: 3
                      effect: 0.00007401
                    exits:
                      vaults: 0
                      effect: 0
                    residual: 3.666e-7
                    top_movers:
                      - vault: arb:0x724dc807b04555b71ed48a6896b6f41593b8c637
                        name: Aave V3 USDC
                        protocol: aave
                        asset: USDC
                        contribution: 0.00007446
                        cause: weight
                        realized_90d_from: 0.02809684
                        realized_90d_to: 0.02904687
                      - vault: eth:0xc35ce0c1acfc448d18ddacbf641b09f2a18e1958
                        name: 1212.Alpha
                        protocol: lagoon
                        asset: USDC
                        contribution: 0.00006717
                        cause: entered
                        realized_90d_from: null
                        realized_90d_to: 0.29810627
                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.
        '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
                    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
                    message: >-
                      This route requires an API key in the x-api-key header; it
                      is not available via keyless x402 payment
      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:
    DollarRateLatestResponse:
      type: object
      description: >-
        The newest published day. When nothing has been published yet, `date`,
        `computed_at`, `composite`, `curve` and `stats` are null, `rates` and
        `excluded` are empty and `stale` is true.
      required:
        - date
        - computed_at
        - rates
        - composite
        - curve
        - excluded
        - stats
        - stale
        - field_notes
      properties:
        date:
          type: string
          description: >-
            The day the rate is for (YYYY-MM-DD); null when nothing has been
            published.
          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'
        published_at:
          type: string
          description: When the day was published.
          format: date-time
          example: '2026-11-17T18:06:10.577308+00:00'
        name:
          type: string
          description: Index name.
          example: Webacy On-Chain Dollar Rate (indicative)
        indicative:
          type: boolean
          description: 'Always true: an indicative index, not a regulated benchmark.'
          example: true
        methodology_version:
          type: string
          description: Version of the headline rate formula.
          example: dollar-rate-v0.1.2
        measure:
          type: string
          description: The yield measure the rate averages.
          example: realized_90d
        net_of_fees:
          type: boolean
          description: 'True: vault fees are already deducted.'
          example: true
        incentives:
          type: string
          description: How reward programs are treated.
          example: excluded
        cap:
          type: number
          description: Per-vault weight cap within an asset's rate.
          example: 0.25
        min_tvl_usd:
          type: number
          description: TVL floor a vault must meet to be eligible, in USD.
          example: 1000000
        negative_apy_vaults:
          type: integer
          description: >-
            Eligible vaults with a negative realized 90-day APY (they count with
            their loss).
          example: 0
        rates:
          type: object
          description: Per-asset rates, keyed `USDC` and `USDT`.
          additionalProperties:
            $ref: '#/components/schemas/DollarRateRate'
        composite:
          description: >-
            The composite (see the schema: its `rate` is null when either
            asset's rate is withheld); null only when nothing has been
            published.
          anyOf:
            - $ref: '#/components/schemas/DollarRateComposite'
            - type: object
              nullable: true
              enum:
                - null
        curve:
          type: object
          nullable: true
          description: >-
            The rate within each Webacy grade bucket (`A` to `F`), per asset.
            Each asset also carries `grade_coverage_tvl`, the share of its TVL
            that has a grade (null when the asset has no eligible vaults). Thin
            buckets show `vaults` and `tvl_usd` with a null `rate` and a
            `reason`. Null on days with no grade data.
          additionalProperties:
            type: object
            additionalProperties: {}
        tiers:
          description: >-
            Grade-tier rates; null on a day with no grade data, absent on days
            published before tiers were added.
          anyOf:
            - $ref: '#/components/schemas/DollarRateGradeTiers'
            - type: object
              nullable: true
              enum:
                - null
        excluded:
          type: object
          description: >-
            Vaults removed by each eligibility rule, keyed by rule (the same
            names as the `stats.funnel` stages). Can also include
            `duplicate_row`: a vault listed twice in the day's input, counted
            once.
          additionalProperties:
            type: integer
        stats:
          type: object
          nullable: true
          description: Breakdowns of the day; null when nothing has been published.
          properties:
            version:
              type: string
              description: Version of the statistics output.
              example: dollar-rate-stats-v0.4.0
            grouping:
              type: string
              description: How vaults are grouped into venues.
              example: base_protocol_else_protocol
            by_protocol:
              type: array
              items:
                $ref: '#/components/schemas/DollarRateProtocolRow'
            funnel:
              type: array
              items:
                $ref: '#/components/schemas/DollarRateFunnelStage'
            attribution:
              allOf:
                - $ref: '#/components/schemas/DollarRateAttribution'
              description: Absent on days published before the attribution was added.
        benchmark:
          allOf:
            - $ref: '#/components/schemas/DollarRateBenchmark'
          description: Absent on days published before the benchmark was added.
        constituents_hash:
          type: string
          description: >-
            The day's constituents `content_hash` (see
            `/yield/dollar-rate/constituents`).
          example: >-
            sha256:ebac319ca887861c75720ca1c3c90852e0b134a9230a4fe42e2882e8c6e8bc83
        unresolved_underlying_by_reason:
          type: object
          description: >-
            Vaults whose deposit token could not be identified
            (`excluded.unresolved_underlying`), counted by `unresolved_reason`
            (see `/yield/dollar-rate/constituents`). Absent on days published
            before methodology `dollar-rate-v0.1.3`.
          additionalProperties:
            type: integer
          example:
            onchain_asset_unreadable: 1
        unresolved_underlying_tvl_usd:
          type: number
          description: >-
            Total TVL in USD of the vaults whose deposit token could not be
            identified, counting only a published USD TVL (never a balance
            valued at $1). Absent on days published before methodology
            `dollar-rate-v0.1.3`.
          example: 875000000
        rows_outside_rate_chains:
          type: integer
          description: >-
            Vaults that day on chains with no canonical USDC or USDT (for
            example Solana or Stellar). They can never be in the rate, so they
            are not in `stats.funnel` or the constituents. Absent on days
            published before methodology `dollar-rate-v0.1.3`.
          example: 55
        stale:
          type: boolean
          description: >-
            True when the data is more than 48h old, or was served from a
            fallback copy while a refresh runs (can be briefly true on a healthy
            service). Key a "data delayed" notice on the age of `computed_at`,
            not on `stale` alone.
          example: false
        field_notes:
          $ref: '#/components/schemas/DollarRateFieldNotes'
    DollarRateRate:
      type: object
      description: >-
        One rate over a set of vaults (an asset, a grade bucket or a grade
        tier). When no rate can be computed for the set it is withheld: `rate`
        is null, `reason` says why, and only `rate`, `reason`, `vaults` and
        `tvl_usd` are present.
      required:
        - rate
        - vaults
        - tvl_usd
      properties:
        rate:
          type: number
          description: >-
            TVL-weighted realized 90-day APY across the eligible vaults, net of
            fees, excluding reward programs, with no vault above the per-vault
            cap. Decimal (0.0438 = 4.38%). Null when withheld.
          nullable: true
          example: 0.043799
        vaults:
          type: integer
          description: Eligible vaults in this rate.
          example: 108
        tvl_usd:
          type: number
          description: TVL of those vaults, in USD.
          example: 6012616549.23
        rate_uncapped:
          type: number
          description: The same rate with no per-vault cap (plain TVL weights).
          example: 0.043033
        median:
          type: number
          description: Median realized 90-day APY of the vaults.
          example: 0.049717
        capped_vaults:
          type: integer
          description: Vaults held at the per-vault cap.
          example: 1
        top_vault:
          type: string
          description: The vault with the largest weight, as `chain:address`.
          example: eth:0x98c23e9d8f34fefb1b7bd6a91b7ff122f4e16f5c
        top_weight:
          type: number
          description: That vault's weight in the rate (at most `cap`).
          example: 0.25
        reason:
          type: string
          nullable: true
          description: >-
            Why the rate is withheld. Present only when `rate` is null. Values:
            `fewer_than_5_vaults` (too few eligible vaults; one vault would be
            the rate) or `cap_infeasible` (no weighting keeps every vault within
            the per-vault cap). Null when the reason is not one of these values.
          example: fewer_than_5_vaults
    DollarRateComposite:
      type: object
      description: >-
        The USDC and USDT rates blended by their eligible TVL, so it always lies
        between the two. Always an object; `rate` is null when either asset's
        rate is withheld, and `vaults`, `tvl_usd` and `weights` then cover only
        the asset that has a rate.
      required:
        - method
        - rate
        - vaults
        - tvl_usd
      properties:
        method:
          type: string
          description: How the two rates are blended.
          example: B_eligible_tvl_blend
        rate:
          type: number
          description: >-
            The composite rate. Decimal (0.0438 = 4.38%). Null when either the
            USDC or the USDT rate is withheld.
          nullable: true
          example: 0.040881
        vaults:
          type: integer
          description: Eligible vaults in the composite (of the assets that have a rate).
          example: 137
        tvl_usd:
          type: number
          description: Their combined TVL, in USD.
          example: 9324115577.23
        weights:
          type: object
          description: >-
            Each asset's share of eligible TVL, i.e. its weight in the
            composite; only the assets that have a rate.
          additionalProperties:
            type: number
          example:
            USDC: 0.6448
            USDT: 0.3552
    DollarRateGradeTiers:
      type: object
      description: >-
        The rate in two grade tiers: `A` (Webacy grade A) and `below_A` (B to
        F). Ungraded vaults are in neither tier.
      properties:
        version:
          type: string
          description: Version of the tier output; independent of `methodology_version`.
          example: grade-tiers-v2
        A:
          $ref: '#/components/schemas/DollarRateGradeTier'
        below_A:
          $ref: '#/components/schemas/DollarRateGradeTier'
    DollarRateProtocolRow:
      type: object
      description: One lending venue's part in the composite.
      required:
        - protocol
        - vaults
        - tvl_usd
        - share_of_tvl
        - share_of_rate
        - realized_90d
      properties:
        protocol:
          type: string
          description: >-
            The venue the vaults lend on: the base protocol when set (a curator
            vault counts under e.g. Morpho), else the protocol.
          example: morpho
        vaults:
          type: integer
          description: Eligible vaults on this venue.
          example: 102
        tvl_usd:
          type: number
          description: Their TVL, in USD.
          example: 2994741541.58
        share_of_tvl:
          type: number
          description: The venue's share of the TVL in the rate.
          nullable: true
          example: 0.321182
        share_of_rate:
          type: number
          description: >-
            The venue's combined share of the composite (sum of its vaults'
            composite weights), after the per-vault cap.
          example: 0.597071
        realized_90d:
          type: number
          description: >-
            TVL-weighted realized 90-day APY of the venue's vaults. Decimal
            (0.0438 = 4.38%).
          nullable: true
          example: 0.043893
    DollarRateFunnelStage:
      type: object
      description: >-
        One stage of the eligibility funnel. Stages, in order: `tracked` (all
        USDC and USDT vaults, plus from methodology `dollar-rate-v0.1.3` the
        vaults on the same chains whose deposit token could not be identified),
        then one per exclusion rule (`unresolved_underlying` from
        `dollar-rate-v0.1.3`, then `rwa_fund`, `counterparty_lp`,
        `known_bad_tvl`, `deposits_not_open`, `no_realized_90d`, `no_yield`,
        `apy_out_of_bounds`, `no_tvl`, `tvl_below_floor`; a rule that removed
        nothing may be absent), `rate_withheld` when an asset's rate was
        withheld for having too few vaults, and `in_rate`. The exclusion stages,
        `rate_withheld` and `in_rate` add up to `tracked`.
      required:
        - stage
        - count
      properties:
        stage:
          type: string
          description: Stage name.
          example: tvl_below_floor
        count:
          type: integer
          description: Vaults at this stage.
          example: 88
    DollarRateAttribution:
      type: object
      description: >-
        What moved the composite since the previous day: `change` =
        `yield_effect` + `weight_effect` + `entries.effect` + `exits.effect` +
        `residual`. With no previous day, `from` and `change` are null,
        `unavailable_reason` is set and the other fields are absent.
      required:
        - from
        - change
      properties:
        from:
          type: string
          description: The previous day compared against (YYYY-MM-DD).
          format: date
          nullable: true
          example: '2026-11-16'
        change:
          type: number
          description: Composite change since `from`, in decimal (0.0001 = 1 bp).
          nullable: true
          example: 0.00014645
        yield_effect:
          type: number
          description: Part of the change from vaults' own realized yields moving.
          example: 0.00009888
        weight_effect:
          type: number
          description: Part from TVL moving between vaults, or the cap binding.
          example: -0.0000268
        entries:
          type: object
          description: Vaults that joined the rate.
          properties:
            vaults:
              type: integer
            effect:
              type: number
          example:
            vaults: 3
            effect: 0.00007401
        exits:
          type: object
          description: Vaults that left the rate.
          properties:
            vaults:
              type: integer
            effect:
              type: number
          example:
            vaults: 0
            effect: 0
        residual:
          type: number
          description: >-
            Rounding left over (near zero), or the gap on a day when the USDC or
            USDT rate is withheld.
          example: 3.666e-7
        top_movers:
          type: array
          description: Up to 5 vaults with the largest contribution either way.
          items:
            $ref: '#/components/schemas/DollarRateAttributionMover'
        unavailable_reason:
          type: string
          nullable: true
          description: >-
            Why there is no attribution: `no previous day`. Present only then;
            null when the reason is not that value.
          example: no previous day
    DollarRateBenchmark:
      type: object
      description: The composite against 3-month US Treasury bills.
      required:
        - source
        - basis
        - window_start
        - tbill_window_date
        - tbill_window_apy
        - tbill_spot_date
        - tbill_spot_apy
        - spread
        - spread_spot
      properties:
        source:
          type: string
          description: Where the T-bill yield comes from.
          example: US Treasury daily par yield curve, 3 Mo (home.treasury.gov)
        basis:
          type: string
          description: How the yield is converted to an APY.
          example: APY, 91-day compounding
        window_start:
          type: string
          description: First day of the composite's 90-day window (YYYY-MM-DD).
          format: date
          example: '2026-08-19'
        tbill_window_date:
          type: string
          description: >-
            Date of the T-bill reading used for the window (the nearest within 7
            days of `window_start`).
          format: date
          nullable: true
          example: '2026-08-19'
        tbill_window_apy:
          type: number
          description: APY of a 3-month bill bought at the start of the window.
          nullable: true
          example: 0.039163
        tbill_spot_date:
          type: string
          description: Date of today's T-bill reading.
          format: date
          nullable: true
          example: '2026-11-16'
        tbill_spot_apy:
          type: number
          description: Today's 3-month bill APY.
          nullable: true
          example: 0.044112
        spread:
          type: number
          description: >-
            Composite minus `tbill_window_apy` (like-for-like: both cover the
            same window). Decimal (0.001 = 10 bp). Null with
            `unavailable_reason` when there is no T-bill reading; null with no
            reason when the composite is null.
          nullable: true
          example: 0.001718
        spread_spot:
          type: number
          description: >-
            Composite minus `tbill_spot_apy`. Context only: the bill is
            forward-looking and the rate trailing.
          nullable: true
          example: -0.003231
        unavailable_reason:
          type: string
          nullable: true
          description: >-
            Why `spread` is null: `no T-bill reading`, or `no T-bill reading
            within <n> days of <window_start>`. Present only then; null when the
            reason is not one of these values.
    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.'
    DollarRateGradeTier:
      type: object
      description: >-
        The rate within one grade tier: per-asset capped rates under the same
        rules as the headline, and a composite blended the same way.
      properties:
        grades:
          type: array
          items:
            type: string
          description: Webacy grade buckets in this tier.
          example:
            - A
        rates:
          type: object
          description: >-
            Per-asset rates (`USDC`, `USDT`). A thin tier shows `vaults` and
            `tvl_usd` with a null `rate`.
          additionalProperties:
            $ref: '#/components/schemas/DollarRateRate'
        composite:
          description: >-
            The tier composite: an object whose `rate` is null when either
            asset's tier rate is withheld (the below-A USDT tier is often too
            thin), or null on a day file without a tier composite.
          anyOf:
            - $ref: '#/components/schemas/DollarRateComposite'
            - type: object
              nullable: true
              enum:
                - null
    DollarRateAttributionMover:
      type: object
      description: One vault's part in the day's change of the composite.
      required:
        - vault
        - name
        - protocol
        - asset
        - contribution
        - cause
        - realized_90d_from
        - realized_90d_to
      properties:
        vault:
          type: string
          description: The vault, as `chain:address`.
          example: eth:0xc35ce0c1acfc448d18ddacbf641b09f2a18e1958
        name:
          type: string
          description: Vault name.
          nullable: true
          example: 1212.Alpha
        protocol:
          type: string
          description: The venue the vault lends on (as in `stats.by_protocol`).
          nullable: true
          example: lagoon
        asset:
          type: string
          description: '`USDC` or `USDT`.'
          nullable: true
          example: USDC
        contribution:
          type: number
          description: The vault's contribution to `change`, in decimal rate points.
          example: 0.00006717
        cause:
          type: string
          description: >-
            `yield` (its realized yield moved), `weight` (its weight moved),
            `entered` (it joined the rate) or `exited: <reason>` (it left: that
            day's exclusion reason, `rate_withheld` when its asset's rate was
            withheld, or `not_tracked` when the vault is gone).
          example: entered
        realized_90d_from:
          type: number
          description: >-
            Its realized 90-day APY on the previous day; null when it was not in
            the rate.
          nullable: true
        realized_90d_to:
          type: number
          description: Its realized 90-day APY on this day; null when it left the rate.
          nullable: true
          example: 0.29810627
  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.