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

> Append-only log of every change to an already-published day: the day, when and why it was restated, the composite, USDC and USDT rates before and after, the vaults added or removed, how many weights changed, and the day's `content_hash` before and after. Entries are in the order they were logged (oldest `restated_at` first). Empty when nothing has ever been restated. When the log cannot be read the endpoint returns 503, never an empty log. A new entry can take up to 5 minutes to appear. 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/restatements
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/restatements:
    get:
      tags:
        - Yield
      summary: List Dollar Rate restatements
      description: >-
        Append-only log of every change to an already-published day: the day,
        when and why it was restated, the composite, USDC and USDT rates before
        and after, the vaults added or removed, how many weights changed, and
        the day's `content_hash` before and after. Entries are in the order they
        were logged (oldest `restated_at` first). Empty when nothing has ever
        been restated. When the log cannot be read the endpoint returns 503,
        never an empty log. A new entry can take up to 5 minutes to appear. 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: listDollarRateRestatements
      responses:
        '200':
          description: 'The restatement log. Example: a log with one entry.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DollarRateRestatementsResponse'
              example:
                entries:
                  - date: '2026-10-30'
                    restated_at: '2026-11-05T18:19:05.990437+00:00'
                    reason: Recomputed from corrected source share-price data
                    rates_before:
                      composite: 0.042332
                      usdc: 0.043475
                      usdt: 0.033122
                    rates_after:
                      composite: 0.038882
                      usdc: 0.041662
                      usdt: 0.033936
                    vaults_added:
                      - USDC:arb:0x724dc807b04555b71ed48a6896b6f41593b8c637
                      - USDC:avax:0x625e7708f30ca75bfd92586e17077590c60eb4cd
                    vaults_removed:
                      - USDC:base:0x618495ccc4e751178c4914b1e939c0fe0fb07b9b
                    weights_changed: 115
                    hash_before: >-
                      sha256:d039fdb4c5b124ed4f78fdf69a8e4feabe953267e5b3f54fc88857ea422658e4
                    hash_after: >-
                      sha256:c64cec704c8ec84c3d1fe7edfffb0aaa52c0deb7bc8e2be69dfe976cd74abc91
                total: 1
                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.
        '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/restatements
                    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/restatements
                    message: >-
                      This route requires an API key in the x-api-key header; it
                      is not available via keyless x402 payment
        '503':
          description: >-
            The log could not be read right now (upstream data outage). Retry
            later.
          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/restatements
                message: dollar rate restatement log 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:
    DollarRateRestatementsResponse:
      type: object
      required:
        - entries
        - total
        - stale
        - field_notes
      properties:
        entries:
          type: array
          description: >-
            Every restatement in the order it was logged, so oldest
            `restated_at` first. Empty when nothing has ever been restated.
          items:
            $ref: '#/components/schemas/DollarRateRestatement'
        total:
          type: integer
          description: Number of entries.
          example: 1
        stale:
          type: boolean
          description: >-
            Always false: an older copy of the log is never served (the endpoint
            returns 503 instead). The log is cached for up to 5 minutes, so a
            new restatement can take that long to appear.
          example: false
        field_notes:
          $ref: '#/components/schemas/DollarRateFieldNotes'
    DollarRateRestatement:
      type: object
      description: One change to an already-published day.
      required:
        - date
        - restated_at
        - reason
        - rates_before
        - rates_after
        - vaults_added
        - vaults_removed
        - weights_changed
        - hash_before
        - hash_after
      properties:
        date:
          type: string
          description: The day that was restated.
          format: date
          example: '2026-10-30'
        restated_at:
          type: string
          description: When it was restated.
          format: date-time
          example: '2026-11-05T18:19:05.990437+00:00'
        reason:
          type: string
          description: >-
            Why the day was restated, as a short curated sentence. Currently one
            of "Recomputed from corrected source share-price data" or, when no
            specific wording applies, "Corrected after publication". Display
            text: more sentences may be added.
          example: Recomputed from corrected source share-price data
        rates_before:
          type: object
          required:
            - composite
            - usdc
            - usdt
          properties:
            composite:
              type: number
              nullable: true
            usdc:
              type: number
              nullable: true
            usdt:
              type: number
              nullable: true
          description: Composite, USDC and USDT rates as first published.
          example:
            composite: 0.042332
            usdc: 0.043475
            usdt: 0.033122
        rates_after:
          type: object
          required:
            - composite
            - usdc
            - usdt
          properties:
            composite:
              type: number
              nullable: true
            usdc:
              type: number
              nullable: true
            usdt:
              type: number
              nullable: true
          description: The same rates after the restatement.
          example:
            composite: 0.038882
            usdc: 0.041662
            usdt: 0.033936
        vaults_added:
          type: array
          items:
            type: string
          description: Vaults that joined the day's rate, as `ASSET:chain:address`.
          example:
            - USDC:arb:0x724dc807b04555b71ed48a6896b6f41593b8c637
        vaults_removed:
          type: array
          items:
            type: string
          description: Vaults that left the day's rate, as `ASSET:chain:address`.
          example:
            - USDC:base:0x618495ccc4e751178c4914b1e939c0fe0fb07b9b
        weights_changed:
          type: integer
          description: Vaults whose weight changed.
          example: 115
        hash_before:
          type: string
          description: The day's `content_hash` before.
          example: >-
            sha256:d039fdb4c5b124ed4f78fdf69a8e4feabe953267e5b3f54fc88857ea422658e4
        hash_after:
          type: string
          description: >-
            The day's `content_hash` after; what
            `/yield/dollar-rate/constituents?date=` now returns.
          example: >-
            sha256:c64cec704c8ec84c3d1fe7edfffb0aaa52c0deb7bc8e2be69dfe976cd74abc91
    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.