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

# Get Child Address Quote



## OpenAPI

````yaml post /v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote
openapi: 3.0.3
info:
  title: Blockradar Documentation
  description: >-
    The OpenAPI specification of the Blockradar API that enables fintechs and
    developers to seamlessly integrate stablecoin deposits and payments into
    their products.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.blockradar.co
security:
  - apiKey: []
tags:
  - name: Rewards
    description: >-
      Non-custodial yield (Earn) on stablecoins via regulated (Fija) and DeFi
      (Aave) strategies. Deposit, withdraw, preview fees, and read positions and
      earnings at the business, wallet, and sub-address level. Amounts are
      returned net of the platform fee, which applies only to interest earned.
  - name: Wallet
    description: >-
      Wallet Management System


      Comprehensive wallet management API for multi-blockchain operations. This
      system handles wallet creation, configuration, balance monitoring, and
      integration with various blockchain networks.


      Core Functionality:


      - Multi-blockchain wallet creation and management

      - Balance monitoring and asset tracking

      - Auto-settlement rule configuration

      - Gateway wallet integration

      - Address generation and management

      - Transaction monitoring and processing
  - name: Addresses
    description: >-
      Address Management System


      Comprehensive blockchain address management API for operations. This
      system handles address creation, validation, monitoring, and management
      across multiple blockchain networks.


      Core Functionality:


      - Multi-blockchain address generation

      - Address validation and verification

      - Balance monitoring and tracking

      - Transaction history management

      - Address labeling and organization

      - Integration with wallet systems

      - Real-time address monitoring
  - name: Asset
  - name: Transactions
  - name: Withdraw
    description: >-
      The Withdraw feature allows you to programmatically withdraw stablecoins
      from your master wallet with ease
  - name: Withdraw Fiat
  - name: Signing
    description: >-
      Typed data signing service for secure transaction authorization. Supports
      all EIP-712 standards including EIP-3009 (TransferWithAuthorization) and
      EIP-2612 (Permit).
  - name: Swap
    description: >-
      The Swap feature enables users to exchange one stabelcoin asset for
      another across different blockchains. This feature provides a seamless way
      to convert between different stablecoins while maintaining security and
      compliance standards.
  - name: Liquidity Pool
  - name: Virtual Accounts
    description: >-
      Virtual Accounts API provides endpoints for managing virtual bank accounts
      linked to master wallets or child addresses. This API enables businesses
      to:


      - Create virtual accounts for customers to receive payments

      - Retrieve virtual account details

      - Activate/deactivate virtual accounts


      **Virtual Account Types:**


      Virtual accounts support different types with varying behaviors:


      1. **AUTO_FUNDING** (Default):

          - Automatically mints stablecoin when fiat payments are received

          - Transfers the stablecoin to the linked wallet/address immediately

          - Best for real-time payment processing


      **How It Works - Auto-Funding Flow (AUTO_FUNDING type only):**


      When a customer sends fiat currency to a virtual account with type
      AUTO_FUNDING:


      1. **Payment Receipt**: The payment is received in the virtual account

      2. **Automatic Minting**: The system automatically mints the stablecoin
      equivalent

      3. **Blockchain Transfer**: The minted stablecoin is transferred to the
      virtual account's linked wallet or address


      **Note**: The auto-funding flow only applies to virtual accounts with type
      `AUTO_FUNDING`.

      Other types have different processing behaviors.


      ## Prerequisites


      Before creating virtual accounts, ensure:


      - **Compliance requirements must be completed** (see [Compliance
      Requirements](http://localhost:3000/essentials/virtual-accounts#compliance-requirements)
      section below)

      - **Virtual accounts feature must be enabled** for your business (reach
      out to [support@blockradar.co](https://mailto:support@blockradar.co) or
      use live chat on the dashboard to enable the feature after compliance
      approval)

      - **Only available on MAINNET environment** (not available on testnet)

      - **Master Wallet must support stablecoin asset** - Your account plan must
      include stablecoin access (upgrade from Dashboard → Settings →
      Subscription if needed)


      **Supported Currency:**


      - Fiat: NGN (Nigerian Naira)

      - Stablecoin: cNGN - minted automatically on blockchain (for AUTO_FUNDING
      type)
  - name: Auto Settlements
    description: >-
      Creates a new auto settlement rule for a wallet. Auto settlement
      automatically transfers/swap assets based on configured rules when certain
      conditions are met.


      Rules can be configured for:


      - Source blockchain and assets

      - Destination blockchain and asset

      - Amount ranges (min/max)

      - Slippage tolerance

      - Gateway vs non-gateway wallets


      Gateway rules are required for testnet wallets and must have matching
      source/destination assets.
  - name: Smart Contract
    description: >-
      This API provides endpoints for interacting with smart contracts on the
      blockchain. It allows for reading contract data, executing contract
      functions, and estimating network fees.
  - name: Gateway
    description: >-
      The Gateway feature enables you to programmatically deposit USDC into a
      unified, chain-abstracted balance and instantly mint USDC on any supported
      blockchain, streamlining crosschain transfers and eliminating manual
      bridging steps and rebalancing complexities.
  - name: Payment Links
    description: >-
      The Payment Pages API provides a quick and secure way to collect payment
      for servcies.
  - name: Beneficiaries
    description: >-
      This API allows you to create beneficiaries with automatic settlements to
      your external wallets on a periodic basis.


      Example frequencies: INSTANT, DAILY, WEEKLY, MONTHLY, YEARLY
  - name: AML
    description: >-
      The AML (Anti Money Laundering) API provides a quick way for you to check
      if an address is blacklisted or sanctioned
  - name: Asset Recovery
    description: >-
      Enables the recovery (salvage) of both native blockchain assets and tokens
      from a specified sender address to a recipient address. This feature
      supports emergency fund recovery and asset consolidation operations.
  - name: Miscellaneous
    description: >-
      The Miscellaneous API are supporting APIs that can be used to provide more
      details to other APIs.
  - name: Asset1
  - name: Blockchain
  - name: Webhooks
    description: >-
      Webhooks allow you to set up a notification system that can be used to
      receive updates on certain requests made to the Blockradar API.

      To see full list and instructions
      [https://docs.blockradar.co/essentials/webhooks](https://docs.blockradar.co/essentials/webhooks)


      ##
  - name: Deposit
  - name: Withdraw1
  - name: Swap1
  - name: Gateway1
paths:
  /v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote:
    post:
      tags:
        - Deposit Fiat
      summary: Child Address Get Quote
      operationId: AddressController_getDepositFiatQuote
      parameters:
        - name: walletId
          required: true
          in: path
          schema:
            type: string
            format: uuid
          description: Wallet identifier.
          example: 4465468a-3c36-4536-918a-91d689e18a74
        - name: addressId
          required: true
          in: path
          schema:
            type: string
            format: uuid
          description: Child address identifier.
          example: a2746f77-56b1-4b34-b0f3-53ad99bf53e2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetDepositFiatQuoteDto'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DepositFiatQuoteResponse'
              example:
                statusCode: 200
                message: Fiat deposit quote retrieved
                data:
                  amount: '100.00'
                  amountFiat: '155000.00'
                  feeFiat: '1500.00'
                  amountFiatPayable: '156500.00'
                  rate: '1550.00'
                  unlocked: true
                  additionalDataRequirements:
                    schema:
                      $schema: http://json-schema.org/draft-07/schema#
                      type: object
                      title: Bank account details
                      properties:
                        institutionIdentifier:
                          type: string
                          title: Institution
                        accountIdentifier:
                          type: string
                          title: Account identifier
                        accountName:
                          type: string
                          title: Account name
                          readOnly: true
                          x-field-kind: resolved
                          x-resolution:
                            method: POST
                            url: >-
                              /v1/wallets/4465468a-3c36-4536-918a-91d689e18a74/deposit/fiat/payment-order-requirements/resolve
                            body:
                              provider: example-provider
                              assetId: ae455f23-3824-4125-baab-d158315cbcbd
                              currency: NGN
                              amount: '100.00'
                              rail: one_time_virtual_account
                            inputPath: additionalData
                            dependsOn:
                              - institutionIdentifier
                              - accountIdentifier
                            responsePath: data.accountName
                      required:
                        - institutionIdentifier
                        - accountIdentifier
                      additionalProperties: false
components:
  schemas:
    GetDepositFiatQuoteDto:
      type: object
      properties:
        assetId:
          type: string
          format: uuid
          description: >-
            Stablecoin asset identifier returned by the supported-assets
            endpoint.
          example: ae455f23-3824-4125-baab-d158315cbcbd
        currency:
          type: string
          minLength: 3
          maxLength: 3
          description: ISO 4217 fiat currency code.
          example: NGN
        amount:
          type: string
          pattern: ^\d+(\.\d+)?$
          description: Decimal amount encoded as a string to preserve precision.
          example: '100.00'
        rail:
          $ref: '#/components/schemas/CurrencyConversionRouteRailEnum'
          description: Payment collection rail.
          example: one_time_virtual_account
        provider:
          type: string
          description: >-
            Optional provider slug. Omit it to let Blockradar select an eligible
            provider.
          example: example-provider
      required:
        - assetId
        - currency
        - amount
        - rail
    DepositFiatQuoteResponse:
      type: object
      properties:
        statusCode:
          type: integer
          example: 200
        message:
          type: string
          description: Human-readable result.
          example: Deposit quote fetched successfully
        data:
          $ref: '#/components/schemas/DepositFiatQuote'
      required:
        - statusCode
        - message
        - data
    CurrencyConversionRouteRailEnum:
      type: string
      enum:
        - one_time_virtual_account
        - payment_link
        - qr_code
      description: Supported fiat collection rail.
    DepositFiatQuote:
      type: object
      properties:
        amount:
          type: string
          description: Stablecoin amount to settle.
          example: '100.00'
        amountFiat:
          type: string
          description: Fiat equivalent before fees.
          example: '155000.00'
        feeFiat:
          type: string
          description: Fee charged in fiat.
          example: '1500.00'
        amountFiatPayable:
          type: string
          description: Total fiat amount the customer must pay.
          example: '156500.00'
        rate:
          type: string
          description: Fiat per unit of the target asset.
          example: '1550.00'
        unlocked:
          type: boolean
          description: >-
            Whether the resolved provider is already enabled and configured for
            this business.
          example: true
        additionalDataRequirements:
          type: object
          properties:
            schema:
              $ref: '#/components/schemas/Draft07Schema'
              nullable: true
          required:
            - schema
      required:
        - amount
        - amountFiat
        - feeFiat
        - amountFiatPayable
        - rate
        - unlocked
        - additionalDataRequirements
    Draft07Schema:
      type: object
      description: >-
        A JSON Schema Draft 07 document. Render and validate this schema before
        submitting additionalData or paymentMethodData.
      additionalProperties: true
      properties:
        $schema:
          type: string
          description: JSON Schema dialect URI.
          example: http://json-schema.org/draft-07/schema#
        type:
          type: string
          description: Root JSON type.
          example: object
        properties:
          type: object
          additionalProperties: true
        required:
          type: array
          items:
            type: string
      required:
        - $schema
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````