Public Sales

Public Sales List

Description

Returns a feed of public sales, with filters.

Tip: Sale details are available via /public-sales/:id.

Access

  • Available from: Pro
  • Cost: 1 credit per request
get/v3/public-sales/list

Request

  • Base URL: https://api.cryptorank.io
  • URL: https://api.cryptorank.io/v3/public-sales/list
  • Auth: API key in header X-Api-Key

Query parameters

pagenumber

Page number (1-based). Returns up to 100 items per page.

currencyIdnumber
Example:28

Currency ID. See: GET /v3/currencies/map.

type'Angel' | 'ICO' | 'IEO' | 'IDO' | 'Node Sale' | 'KOL' | 'Private/Pre-sale' | 'Private' | 'Private 2' | 'Pre-sale' | 'Strategic' | 'Strategic 2' | 'Pre-Seed' | 'Seed'

Sale type.

status'upcoming' | 'active' | 'past'

Sale status.

launchpadIdsstring
Example:12,34

Comma-separated launchpad IDs. See: GET /v3/launchpads/map.

fromstring
Example:2024-01-01T00:00:00.000Z

Sale-date window start (inclusive). Accepts ISO 8601 string or Unix timestamp (sec/ms). Defaults to 30 days ago.

tostring
Example:2024-12-31T23:59:59.999Z

Sale-date window end (inclusive). Accepts ISO 8601 string or Unix timestamp (sec/ms). No default — open-ended, so upcoming sales are included.

sortBy'id' | 'date' | 'raised'

Sort field.

sortOrder'asc' | 'desc'

Sort direction.

Response

Example response

{
  "data": [
    {
      "athRoi": 5.4,
      "blockchains": [
        "Ethereum",
        "BNB Chain"
      ],
      "category": {
        "id": 12,
        "name": "DeFi",
        "slug": "defi"
      },
      "currencyId": 28,
      "currencyName": "Ethereum",
      "currencySlug": "ethereum",
      "currencySymbol": "ETH",
      "currentMarketCap": "300000000",
      "date": "2024-08-15T00:00:00.000Z",
      "id": 1234,
      "imageUrl": "https://img.cryptorank.io/coins/150x150.ethereum1696248147028.png",
      "launchpadId": 42,
      "launchpadName": "CoinList",
      "listingDate": "2024-10-01T00:00:00.000Z",
      "listingPrice": "0.40",
      "raised": "5000000",
      "roi": 1.11,
      "salePrice": "0.25",
      "status": "past",
      "totalRaised": "125000000",
      "type": "IDO",
      "valuation": "150000000"
    }
  ],
  "meta": {
    "hasNextPage": true,
    "page": 1,
    "pageSize": 25
  },
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.