---
title: "Get tokens for user"
method: GET
path: "/v1/users/{address}/tokens"
tags: ["users"]
---

# Get tokens for user

`GET /v1/users/{address}/tokens`

## Request

- Base URL: `https://lpad-backend.stage.defi.ovh.gala.com`
- URL: `https://lpad-backend.stage.defi.ovh.gala.com/v1/users/{address}/tokens`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gala/apis/launchpad-backend-api/docs/v1/users/:address/tokens/get.ts> (a function with typed inputs; its response is checked against the schema)

List tokens held or created by a user with optional type and status filters

## Path parameters

- `address` string, required

## Query parameters

- `search` string
- `status` 'all' | 'graduated' | 'active'
- `tokenName` string
- `type` 'held' | 'created'

## Response `200`

Tokens retrieved successfully - returns paginated array of holdings/created with balances and metadata

Cursor-paginated raw token holdings or created launch records, depending on type.

- object
  - `error` false, required: Successful response marker.
  - `message` string, required: Response message.
  - `status` number, required: HTTP status code.
  - `data` union, required
    - UserTokenListResponseDto
      - `pageInfo` TokenPageInfoResponseDto, required
        - `endCursor` string, nullable, required
        - `hasNextPage` boolean, required
        - `hasPreviousPage` boolean, required
        - `startCursor` string, nullable, required
      - `token` UserTokenListItemResponseDto[], required
        - `additionalKey` string, nullable
        - `category` string, nullable
        - `collection` string, nullable
        - `createdAt` string, date-time
        - `creatorAddress` string
        - `decimals` string
        - `description` string
        - `holdingPriceGala` union
          - number
          - string
        - `holdingPriceUsd` number
        - `id` number
        - `image` string
        - `isFinalized` boolean
        - `name` string
        - `quantity` string
        - `symbol` string
        - `tokenName` string
        - `totalUsdValue` string
        - `type` string, nullable
        - `updatedAt` string, date-time
        - `vaultAddress` string
        - `verify` boolean
    - ProfileLaunchesResponseDto
      - `launches` ProfileLaunchItemResponseDto[], required
        - `bondingCurvePercentage` number, required
        - `createdAt` string, date-time, required
        - `currentViewerCount` number, required
        - `image` string, required
        - `isFinalized` boolean, required
        - `muxStreamStatus` union, required
          - 'ACTIVE' | 'IDLE' | 'DISABLED'
          - unknown
        - `symbol` string, required
        - `tokenName` string, required
        - `vaultAddress` string, required
        - `volume` number, required
        - `volumeSum` number, required
      - `pageInfo` TokenPageInfoResponseDto, required
        - `endCursor` string, nullable, required
        - `hasNextPage` boolean, required
        - `hasPreviousPage` boolean, required
        - `startCursor` string, nullable, required

## Other responses

- `400`: Bad request - address parameter invalid format, or skip/limit parameters invalid
- `500`: Internal server error - failed to retrieve tokens from blockchain or database
- `default`: Shared error envelope for user token listing failures.

---

[API](https://skmtc.dev/gala/apis/launchpad-backend-api.md) - [All operations](https://skmtc.dev/gala/apis/launchpad-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gala/apis/launchpad-backend-api/revisions/74545971be2b?raw)