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

# Get AutoBoy wallet

> Returns the AutoBoy smart wallet address associated with the API key, along with the ERC-20 tokens and native ETH it holds on Base.



## OpenAPI

````yaml https://thefirm.biz/api/public/v1/openapi.json get /api/public/v1/wallet
openapi: 3.1.0
info:
  title: AutoBoy Public API
  version: 0.1.0
  description: >-
    REST API for AutoBoy — browse projects, view detailed stats about your own
    launch, create buy orders and manage your AutoBoy smart wallet.


    ## Authentication


    Most endpoints require an API key, sent as a bearer token:


    ```

    Authorization: Bearer autoboy_…

    ```


    ## Quick start


    1. **Request a key** — `POST /api/public/v1/api-key-requests`

    2. **Register a project** — `POST /api/public/v1/projects`.


    New to AutoBoy? Read the product docs https://docs.thefirm.biz.
servers:
  - url: https://thefirm.biz
security: []
tags:
  - name: API Keys
    description: Request, create, and inspect API keys.
  - name: Projects
    description: Browse projects and their buyers.
  - name: Buy Orders
    description: Read and manage the API key owner's pre-launch buy orders.
  - name: AutoBoy Wallet
    description: Balances of, and withdrawals from, the AutoBoy smart wallet.
  - name: Feedback
    description: Send feedback to The Firm.
paths:
  /api/public/v1/wallet:
    get:
      tags:
        - AutoBoy Wallet
      summary: Get AutoBoy wallet
      description: >-
        Returns the AutoBoy smart wallet address associated with the API key,
        along with the ERC-20 tokens and native ETH it holds on Base.
      operationId: getWallet
      responses:
        '200':
          description: The AutoBoy wallet balances.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BalanceResponse'
              example:
                autoboyWalletAddress: '0x1234567890123456789012345678901234567890'
                balances:
                  - address: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'
                    symbol: ETH
                    name: Ether
                    decimals: 18
                    balance: '1500000000000000000'
                  - address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
                    symbol: USDC
                    name: USD Coin
                    decimals: 6
                    balance: '2500000'
        '401':
          description: Missing, invalid, or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                missingAuthorizationHeader:
                  value:
                    error: Unauthorized
                    message: Missing or invalid Authorization header
                invalidApiKey:
                  value:
                    error: Unauthorized
                    message: Invalid API key
        '404':
          description: The API key owner has no AutoBoy wallet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Not found
                message: API key owner has no autoboy wallet
        '500':
          description: Failed to read the balance.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal server error
                message: Failed to read balance
        '502':
          description: The balance provider (Alchemy / RPC) is unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad gateway
                message: Failed to fetch wallet balances
      security:
        - apiKeyAuth: []
components:
  schemas:
    BalanceResponse:
      type: object
      properties:
        autoboyWalletAddress:
          type: string
          example: '0x1234567890123456789012345678901234567890'
        balances:
          type: array
          items:
            type: object
            properties:
              address:
                type: string
                description: >-
                  Token contract address. Native ETH uses the
                  0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE sentinel address.
                example: '0x1234567890123456789012345678901234567890'
              symbol:
                type: string
                example: USDC
              name:
                type: string
                example: USD Coin
              decimals:
                type: integer
                example: 6
              balance:
                type: string
                description: >-
                  Balance in atomic units (smallest denomination), base-10
                  string.
                example: '2500000'
            required:
              - address
              - symbol
              - name
              - decimals
              - balance
          description: >-
            ERC-20 tokens and native ETH held by the autoboy smart wallet on
            Base. Native ETH, when held, is the first entry; an empty wallet
            returns an empty array.
      required:
        - autoboyWalletAddress
        - balances
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
      required:
        - error
        - message
      example:
        error: Bad request
        message: Invalid request body
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: API key issued via POST /api/public/v1/api-keys.

````