Public Sales

Public Sales Trends (Aggregate)

Description

Aggregated time series of completed token sales (ICO, IDO, IEO). Each bucket includes total raised in USD and sales count by type.

Note: A from/to range reaching deeper than your plan allows returns 403 PLAN_LIMIT_EXCEEDED — the window is never silently cut.

Access

Available from: Advanced
Cost: 1 credit per request

get/v3/public-sales/trends

Request

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

Query parameters

interval'1d' | '1w' | '1m' required

Example:1m

Bucket size for aggregation: 1d — daily, 1w — weekly (ISO week), 1m — monthly.

fromstring required

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

Sale-date window start (inclusive). Accepts ISO 8601 string or Unix timestamp (sec/ms). Bounded by your plan's history limit — Advanced 2y, Pro 5y, Business 10y.

tostring

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

Sale-date window end (inclusive). Accepts ISO 8601 string or Unix timestamp (sec/ms). Bare YYYY-MM-DD is coerced to end-of-day UTC. Defaults to now.

Response

Example response

{
  "data": [
    {
      "date": "2024-08-01T00:00:00.000Z",
      "icoCount": 8,
      "idoCount": 28,
      "ieoCount": 6,
      "salesCount": 42,
      "totalRaised": "125000000"
    }
  ],
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

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