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

# Create a new wallet



## OpenAPI

````yaml /openapi.json post /wallets
openapi: 3.0.3
info:
  description: API documentation for Crypto service
  title: Crypto API
  version: 1.0.0
servers:
  - description: Development
    url: https://tag.alfa-bot.com/api/prod/v1
security:
  - apiKeyAuth: []
tags:
  - description: Methods for working with wallets
    name: Wallets
  - description: Methods related to users
    name: User
  - description: Methods for AML verification
    name: AML
  - description: Test methods
    name: Test
  - description: Methods for withdrawal funds
    name: Withdrawal
  - description: Methods for working with transactions
    name: Transactions
  - description: Methods for working with exchange transactions
    name: Exchange
paths:
  /wallets:
    post:
      tags:
        - Wallets
      summary: Create a new wallet
      operationId: postWallets
      requestBody:
        content:
          application/json:
            schema:
              properties:
                name:
                  type: string
                  example: Main TRX wallet
                  description: New wallet name
                network:
                  type: string
                  enum:
                    - trx
                    - eth
                    - bnb
                    - sol
                  example: trx
                type:
                  type: string
                  enum:
                    - user
                    - accounting
                  example: user
              required:
                - name
                - network
                - type
              type: object
        required: true
      responses:
        '200':
          description: OK - wallet was created successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - error_code
                  - error_message
                  - data
                properties:
                  code:
                    type: string
                    description: Response code.
                    example: '200'
                  error_code:
                    type: string
                    nullable: true
                    description: >-
                      Application-level error code. Null for successful
                      responses.
                    example: null
                  error_message:
                    type: string
                    nullable: true
                    description: >-
                      Human-readable error message. Null for successful
                      responses.
                    example: null
                  data:
                    $ref: '#/components/schemas/CreateWalletResponse'
              examples:
                walletCreated:
                  summary: Wallet created successfully
                  value:
                    code: '200'
                    error_code: null
                    error_message: null
                    data:
                      user_id: '1234'
                      qr: https://...
                      address: '0x11232323232323'
                      network_name: ERC20
                      network: ETH
                      name: Wallet name
        '400':
          description: >-
            Bad Request - API key does not have permission to perform this
            action
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - error_code
                  - error_message
                  - data
                properties:
                  code:
                    type: string
                    description: Response code.
                    example: '400'
                  error_code:
                    type: string
                    nullable: true
                    description: >-
                      Application-level error code. Null for successful
                      responses.
                    example: request
                  error_message:
                    type: string
                    nullable: true
                    description: >-
                      Human-readable error message. Null for successful
                      responses.
                    example: Validation failed
                  data:
                    type: object
                    nullable: true
                    description: Additional error details when available.
                    additionalProperties: true
              examples:
                apiKeyNoPermission:
                  summary: API key has no permission
                  value:
                    code: '400'
                    error_code: system
                    error_message: >-
                      Your api_key does not have permission to perform this
                      action
                    data: null
        '404':
          description: Not Found - wallet creation cannot be completed
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - error_code
                  - error_message
                  - data
                properties:
                  code:
                    type: string
                    description: Response code.
                    example: '404'
                  error_code:
                    type: string
                    nullable: true
                    description: >-
                      Application-level error code. Null for successful
                      responses.
                    example: request
                  error_message:
                    type: string
                    nullable: true
                    description: >-
                      Human-readable error message. Null for successful
                      responses.
                    example: Validation failed
                  data:
                    type: object
                    nullable: true
                    description: Additional error details when available.
                    additionalProperties: true
              examples:
                walletLimitReached:
                  summary: Wallet limit reached for this network
                  value:
                    code: '404'
                    error_code: system
                    error_message: You have reached the wallet limit for this network.
                    data: null
                walletTypeCannotBeVerified:
                  summary: Wallet type cannot be verified
                  value:
                    code: '404'
                    error_code: system
                    error_message: >-
                      It is not possible to verify the type of wallet. Please
                      contact support.
                    data: null
                walletTypeNotSupported:
                  summary: Wallet type is not supported by the network
                  value:
                    code: '404'
                    error_code: system
                    error_message: >-
                      This type ({{type}}) of wallet is not supported by the
                      network {{network}}.
                    data: null
        '500':
          description: >-
            Internal Server Error - wallet creation failed because of a system
            error
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - error_code
                  - error_message
                  - data
                properties:
                  code:
                    type: string
                    description: Response code.
                    example: '500'
                  error_code:
                    type: string
                    nullable: true
                    description: >-
                      Application-level error code. Null for successful
                      responses.
                    example: system
                  error_message:
                    type: string
                    nullable: true
                    description: >-
                      Human-readable error message. Null for successful
                      responses.
                    example: Validation failed
                  data:
                    type: object
                    nullable: true
                    description: Additional error details when available.
                    additionalProperties: true
              examples:
                systemError:
                  summary: System error
                  value:
                    code: '500'
                    error_code: system
                    error_message: System error
                    data: null
                walletTypeVerificationError:
                  summary: Wallet type verification error
                  value:
                    code: '500'
                    error_code: system
                    error_message: >-
                      It is not possible to verify the type of wallet. Please
                      contact support.
                    data: null
                creatingWalletError:
                  summary: Creating wallet error
                  value:
                    code: '500'
                    error_code: system
                    error_message: Creating wallet error
                    data: null
                addingWalletToNetworkError:
                  summary: Adding wallet to network error
                  value:
                    code: '500'
                    error_code: system
                    error_message: Adding wallet to network error
                    data: null
                updateWalletTypeError:
                  summary: Update wallet type error
                  value:
                    code: '500'
                    error_code: system
                    error_message: Update wallet type error
                    data: null
components:
  schemas:
    CreateWalletResponse:
      type: object
      required:
        - code
        - data
      properties:
        code:
          type: string
          example: '200'
        data:
          type: object
          required:
            - user_id
            - qr
            - address
            - network_name
            - network
            - name
          properties:
            user_id:
              type: string
              example: '1234'
            qr:
              type: string
              example: https://...
            address:
              type: string
              example: '0x11232323232323'
            network_name:
              type: string
              example: ERC20
            network:
              type: string
              example: ETH
            name:
              type: string
              example: Wallet name
  securitySchemes:
    apiKeyAuth:
      in: header
      name: token
      type: apiKey
      description: Pass your API token in the `token` request header.

````