> ## 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.

# Public Sales List

> Returns a feed of public sales, with filters.<br/><br/>Available from&#58; <Badge color="orange">Pro</Badge><br/>Cost&#58; <Badge color="surface">1 credit per request</Badge>

> [!TIP]
>
> Sale details are available via [/public-sales/:id](https://docs.cryptorank.io/api-reference/public-sales/public-sale-detail.md).


## OpenAPI

````yaml /openapi.json get /v3/public-sales/list
openapi: 3.0.0
info:
  contact:
    email: info@cryptorank.io
    name: Cryptorank Team
    url: https://cryptorank.io
  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.
  title: Cryptorank API V3
  version: 3.0.0
servers:
  - url: https://api.cryptorank.io
security: []
tags: []
paths:
  /v3/public-sales/list:
    get:
      tags:
        - Public Sales
      summary: Public Sales List
      description: >-
        **Description**


        Returns a feed of public sales, with filters.


        > **Tip:** Sale details are available via
        [/public-sales/:id](https://docs.cryptorank.io/api-reference/public-sales/public-sale-detail).


        **Access**

        - Available from: **Pro**

        - Cost: 1 credit per request
      operationId: PublicSalesController_getList
      parameters:
        - description: Page number (1-based). Returns up to 100 items per page.
          in: query
          name: page
          required: false
          schema:
            default: 1
            maximum: 1000
            minimum: 1
            type: number
        - description: >-
            Currency ID. See: [GET
            /v3/currencies/map](https://docs.cryptorank.io/api-reference/currencies/currency-map-id-reference).
          in: query
          name: currencyId
          required: false
          schema:
            example: 28
            type: number
        - description: Sale type.
          in: query
          name: type
          required: false
          schema:
            enum:
              - Angel
              - ICO
              - IEO
              - IDO
              - Node Sale
              - KOL
              - Private/Pre-sale
              - Private
              - Private 2
              - Pre-sale
              - Strategic
              - Strategic 2
              - Pre-Seed
              - Seed
            type: string
        - description: Sale status.
          in: query
          name: status
          required: false
          schema:
            enum:
              - upcoming
              - active
              - past
            type: string
        - description: >-
            Comma-separated launchpad IDs. See: [GET
            /v3/launchpads/map](https://docs.cryptorank.io/api-reference/launchpads/launchpads-map).
          in: query
          name: launchpadIds
          required: false
          schema:
            example: 12,34
            type: string
        - description: >-
            Sale-date window start (inclusive). Accepts ISO 8601 string or Unix
            timestamp (sec/ms). Defaults to 30 days ago.
          in: query
          name: from
          required: false
          schema:
            example: '2024-01-01T00:00:00.000Z'
            type: string
        - description: >-
            Sale-date window end (inclusive). Accepts ISO 8601 string or Unix
            timestamp (sec/ms). No default — open-ended, so upcoming sales are
            included.
          in: query
          name: to
          required: false
          schema:
            example: '2024-12-31T23:59:59.999Z'
            type: string
        - description: Sort field.
          in: query
          name: sortBy
          required: false
          schema:
            default: id
            enum:
              - id
              - date
              - raised
            type: string
        - description: Sort direction.
          in: query
          name: sortOrder
          required: false
          schema:
            default: desc
            enum:
              - asc
              - desc
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/PublicSaleListItemDto'
                    type: array
                  meta:
                    $ref: '#/components/schemas/ListMetaDto'
                  status:
                    $ref: '#/components/schemas/ResponseStatusDto'
                required:
                  - data
                  - meta
                  - status
                type: object
          description: ''
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - VALIDATION_ERROR
                        example: VALIDATION_ERROR
                        type: string
                      message:
                        example: Validation failed
                        type: string
                      status:
                        example: 400
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: Request validation failed
        '401':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - API_KEY_MISSING
                          - API_KEY_INVALID
                        example: API_KEY_MISSING
                        type: string
                      message:
                        example: API key is missing
                        type: string
                      status:
                        example: 401
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: API key is missing or invalid
        '403':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - NO_ACTIVE_SUBSCRIPTION
                          - ENDPOINT_NOT_AVAILABLE
                          - PLAN_LIMIT_EXCEEDED
                        example: NO_ACTIVE_SUBSCRIPTION
                        type: string
                      message:
                        example: No active subscription found
                        type: string
                      status:
                        example: 403
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: >-
            No active subscription, the endpoint is not available in your plan,
            or the request goes beyond what your plan allows
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - RATE_LIMIT_EXCEEDED
                          - DAILY_CREDITS_EXCEEDED
                          - MONTHLY_CREDITS_EXCEEDED
                        example: RATE_LIMIT_EXCEEDED
                        type: string
                      message:
                        example: Rate limit exceeded
                        type: string
                      status:
                        example: 429
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: Rate limit or credit limit exceeded
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - INTERNAL_ERROR
                        example: INTERNAL_ERROR
                        type: string
                      message:
                        example: Internal server error
                        type: string
                      status:
                        example: 500
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: Internal server error
      security:
        - X-Api-Key: []
components:
  schemas:
    PublicSaleListItemDto:
      properties:
        athRoi:
          description: >-
            All-time-high ROI vs sale price, as a multiplier (e.g. 5.4 = 5.4×).
            Null when the sale price or ATH price is unavailable.
          example: 5.4
          nullable: true
          type: number
        blockchains:
          description: >-
            Blockchains associated with the sale. Empty array when none are
            assigned.
          example:
            - Ethereum
            - BNB Chain
          items:
            type: string
          type: array
        category:
          allOf:
            - $ref: '#/components/schemas/PublicSaleCategoryDto'
          description: Coin primary category. Null when no category is assigned.
          nullable: true
          type: object
        currencyId:
          description: Coin numeric identifier.
          example: 28
          type: number
        currencyName:
          description: Display name.
          example: Ethereum
          type: string
        currencySlug:
          description: URL-friendly entity slug.
          example: ethereum
          type: string
        currencySymbol:
          description: Native token symbol (e.g. 'ETH', 'BNB').
          example: ETH
          nullable: true
          type: string
        currentMarketCap:
          description: >-
            Current market cap, USD. Populated only for `past` sales; null
            otherwise.
          example: '300000000'
          nullable: true
          type: string
        date:
          description: >-
            Sale date (ISO 8601 UTC): start date for `upcoming`/`active` sales,
            end date for `past` sales. Null when unknown.
          example: '2024-08-15T00:00:00.000Z'
          nullable: true
          type: string
        id:
          description: Public sale ID.
          example: 1234
          type: number
        imageUrl:
          description: Logo image URL, 150x150. Null when no image is available.
          example: https://img.cryptorank.io/coins/150x150.ethereum1696248147028.png
          nullable: true
          type: string
        launchpadId:
          description: Sale launchpad ID. Null when sold outside a launchpad.
          example: 42
          nullable: true
          type: number
        launchpadName:
          description: Launchpad name. Null when sold outside a launchpad.
          example: CoinList
          nullable: true
          type: string
        listingDate:
          description: >-
            Token listing date (ISO 8601 UTC). Populated only for `past` sales;
            null otherwise.
          example: '2024-10-01T00:00:00.000Z'
          nullable: true
          type: string
        listingPrice:
          description: >-
            Token listing price, USD. Populated only for `past` sales; null
            otherwise.
          example: '0.40'
          nullable: true
          type: string
        raised:
          description: Total raised, USD. Null when undisclosed.
          example: '5000000'
          nullable: true
          type: string
        roi:
          description: >-
            Current ROI vs sale price, as a multiplier (e.g. 1.11 = 1.11×). Null
            when the sale price or current price is unavailable.
          example: 1.11
          nullable: true
          type: number
        salePrice:
          description: Token price during the sale, USD. Null when undisclosed.
          example: '0.25'
          nullable: true
          type: string
        status:
          description: 'Sale lifecycle status: upcoming, active, past.'
          enum:
            - upcoming
            - active
            - past
          example: past
          type: string
        totalRaised:
          description: >-
            Total amount raised, USD — cumulative across all rounds (public
            sales, private funding, node sales). Null when no fundraising data
            is available.
          example: '125000000'
          nullable: true
          type: string
        type:
          description: Sale format.
          enum:
            - Angel
            - ICO
            - IEO
            - IDO
            - Node Sale
            - KOL
            - Private/Pre-sale
            - Private
            - Private 2
            - Pre-sale
            - Strategic
            - Strategic 2
            - Pre-Seed
            - Seed
          example: IDO
          type: string
        valuation:
          description: Project valuation at the sale, USD. Null when undisclosed.
          example: '150000000'
          nullable: true
          type: string
      required:
        - id
        - currencyId
        - currencyName
        - currencySymbol
        - currencySlug
        - imageUrl
        - type
        - launchpadId
        - date
        - raised
        - salePrice
        - roi
        - athRoi
        - category
        - status
        - totalRaised
        - valuation
        - launchpadName
        - blockchains
        - listingDate
        - listingPrice
        - currentMarketCap
      type: object
    ListMetaDto:
      properties:
        hasNextPage:
          description: Whether a further page of results exists
          example: true
          type: boolean
        page:
          description: Current page number (1-based)
          example: 1
          type: number
        pageSize:
          description: >-
            Fixed number of items per page for this endpoint (varies per
            endpoint)
          example: 25
          type: number
      required:
        - page
        - pageSize
        - hasNextPage
      type: object
    ResponseStatusDto:
      properties:
        timestamp:
          description: Server time of the response. Unix timestamp in milliseconds
          example: 1780000000000
          type: number
        usedCredits:
          description: Credits charged for this request
          example: 1
          type: number
      required:
        - usedCredits
        - timestamp
      type: object
    PublicSaleCategoryDto:
      properties:
        id:
          example: 12
          type: number
        name:
          example: DeFi
          type: string
        slug:
          example: defi
          type: string
      required:
        - id
        - slug
        - name
      type: object
  securitySchemes:
    X-Api-Key:
      in: header
      name: X-Api-Key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.