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

# Simulate Deposit

> Simulate a crypto or fiat deposit into the system for the sandbox environment. This allows testing deposit flows without real blockchain transactions or actual bank transfers. Supports stablecoins (USDT, USDC, RLUSD) on various networks, and USD fiat deposits.



## OpenAPI

````yaml https://api.conduit.financial/api-docs/2024-12-01/openapi-external.yaml?mode=dynamic post /simulator/deposit
openapi: 3.0.2
info:
  version: '2024-12-01'
  title: Conduit API
  description: The Conduit Financial API
  contact:
    name: Conduit Support
    email: conduit@conduit.fi
servers:
  - url: https://api.conduit.financial
    description: The Conduit API live environment
  - url: https://api.sandbox.conduit.financial
    description: The Conduit API Sandbox environment
security: []
tags:
  - name: Accounts
    description: |
      Endpoints dealing with accounts.
  - name: Counterparties
    description: |
      Endpoints dealing with counterparties information. 
  - name: Quotes
    description: |
      Endpoints dealing with quotes.
  - name: Transactions
    description: |
      Endpoints dealing with transactions.
  - name: Documents
    description: |
      Endpoints dealing with documents.
  - name: Customers
    description: |
      Endpoints dealing with customer information. 
paths:
  /simulator/deposit:
    post:
      tags:
        - Simulations
      summary: Simulate Deposit
      description: >-
        Simulate a crypto or fiat deposit into the system for the sandbox
        environment. This allows testing deposit flows without real blockchain
        transactions or actual bank transfers. Supports stablecoins (USDT, USDC,
        RLUSD) on various networks, and USD fiat deposits.
      operationId: createSandboxDirectDeposit
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSandboxDepositRequest'
      responses:
        '201':
          description: The creation status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateDirectDepositTransactionsResponse'
        '400':
          description: Input validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestErrorResponse'
        '401':
          description: Authentication error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestErrorResponse'
        '403':
          description: Authorization error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenErrorResponse'
        '415':
          description: Unsupported media type error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnsupportedMediaTypeErrorResponse'
        '429':
          description: Throttling error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsErrorResponse'
        '500':
          description: Internal Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorResponse'
      security:
        - apiKey: []
          apiSecret: []
components:
  schemas:
    CreateSandboxDepositRequest:
      type: object
      properties:
        asset:
          allOf:
            - $ref: '#/components/schemas/SimulatedDepositsAssetCode'
            - enum:
                - USDT
                - USDC
                - RLUSD
                - USD
              description: A stablecoin token or USD for fiat deposits.
        network:
          $ref: '#/components/schemas/NetworkName'
        amount:
          $ref: '#/components/schemas/PositiveDecimal'
        destination:
          type: string
          description: >-
            Destination for the deposit. Required for fiat deposits (USD).
            Optional for crypto deposits (auto-discovered if omitted). Accepts
            bank account ID (bank_... or id:bank-account:...), account ID
            (acct_... or id:acct:...), or wallet ID (wlt_... or id:wlt:...).
        reference:
          type: string
      required:
        - asset
        - amount
      additionalProperties: false
      title: Sandbox Simulate Deposit
      example:
        asset: USDT
        network: tron
        amount: '1400.00'
        reference: Demo Payment
    CreateDirectDepositTransactionsResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
      required:
        - status
    BadRequestErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              detail:
                type: string
              code:
                type: string
            required:
              - detail
              - code
      required:
        - errors
    ForbiddenErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              detail:
                type: string
              code:
                type: string
            required:
              - detail
              - code
      required:
        - errors
    UnsupportedMediaTypeErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              detail:
                type: string
              code:
                type: string
            required:
              - detail
              - code
      required:
        - errors
    TooManyRequestsErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              detail:
                type: string
              code:
                type: string
            required:
              - detail
              - code
      required:
        - errors
    InternalServerErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              detail:
                type: string
              code:
                type: string
            required:
              - detail
              - code
      required:
        - errors
    SimulatedDepositsAssetCode:
      type: string
      enum:
        - USDT
        - USDC
        - RLUSD
      description: A stablecoin token.
    NetworkName:
      type: string
      enum:
        - ethereum
        - tron
        - solana
        - polygon
        - base
        - xrpl
      description: >-
        The stablecoin asset network identifier. Required for stablecoins;
        omitted for fiat.
    PositiveDecimal:
      type: string
      pattern: ^(0\.[0-9]*[1-9][0-9]*|[1-9][0-9]*(\.[0-9]+)?)$
      description: A positive decimal amount
      example: '10.50'
  securitySchemes:
    apiKey:
      type: apiKey
      description: Includes an API key in the HTTP headers to authenticate the client.
      name: X-API-Key
      in: header
    apiSecret:
      type: apiKey
      description: Includes an API secret in the HTTP headers to authenticate the client.
      name: X-API-Secret
      in: header

````