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

# Create Wallet

> Creates a new wallet with the specified name and default assets (BRLV and wBRLY if applicable).



## OpenAPI

````yaml POST /api/v0/wallets
openapi: 3.1.0
info:
  title: Crown API & Webhooks
  version: 1.0.0
  description: >-
    Open API 3 docs for Crown API


    Webhook events that Crown will POST to your configured endpoint URL. All
    webhooks expect a 200 OK response. Payloads use kebab-case for all keys to
    match the Crown API conventions.
servers:
  - url: https://app.crown-brlv.com
    description: Production server
security: []
paths:
  /api/v0/wallets:
    post:
      summary: Create a new wallet
      description: >-
        Creates a new wallet with the specified name and default assets (BRLV
        and wBRLY if applicable).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                wallet-name:
                  type: string
                  description: Name for the new wallet
                  example: My Trading Wallet
                chain:
                  type: string
                  enum:
                    - tempo
                    - eth-mainnet
                    - eth-base
                  description: Blockchain that this wallet will be supported on
                  example: eth-base
                metadata:
                  oneOf:
                    - type: object
                      additionalProperties: {}
                    - type: 'null'
                  description: Custom metadata to associate with the wallet
                  example:
                    label: treasury
                ui-enabled:
                  type: boolean
                  description: >-
                    Whether this wallet should be visible in the UI (defaults to
                    false)
                  example: false
              additionalProperties: false
              required:
                - wallet-name
                - chain
      responses:
        '200':
          description: Wallet created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  wallet:
                    type: object
                    properties:
                      address:
                        type: string
                        description: Ethereum wallet address
                        example: '0x1234567890abcdef1234567890abcdef12345678'
                      assets:
                        type: array
                        items:
                          type: string
                          enum:
                            - tempo/brlv
                            - eth-base/brlv
                            - eth-mainnet/brlv
                            - fiat/brl
                            - eth-base/usdt
                            - fiat/usd
                            - eth-mainnet/usdt
                            - eth-mainnet/usdc
                            - eth-base/wbrly
                            - eth-base/usdc
                            - eth-base/brly
                        description: List of supported assets for this wallet
                        example:
                          - eth-base/brlv
                          - eth-base/wbrly
                    additionalProperties: false
                    required:
                      - address
                      - assets
                additionalProperties: false
                required:
                  - wallet
        '400':
          description: Bad request - Invalid input parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Bad request error details
                additionalProperties: false
                required:
                  - error
        '403':
          description: Forbidden - Access denied
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Forbidden access error details
                additionalProperties: false
                required:
                  - error
        '404':
          description: Not found - Resource does not exist
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Resource not found error details
                additionalProperties: false
                required:
                  - error
        '422':
          description: Unprocessable entity - Validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Validation error details
                additionalProperties: false
                required:
                  - error

````