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

# Simulate a deposit

> This endpoint simulates a deposit to test autoconversion rules end-to-end. Sandbox only — returns 404 in production.



## OpenAPI

````yaml /openapi/api-production.yaml post /autoconversion-rules/simulate-deposit
openapi: 3.1.0
info:
  version: 1.0.0
  title: Lumx API
  description: >-
    A cross-border banking API with instant settlements and unmatched liquidity,
    powered by stablecoins.
servers:
  - url: https://api.lumx.io
  - url: https://api-sandbox.lumx.io
security: []
paths:
  /autoconversion-rules/simulate-deposit:
    post:
      tags:
        - Autoconversion Rules
      summary: Simulate a deposit
      description: >-
        This endpoint simulates a deposit to test autoconversion rules
        end-to-end. Sandbox only — returns 404 in production.
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AutoconversionRuleSimulateDepositRequest'
      responses:
        '201':
          description: Deposit successfully simulated.
          content:
            application/json:
              schema:
                type: object
                properties:
                  matchedRule:
                    type: boolean
                    description: Whether the simulated deposit matched an active rule.
                    example: true
      security:
        - apiKey: []
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      schema:
        type: string
        format: uuid
      description: >-
        Optional UUID v4 idempotency key. If you resend the same key with a
        different request body, the API returns a 409 error. Cached responses
        include the header `X-Idempotency-Cached: true`. Keys expire after 24
        hours.
  schemas:
    AutoconversionRuleSimulateDepositRequest:
      type: object
      properties:
        accountId:
          type: string
          format: uuid
          description: Account that receives the simulated deposit.
          example: 44dd9734-176a-4ced-924f-103f8d50ea5e
        reference:
          type: string
          description: >-
            Deposit reference. Use the rule's sourceDepositInfo
            depositIdentifier (PIX) or reference (SPEI) to match the rule.
          example: IIDCDYjYUTbKouEUOyvxZ3xnU
        amount:
          type: string
          description: Deposit amount as a numeric string.
          example: '100.00'
      required:
        - accountId
        - reference
        - amount
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Bearer authentication header on the format `Bearer <API_KEY>`.

````