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

# Whitelist an existing deposit address

> Whitelist an existing blockchain address (EVM or Solana) as a deposit address.
This allows you to add pre-existing addresses to your wallet infrastructure.




## OpenAPI

````yaml /api-reference/openapi.json post /v1/addresses/whitelist
openapi: 3.0.3
info:
  title: XentFi API
  version: 1.0.0
  description: >-
    API documentation for XentFi.The XentFi API gives you access to pretty much
    all the features you can use on our dashboard and lets you extend them for
    use in your application. It strives to be RESTful and is organized around
    the main resources you would be interacting with - with a few notable
    exceptions.
servers:
  - url: https://api.xentfi.com
    description: Development server
security: []
tags: []
paths:
  /v1/addresses/whitelist:
    post:
      tags:
        - Addresses
      summary: Whitelist an existing deposit address
      description: >
        Whitelist an existing blockchain address (EVM or Solana) as a deposit
        address.

        This allows you to add pre-existing addresses to your wallet
        infrastructure.
      operationId: whitelistDepositAddress
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - masterId
                - walletAddress
              properties:
                masterId:
                  type: string
                  description: ID of the master wallet to associate the address with
                  example: 550e8400-e29b-41d4-a716-446655440000
                walletAddress:
                  type: string
                  description: >-
                    Existing blockchain wallet address to whitelist (EVM format
                    or Solana)
                  example: '0x742d35Cc6634C0532925a3b844Bc9e7595f0b5b5'
                privatekey:
                  type: string
                  description: Optional private key for the wallet (EVM or Solana format)
                  example: >-
                    0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890
                name:
                  type: string
                  description: Optional custom name for the deposit address
                  example: My Whitelisted Wallet
                disableAutoSweep:
                  type: boolean
                  description: Disable automatic sweeping of funds to master wallet
                  default: false
                  example: false
                enableGaslessWithdraw:
                  type: boolean
                  description: Enable gasless withdrawals for this address
                  default: false
                  example: false
                enableMonitoring:
                  type: boolean
                  description: Enable blockchain monitoring for this address
                  default: false
                  example: true
                metadata:
                  type: object
                  description: Additional metadata for the address
                  additionalProperties: true
                  example:
                    source: external_wallet
                    tags:
                      - customer
                      - whitelisted
      responses:
        '201':
          description: Deposit address whitelisted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      description:
                        type: string
                      walletAddress:
                        type: string
                      network:
                        type: string
                      blockchain:
                        type: object
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: Blockchain unique identifier
                            example: 8a864e95-4b86-423d-9ba4-f4e692ec121e
                          name:
                            type: string
                            description: Blockchain name
                            example: Base
                          slug:
                            type: string
                            description: Blockchain slug
                            example: base-mainnet
                          symbol:
                            type: string
                            description: Blockchain symbol
                            example: ETH
                          isActive:
                            type: boolean
                            description: Whether the blockchain is active
                            example: true
                          isEvmCompatible:
                            type: boolean
                            description: Whether the blockchain is EVM compatible
                            example: true
                          configurations:
                            type: object
                            nullable: true
                            description: Additional configuration data
                            example: null
                          chainId:
                            type: integer
                            description: Chain ID for EVM chains
                            example: 8453
                          logoUrl:
                            type: string
                            description: URL to blockchain logo
                            example: https://example.com/base-logo.png
                          tokenStandard:
                            type: string
                            description: Token standard
                            example: ERC20
                          createdAt:
                            type: string
                            format: date-time
                            description: Creation timestamp
                            example: '2023-04-28T14:44:06.397Z'
                          updatedAt:
                            type: string
                            format: date-time
                            description: Last update timestamp
                            example: '2024-11-26T15:26:18.785Z'
                      masterWalletId:
                        type: string
                      metadata:
                        type: object
                      isActive:
                        type: boolean
                      configurations:
                        type: object
                        properties:
                          aml:
                            type: object
                            properties:
                              message:
                                type: string
                              provider:
                                type: string
                              status:
                                type: string
                          disableAutoSweep:
                            type: boolean
                          enableGaslessWithdraw:
                            type: boolean
                          enableMultiChain:
                            type: boolean
                          settlement:
                            type: object
                            properties:
                              autoSettlementEnabled:
                                type: boolean
                              settlementDelay:
                                type: integer
                              minBalanceForSettlement:
                                type: string
                          security:
                            type: object
                            properties:
                              requireSignatureForWithdrawals:
                                type: boolean
                              maxWithdrawalAmount:
                                type: string
                              allowedDestinations:
                                type: array
                                items:
                                  type: string
                          notifications:
                            type: object
                            properties:
                              onDeposit:
                                type: boolean
                              onWithdrawal:
                                type: boolean
                              onThresholdReached:
                                type: string
                      enabledBlockchains:
                        type: array
                        description: >-
                          List of blockchains enabled for monitoring on this
                          address
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: Blockchain unique identifier
                              example: 8a864e95-4b86-423d-9ba4-f4e692ec121e
                            name:
                              type: string
                              description: Blockchain name
                              example: Base
                            slug:
                              type: string
                              description: Blockchain slug
                              example: base-mainnet
                            symbol:
                              type: string
                              description: Blockchain symbol
                              example: ETH
                            isActive:
                              type: boolean
                              description: Whether the blockchain is active
                              example: true
                            isEvmCompatible:
                              type: boolean
                              description: Whether the blockchain is EVM compatible
                              example: true
                            configurations:
                              type: object
                              nullable: true
                              description: Additional configuration data
                              example: null
                            chainId:
                              type: integer
                              description: Chain ID for EVM chains
                              example: 8453
                            logoUrl:
                              type: string
                              description: URL to blockchain logo
                              example: https://example.com/base-logo.png
                            tokenStandard:
                              type: string
                              description: Token standard
                              example: ERC20
                            createdAt:
                              type: string
                              format: date-time
                              description: Creation timestamp
                              example: '2023-04-28T14:44:06.397Z'
                            updatedAt:
                              type: string
                              format: date-time
                              description: Last update timestamp
                              example: '2024-11-26T15:26:18.785Z'
                      createdAt:
                        type: string
                        format: date-time
                      updatedAt:
                        type: string
                        format: date-time
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: NOT_FOUND
                      message:
                        type: string
                        example: Wallet not found
                      timestamp:
                        type: string
                        format: date-time
                      requestId:
                        type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: NOT_FOUND
                      message:
                        type: string
                        example: Wallet not found
                      timestamp:
                        type: string
                        format: date-time
                      requestId:
                        type: string
        '403':
          description: Forbidden - Insufficient permissions
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: NOT_FOUND
                      message:
                        type: string
                        example: Wallet not found
                      timestamp:
                        type: string
                        format: date-time
                      requestId:
                        type: string
        '404':
          description: Master wallet not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: NOT_FOUND
                      message:
                        type: string
                        example: Wallet not found
                      timestamp:
                        type: string
                        format: date-time
                      requestId:
                        type: string
        '409':
          description: Conflict - Address already whitelisted
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: NOT_FOUND
                      message:
                        type: string
                        example: Wallet not found
                      timestamp:
                        type: string
                        format: date-time
                      requestId:
                        type: string
      security:
        - ApiKeyAuth: []
          OrgIdAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apiKey
    OrgIdAuth:
      type: apiKey
      in: header
      name: orgId

````