> ## 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 Dollar Rate history

> Daily history of the composite, USDC and USDT rates with their T-bill spreads and grade-tier rates, a total-return index per rate (base 100), and summaries over the full series (`stats`) and the last 3, 6 and 12 months (`windows`). `from` / `to` limit the points and index levels to a date range (levels are never rebased) and add `window_stats` for that range. 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/series
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/series:
    get:
      tags:
        - Yield
      summary: Get the Dollar Rate history
      description: >-
        Daily history of the composite, USDC and USDT rates with their T-bill
        spreads and grade-tier rates, a total-return index per rate (base 100),
        and summaries over the full series (`stats`) and the last 3, 6 and 12
        months (`windows`). `from` / `to` limit the points and index levels to a
        date range (levels are never rebased) and add `window_stats` for that
        range. 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: getDollarRateSeries
      parameters:
        - name: from
          in: query
          required: false
          description: >-
            Only points on or after this date (YYYY-MM-DD). Adds `window_stats`
            for the range. Returns 400 for any other format or when after `to`.
          schema:
            type: string
            format: date
          example: '2026-10-01'
        - name: to
          in: query
          required: false
          description: >-
            Only points on or before this date (YYYY-MM-DD). Adds `window_stats`
            for the range. Returns 400 for any other format.
          schema:
            type: string
            format: date
          example: '2026-11-17'
      responses:
        '200':
          description: The series. Example trimmed to two points and one rate per summary.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DollarRateSeriesResponse'
              example:
                name: Webacy On-Chain Dollar Rate (indicative)
                indicative: true
                updated_at: '2026-11-17T18:06:10.504672+00:00'
                stats_version: dollar-rate-stats-v0.4.0
                stats:
                  - series: composite
                    as_of: '2026-11-17'
                    current: 0.040881
                    change_30d: 0.003538
                    change_30d_from: '2026-10-18'
                    change_1y: -0.00778
                    change_1y_from: '2025-11-17'
                    average_1y: 0.036559
                    high_1y: 0.048661
                    high_date: '2025-11-17'
                    low_1y: 0.0287
                    low_date: '2026-04-17'
                    days: 366
                    window_start: '2025-11-17'
                windows:
                  3m:
                    requested_start: '2026-08-18'
                    requested_end: '2026-11-17'
                    start: '2026-08-18'
                    end: '2026-11-17'
                    clamped: false
                    rates:
                      - series: composite
                        days: 92
                        backfilled_days: 66
                        live_days: 26
                        unknown_provenance_days: 0
                        start_date: '2026-08-18'
                        start_value: 0.035608
                        end_date: '2026-11-17'
                        end_value: 0.040881
                        change: 0.005273
                        average: 0.037133
                        high: 0.040881
                        high_date: '2026-11-17'
                        low: 0.035192
                        low_date: '2026-09-15'
                        spread_average: -0.001666
                        spread_days: 92
                index:
                  base: 100
                  base_date: '2025-10-22'
                  method: >-
                    level_t = level_{t-1} * (1 + r_t) ** (1/365); r_t = realized
                    90-day APY, net of fees
                  flat_days:
                    composite: 0
                    usdc: 0
                    usdt: 0
                  missing_days: 0
                  levels:
                    - date: '2026-11-17'
                      provenance: live
                      composite: 104.021154
                      usdc: 104.368346
                      usdt: 103.545663
                points:
                  - date: '2026-10-01'
                    composite: 0.036929
                    usdc: 0.039729
                    usdt: 0.032194
                    usdc_vaults: 109
                    usdt_vaults: 33
                    tvl_usd: 9138551818.59
                    provenance: backfilled
                    tbill_window_apy: 0.038751
                    spread: -0.001822
                    methodology_version: dollar-rate-v0.1.2
                    completeness: backfill
                    completeness_reasons:
                      - >-
                        reconstructed from historical on-chain share prices
                        (backfill)
                  - date: '2026-11-17'
                    composite: 0.040881
                    usdc: 0.043799
                    usdt: 0.035582
                    usdc_vaults: 108
                    usdt_vaults: 29
                    tvl_usd: 9324115577.23
                    provenance: live
                    completeness: full
                    completeness_reasons: []
                    tbill_window_apy: 0.039163
                    spread: 0.001718
                    grade_tiers_version: grade-tiers-v2
                    tier_A: 0.040298
                    tier_A_spread: 0.001135
                    tier_A_usdc: 0.042718
                    tier_A_usdt: 0.035941
                    tier_below_A: 0.0623
                    tier_below_A_spread: 0.023137
                    tier_below_A_usdc: 0.07048
                    tier_below_A_usdt: 0.041322
                    methodology_version: dollar-rate-v0.1.2
                window_stats:
                  requested_start: '2026-10-01'
                  requested_end: '2026-11-17'
                  start: '2026-10-01'
                  end: '2026-11-17'
                  clamped: false
                  rates:
                    - series: composite
                      days: 48
                      backfilled_days: 22
                      live_days: 26
                      unknown_provenance_days: 0
                      start_date: '2026-10-01'
                      start_value: 0.036929
                      end_date: '2026-11-17'
                      end_value: 0.040881
                      change: 0.003952
                      average: 0.038391
                      high: 0.040881
                      high_date: '2026-11-17'
                      low: 0.036929
                      low_date: '2026-10-01'
                      spread_average: -0.000868
                      spread_days: 48
                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: >-
            `from` or `to` is not a YYYY-MM-DD date, is repeated, or `from` is
            after `to`.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              examples:
                malformedDate:
                  summary: '`from` is not a YYYY-MM-DD date'
                  value:
                    statusCode: 400
                    timestamp: '2026-11-18T09:12:44.517Z'
                    path: /api/v2/yield/dollar-rate/series?from=2026-13-01
                    message: from must be a date in YYYY-MM-DD
                reversedRange:
                  summary: '`from` is after `to`'
                  value:
                    statusCode: 400
                    timestamp: '2026-11-18T09:12:44.517Z'
                    path: >-
                      /api/v2/yield/dollar-rate/series?from=2026-11-17&to=2026-10-01
                    message: from must be on or before to
        '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/series
                    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/series
                    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:
    DollarRateSeriesResponse:
      type: object
      description: >-
        Daily history of the Dollar Rate. When nothing has been published yet,
        `updated_at` is null, `stats` and `points` are empty and `stale` is
        true.
      required:
        - name
        - indicative
        - updated_at
        - stats
        - points
        - stale
        - field_notes
      properties:
        name:
          type: string
          description: Index name.
          example: Webacy On-Chain Dollar Rate (indicative)
        indicative:
          type: boolean
          description: Always true.
          example: true
        updated_at:
          type: string
          description: When the series was last updated.
          format: date-time
          nullable: true
          example: '2026-11-17T18:06:10.504672+00:00'
        stats_version:
          type: string
          description: Version of the statistics output.
          example: dollar-rate-stats-v0.4.0
        stats:
          type: array
          description: >-
            One summary per rate (composite, USDC, USDT), always over the full
            series.
          items:
            $ref: '#/components/schemas/DollarRateSeriesStat'
        windows:
          type: object
          description: >-
            The `window_stats` summary for the last 3, 6 and 12 calendar months
            to the latest point of the full series (`3m`, `6m`, `12m`); never
            affected by `from` / `to`.
          properties:
            3m:
              $ref: '#/components/schemas/DollarRateWindowStats'
            6m:
              $ref: '#/components/schemas/DollarRateWindowStats'
            12m:
              $ref: '#/components/schemas/DollarRateWindowStats'
        index:
          $ref: '#/components/schemas/DollarRateIndex'
        points:
          type: array
          description: >-
            One point per day, oldest first; limited to the range when `from` /
            `to` is given.
          items:
            $ref: '#/components/schemas/DollarRateSeriesPoint'
        window_stats:
          allOf:
            - $ref: '#/components/schemas/DollarRateWindowStats'
          description: >-
            Each rate over the requested `from`..`to` range. Present only when
            `from` or `to` is given.
        stale:
          type: boolean
          description: >-
            True when the series is more than 48h old or was served from a
            fallback copy while a refresh runs.
          example: false
        field_notes:
          $ref: '#/components/schemas/DollarRateFieldNotes'
    DollarRateSeriesStat:
      type: object
      description: Summary of one rate over the full series.
      required:
        - series
        - current
      properties:
        series:
          type: string
          description: Which rate.
          enum:
            - composite
            - usdc
            - usdt
          example: composite
        current:
          type: number
          description: Latest value.
          nullable: true
          example: 0.040881
        as_of:
          type: string
          description: Date of the latest value.
          format: date
          example: '2026-11-17'
        change_30d:
          type: number
          description: >-
            Latest minus the value on the last day at least 30 days earlier
            (`change_30d_from`). Null when the series does not reach back 30
            days.
          nullable: true
          example: 0.003538
        change_30d_from:
          type: string
          description: Day `change_30d` is measured from.
          format: date
          nullable: true
          example: '2026-10-18'
        change_1y:
          type: number
          description: Latest minus the value on the last day at least a year earlier.
          nullable: true
          example: -0.00778
        change_1y_from:
          type: string
          description: Day `change_1y` is measured from.
          format: date
          nullable: true
          example: '2025-11-17'
        average_1y:
          type: number
          description: Simple average over the last 365 days.
          example: 0.036559
        high_1y:
          type: number
          description: Highest daily value over the last 365 days.
          example: 0.048661
        high_date:
          type: string
          description: Day of `high_1y`.
          format: date
          example: '2025-11-17'
        low_1y:
          type: number
          description: Lowest daily value over the last 365 days.
          example: 0.0287
        low_date:
          type: string
          description: Day of `low_1y`.
          format: date
          example: '2026-04-17'
        days:
          type: integer
          description: Points in the 365-day window.
          example: 366
        window_start:
          type: string
          description: First day used for the 1y figures.
          format: date
          example: '2025-11-17'
    DollarRateWindowStats:
      type: object
      description: >-
        Each rate over a date range (inclusive). A bound beyond either end of
        the series is clamped to it (`clamped: true`); nothing is extrapolated.
        A range with no overlap returns `start` and `end` null with 0 days per
        rate.
      required:
        - requested_start
        - requested_end
        - start
        - end
        - clamped
        - rates
      properties:
        requested_start:
          type: string
          description: Requested first day.
          format: date
          nullable: true
          example: '2026-10-01'
        requested_end:
          type: string
          description: Requested last day.
          format: date
          nullable: true
          example: '2026-11-17'
        start:
          type: string
          description: First day actually covered.
          format: date
          nullable: true
          example: '2026-10-01'
        end:
          type: string
          description: Last day actually covered.
          format: date
          nullable: true
          example: '2026-11-17'
        clamped:
          type: boolean
          description: True when a requested bound was outside the series.
          example: false
        rates:
          type: array
          items:
            $ref: '#/components/schemas/DollarRateWindowRate'
    DollarRateIndex:
      type: object
      description: >-
        Total-return index per rate: base 100 on the first day of the full
        series (`base_date`), then level = previous level x (1 + rate)^(1/365).
        A day with no usable rate holds the level flat (`flat_days`); a calendar
        day missing from the series accrues nothing (`missing_days`). With
        `from` / `to` the levels are sliced, never rebased: the return between
        two dates is level_end / level_start - 1.
      required:
        - base
        - base_date
        - method
        - flat_days
        - missing_days
        - levels
      properties:
        base:
          type: number
          description: Starting level.
          example: 100
        base_date:
          type: string
          description: First day of the full series.
          format: date
          example: '2025-10-22'
        method:
          type: string
          description: The compounding formula.
          example: >-
            level_t = level_{t-1} * (1 + r_t) ** (1/365); r_t = realized 90-day
            APY, net of fees
        flat_days:
          type: object
          description: Days held flat, per rate.
          additionalProperties:
            type: integer
          example:
            composite: 0
            usdc: 0
            usdt: 0
        missing_days:
          type: integer
          description: Calendar days missing from the series.
          example: 0
        levels:
          type: array
          items:
            $ref: '#/components/schemas/DollarRateIndexLevel'
    DollarRateSeriesPoint:
      type: object
      description: >-
        One day of the series. Fields added later (`tbill_window_apy`, `spread`,
        the `tier_*` fields) are absent on points written before them.
      required:
        - date
        - composite
        - usdc
        - usdt
        - usdc_vaults
        - usdt_vaults
        - tvl_usd
        - provenance
        - methodology_version
      properties:
        date:
          type: string
          description: Day (YYYY-MM-DD).
          format: date
          example: '2026-11-17'
        composite:
          type: number
          description: Composite rate. Decimal (0.0438 = 4.38%).
          nullable: true
          example: 0.040881
        usdc:
          type: number
          description: USDC rate.
          nullable: true
          example: 0.043799
        usdt:
          type: number
          description: USDT rate.
          nullable: true
          example: 0.035582
        usdc_vaults:
          type: integer
          description: Eligible USDC vaults.
          example: 108
        usdt_vaults:
          type: integer
          description: Eligible USDT vaults.
          example: 29
        tvl_usd:
          type: number
          description: TVL in the composite, in USD.
          example: 9324115577.23
        provenance:
          type: string
          description: >-
            `live` (computed on the day) or `backfilled` (reconstructed from
            archived on-chain share prices).
          example: live
        completeness:
          type: string
          description: How complete the day's input was (e.g. `full`, `backfill`).
          example: full
        completeness_reasons:
          type: array
          items:
            type: string
          description: Why the day is less than complete; empty when full.
        methodology_version:
          type: string
          description: Rate formula version.
          example: dollar-rate-v0.1.2
        tbill_window_apy:
          type: number
          description: 3-month T-bill APY at the start of the 90-day window.
          nullable: true
          example: 0.039163
        spread:
          type: number
          description: Composite minus `tbill_window_apy`. Decimal (0.001 = 10 bp).
          nullable: true
          example: 0.001718
        grade_tiers_version:
          type: string
          description: Version of the tier fields on this point.
          example: grade-tiers-v2
        tier_A:
          type: number
          description: Grade-A tier composite.
          nullable: true
          example: 0.040298
        tier_A_spread:
          type: number
          description: Grade-A tier composite minus `tbill_window_apy`.
          nullable: true
          example: 0.001135
        tier_A_usdc:
          type: number
          description: Grade-A tier USDC rate.
          nullable: true
          example: 0.042718
        tier_A_usdt:
          type: number
          description: Grade-A tier USDT rate.
          nullable: true
          example: 0.035941
        tier_below_A:
          type: number
          description: Below-A tier composite.
          nullable: true
          example: 0.0623
        tier_below_A_spread:
          type: number
          description: Below-A tier composite minus `tbill_window_apy`.
          nullable: true
          example: 0.023137
        tier_below_A_usdc:
          type: number
          description: Below-A tier USDC rate.
          nullable: true
          example: 0.07048
        tier_below_A_usdt:
          type: number
          description: Below-A tier USDT rate.
          nullable: true
          example: 0.041322
    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.'
    DollarRateWindowRate:
      type: object
      description: >-
        One rate over a date range. With 0 days in the range only `series` and
        the day counts are present.
      required:
        - series
        - days
      properties:
        series:
          type: string
          description: Which rate.
          enum:
            - composite
            - usdc
            - usdt
          example: composite
        days:
          type: integer
          description: Points in the range.
          example: 92
        backfilled_days:
          type: integer
          description: Of which backfilled.
          example: 66
        live_days:
          type: integer
          description: Of which live.
          example: 26
        unknown_provenance_days:
          type: integer
          description: Of which neither; the three add up to `days`.
          example: 0
        start_date:
          type: string
          description: First point in the range.
          format: date
          example: '2026-08-18'
        start_value:
          type: number
          description: Its value.
          example: 0.035608
        end_date:
          type: string
          description: Last point in the range.
          format: date
          example: '2026-11-17'
        end_value:
          type: number
          description: Its value.
          example: 0.040881
        change:
          type: number
          description: '`end_value` minus `start_value`. Decimal (0.001 = 10 bp).'
          example: 0.005273
        average:
          type: number
          description: Simple average over the range.
          example: 0.037133
        high:
          type: number
          description: Highest value.
          example: 0.040881
        high_date:
          type: string
          description: Its day.
          format: date
          example: '2026-11-17'
        low:
          type: number
          description: Lowest value.
          example: 0.035192
        low_date:
          type: string
          description: Its day.
          format: date
          example: '2026-09-15'
        spread_average:
          type: number
          description: 'Composite only: mean spread over the T-bill window APY.'
          nullable: true
          example: -0.001666
        spread_days:
          type: integer
          description: 'Composite only: points with a spread.'
          example: 92
    DollarRateIndexLevel:
      type: object
      required:
        - date
        - provenance
        - composite
        - usdc
        - usdt
      properties:
        date:
          type: string
          description: Day.
          format: date
          example: '2026-11-17'
        provenance:
          type: string
          description: That day's provenance (`live` or `backfilled`).
          nullable: true
          example: live
        composite:
          type: number
          description: Composite index level.
          example: 104.021154
        usdc:
          type: number
          description: USDC index level.
          example: 104.368346
        usdt:
          type: number
          description: USDT index level.
          example: 103.545663
  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.