> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loopscale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Acknowledge Earn Vault

> Records that a wallet accepted a vault's deposit terms. Vaults with `requiresAcknowledgment: true` expect this call before a wallet's first deposit. It writes no transaction and is idempotent.



## OpenAPI

````yaml post /markets/earn/vaults/acknowledge
openapi: 3.1.0
info:
  title: Loopscale API
  version: 0.1.0
servers:
  - url: https://tars.loopscale.com/v1
    description: Loopscale Production Server
security: []
paths:
  /markets/earn/vaults/acknowledge:
    post:
      tags:
        - earn_data
      summary: Acknowledge Earn Vault
      description: >-
        Records that a wallet accepted a vault's deposit terms. Vaults with
        `requiresAcknowledgment: true` expect this call before a wallet's first
        deposit. It writes no transaction and is idempotent.
      operationId: query_acknowledge_earn_vault
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EarnWalletVaultRequest'
        required: true
      responses:
        '200':
          description: Acknowledgment recorded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarnAcknowledgeResponse'
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    EarnWalletVaultRequest:
      type: object
      required:
        - address
        - wallet
      properties:
        address:
          type: string
        wallet:
          type: string
    EarnAcknowledgeResponse:
      type: object
      description: Response for `POST /earn/vaults/acknowledge`.
      required:
        - acknowledged
      properties:
        acknowledged:
          type: boolean
    ErrorResponse:
      type: object
      description: |-
        Canonical error envelope for every endpoint. The `x-request-id` response
        header carries the correlation id for the failing request.
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetails'
          description: error detail
    ErrorDetails:
      type: object
      description: Inner detail of the [`ErrorResponse`] envelope.
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int32
          description: HTTP status code, mirrored in the response status line
          example: 400
          minimum: 0
        message:
          type: string
          description: human-readable, client-safe message (sensitive data redacted)
          example: Request could not be processed.

````