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

# Launchpads List with Metrics

> Paginated list of launchpads with performance metrics over the last year: `rank`, `salesCount`, `avgRoi` (average all-time-high ROI across sales as a multiplier) and `totalRaised`. Optionally filter by launchpad `type` (`IDO` / `IEO` / `ICO`). Sortable by `rank` (default), `salesCount`, `roi`; direction via `sortOrder` (`asc` / `desc`, default `asc`).<br/><br/>Available from&#58; <Badge color="green">Advanced</Badge><br/>Cost&#58; <Badge color="surface">1 credit per request</Badge>



## OpenAPI

````yaml https://api.cryptorank.io/v3/documentation-json get /v3/launchpads/list
openapi: 3.0.0
info:
  title: Cryptorank API V3
  description: >
    # Overview


    Cryptorank Public API v3 — comprehensive cryptocurrency data for B2B clients
    and partners.


    Useful Links:

    - [API Plans](https://cryptorank.io/public-api)

    - [Dashboard](https://cryptorank.io/public-api/dashboard)


    # Getting Started


    Primary Server URL:
    [https://api.cryptorank.io/v3/](https://api.cryptorank.io/v3/)


    **Authentication**


    Generate an API key in the
    [dashboard](https://cryptorank.io/public-api/dashboard) and pass it in the
    `X-Api-Key` header.


    Keep your keys secret — never commit them to public repositories or expose
    them in client-side code.
  version: 3.0.0
  contact:
    name: Cryptorank Team
    url: https://cryptorank.io
    email: info@cryptorank.io
servers:
  - url: https://api.cryptorank.io
security: []
tags: []
paths:
  /v3/launchpads/list:
    get:
      tags:
        - Launchpads
      summary: Launchpads List with Metrics
      description: >-
        **Description**


        Paginated list of launchpads with performance metrics over the last
        year: `rank`, `salesCount`, `avgRoi` (average all-time-high ROI across
        sales as a multiplier) and `totalRaised`. Optionally filter by launchpad
        `type` (`IDO` / `IEO` / `ICO`). Sortable by `rank` (default),
        `salesCount`, `roi`; direction via `sortOrder` (`asc` / `desc`, default
        `asc`).


        **Access**

        - Available from: **Advanced**

        - Cost: 1 credit per request
      operationId: LaunchpadsController_getList
      parameters:
        - name: page
          required: false
          in: query
          description: Page number (1-based). Returns up to 100 items per page.
          schema:
            minimum: 1
            maximum: 1000
            default: 1
            type: number
        - name: sortBy
          required: false
          in: query
          description: Sort field.
          schema:
            default: rank
            type: string
            enum:
              - id
              - rank
              - salesCount
              - roi
        - name: sortOrder
          required: false
          in: query
          description: Sort direction.
          schema:
            default: asc
            type: string
            enum:
              - asc
              - desc
        - name: type
          required: false
          in: query
          description: Filter by launchpad type.
          schema:
            type: string
            enum:
              - IDO
              - IEO
              - ICO
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                  - status
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/LaunchpadListItemDto'
                  meta:
                    $ref: '#/components/schemas/ListMetaDto'
                  status:
                    $ref: '#/components/schemas/ResponseStatusDto'
        '400':
          description: Request validation failed
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - VALIDATION_ERROR
                        example: VALIDATION_ERROR
                      message:
                        type: string
                        example: Validation failed
                      status:
                        type: number
                        example: 400
        '401':
          description: API key is missing or invalid
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - API_KEY_MISSING
                          - API_KEY_INVALID
                        example: API_KEY_MISSING
                      message:
                        type: string
                        example: API key is missing
                      status:
                        type: number
                        example: 401
        '403':
          description: >-
            No active subscription, the endpoint is not available in your plan,
            or the request goes beyond what your plan allows
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - NO_ACTIVE_SUBSCRIPTION
                          - ENDPOINT_NOT_AVAILABLE
                          - PLAN_LIMIT_EXCEEDED
                        example: NO_ACTIVE_SUBSCRIPTION
                      message:
                        type: string
                        example: No active subscription found
                      status:
                        type: number
                        example: 403
        '429':
          description: Rate limit or credit limit exceeded
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - RATE_LIMIT_EXCEEDED
                          - DAILY_CREDITS_EXCEEDED
                          - MONTHLY_CREDITS_EXCEEDED
                        example: RATE_LIMIT_EXCEEDED
                      message:
                        type: string
                        example: Rate limit exceeded
                      status:
                        type: number
                        example: 429
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - INTERNAL_ERROR
                        example: INTERNAL_ERROR
                      message:
                        type: string
                        example: Internal server error
                      status:
                        type: number
                        example: 500
      security:
        - X-Api-Key: []
components:
  schemas:
    LaunchpadListItemDto:
      type: object
      properties:
        id:
          type: number
          example: 1
          description: Unique numeric identifier.
        slug:
          type: string
          example: binance-launchpad
          description: URL-friendly entity slug.
        name:
          type: string
          example: Binance Launchpad
          description: Display name.
        type:
          type: string
          enum:
            - IDO
            - IEO
            - ICO
          example: IDO
          description: Launchpad type.
        imageUrl:
          type: string
          nullable: true
          example: https://images.cryptorank.io/ido-platforms/150x150.binance.png
          description: Logo image URL (150×150). Null when no image is available.
        rank:
          type: number
          nullable: true
          example: 12
          description: Launchpad rank over the last year. Null when not ranked.
        salesCount:
          type: number
          example: 42
          description: Number of token sales hosted over the last year.
        avgRoi:
          type: number
          nullable: true
          example: 7.32
          description: >-
            Average all-time-high ROI across sales over the last year, as a
            multiplier (ATH price / sale price). Null when not computable.
        totalRaised:
          type: string
          nullable: true
          example: '12500000'
          description: >-
            Total raised across all sales over the last year, USD. Null when
            none.
      required:
        - id
        - slug
        - name
        - type
        - imageUrl
        - rank
        - salesCount
        - avgRoi
        - totalRaised
    ListMetaDto:
      type: object
      properties:
        page:
          type: number
          example: 1
          description: Current page number (1-based)
        pageSize:
          type: number
          example: 25
          description: >-
            Fixed number of items per page for this endpoint (varies per
            endpoint)
        hasNextPage:
          type: boolean
          example: true
          description: Whether a further page of results exists
      required:
        - page
        - pageSize
        - hasNextPage
    ResponseStatusDto:
      type: object
      properties:
        usedCredits:
          type: number
          example: 1
          description: Credits charged for this request
        timestamp:
          type: number
          example: 1780000000000
          description: Server time of the response. Unix timestamp in milliseconds
      required:
        - usedCredits
        - timestamp
  securitySchemes:
    X-Api-Key:
      name: X-Api-Key
      type: apiKey
      in: header

````