Skip to main content
GET
/
v3
/
public-sales
Public sales feed
curl --request GET \
  --url https://api.cryptorank.io/v3/public-sales \
  --header 'X-Api-Key: <api-key>'
[
  {
    "id": 1234,
    "currencyId": 28,
    "currencyName": "Ethereum",
    "currencySymbol": "ETH",
    "type": "IDO",
    "status": "past",
    "startDate": "2024-08-15T00:00:00.000Z",
    "endDate": "2024-09-15T00:00:00.000Z",
    "raised": "5000000",
    "salePrice": "0.25",
    "totalRaised": "125000000",
    "valuation": "150000000",
    "launchpadId": 42,
    "launchpadName": "CoinList",
    "category": "DeFi",
    "blockchains": [
      "Ethereum",
      "BNB Chain"
    ],
    "moniScore": 1273,
    "listingDate": "2024-10-01T00:00:00.000Z",
    "listingPrice": "0.40",
    "currentMarketCap": "300000000"
  }
]

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.

Authorizations

​
X-Api-Key
string
header
required

Query Parameters

​
offset
number
default:0
Required range: 0 <= x <= 50000
​
limit
number
default:50
Required range: 1 <= x <= 500
​
status
enum<string>

Filter by sale lifecycle stage.

Available options:
upcoming,
active,
past
​
type
enum<string>

Filter by sale type.

Available options:
ICO,
IDO,
IEO
​
launchpadIds
string

Comma-separated launchpad identifiers. Matches any of the given launchpads.

Example:

"12,34"

​
from
string

Lower bound on the sale start date (ISO 8601 UTC, inclusive).

Example:

"2024-01-01T00:00:00.000Z"

​
to
string

Upper bound on the sale start date (ISO 8601 UTC, inclusive).

Example:

"2024-12-31T23:59:59.999Z"

​
sortBy
enum<string>
default:startDate
Available options:
startDate,
endDate
​
sortOrder
enum<string>
default:desc
Available options:
asc,
desc

Response

200 - application/json
​
id
number
required

Public sale round identifier.

Example:

1234

​
currencyId
number
required

Coin identifier in cryptorank.

Example:

28

​
currencyName
string
required
Example:

"Ethereum"

​
currencySymbol
string | null
required
Example:

"ETH"

​
type
enum<string>
required
Available options:
ICO,
IDO,
IEO
Example:

"IDO"

​
status
enum<string>
required
Available options:
upcoming,
active,
past
Example:

"past"

​
startDate
string | null
required

Sale start date (ISO 8601 UTC). Null when the date is unknown.

Example:

"2024-08-15T00:00:00.000Z"

​
endDate
string | null
required

Sale end date (ISO 8601 UTC). Null when the date is unknown.

Example:

"2024-09-15T00:00:00.000Z"

​
raised
string | null
required

Amount raised in this sale (USD). Null when undisclosed.

Example:

"5000000"

​
salePrice
string | null
required

Token price during this sale (USD). Null when undisclosed.

Example:

"0.25"

​
totalRaised
string | null
required

Cumulative funds raised by the project across all rounds (public sales + private funding + node sales), in USD. Null when no fundraising data is available.

Example:

"125000000"

​
valuation
string | null
required

Project valuation at this sale (USD). Null when undisclosed.

Example:

"150000000"

​
launchpadId
number | null
required

Launchpad identifier hosting the sale. Null when sold outside a launchpad.

Example:

42

​
launchpadName
string | null
required

Launchpad name. Null when sold outside a launchpad.

Example:

"CoinList"

​
category
string | null
required

Project primary category. Null when no category is assigned.

Example:

"DeFi"

​
blockchains
string[]
required

Blockchain platforms the project token is deployed on. Empty array when none are assigned.

Example:
["Ethereum", "BNB Chain"]
​
moniScore
number | null
required

Twitter engagement score of the project (higher is better; no fixed upper bound). Null when the project has no linked Twitter account or no score is available.

Example:

1273

​
listingDate
string | null
required

Token listing date (ISO 8601 UTC). Populated only for sales with status past; null otherwise.

Example:

"2024-10-01T00:00:00.000Z"

​
listingPrice
string | null
required

Token listing price (USD). Populated only for sales with status past; null otherwise.

Example:

"0.40"

​
currentMarketCap
string | null
required

Current project market capitalization (USD), based on the latest price and circulating supply. Populated only for sales with status past; null otherwise.

Example:

"300000000"