---
title: "Public Sale / Crowdsale"
method: GET
path: "/gateway/v1/market/public-sale"
tags: ["Market"]
---

# Public Sale / Crowdsale

`GET /gateway/v1/market/public-sale`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/market/public-sale`
- Auth: HTTP bearer

Returns public sale (IDO/ICO/IEO) information for a project.

Includes sale type, status, price, raise amount, and ROI data.

## Query parameters

- `id` string: Surf project UUID
- `q` string: Project name or symbol for entity resolution

## Response `200`

OK

- DataResponsePublicSaleItem
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` PublicSaleItem[], nullable, required
    - `allocation_of_supply` number, double: Percentage of total supply allocated
    - `ath_roi` number, double: All-time-high return on investment multiplier
    - `crowdsale_end_date` integer: Sale end date (Unix seconds)
    - `crowdsale_price` number, double: Token sale price in USD
    - `crowdsale_raise` number, double: Total funds raised in USD
    - `crowdsale_start_date` integer: Sale start date (Unix seconds)
    - `crowdsale_status` string: Sale status (UPCOMING, ACTIVE, ENDED)
    - `crowdsale_type` string: Sale type (IDO, ICO, IEO, etc.)
    - `launchpad_name` string: Launchpad platform name
    - `name` string: Project name
    - `project_id` string: Surf project UUID, for frontend entity linking.
    - `symbol` string: Token symbol
  - `meta` OffsetMeta, required
    - `cached` boolean, required: Whether this response was served from cache
    - `credits_used` integer, required: Credits deducted for this request
    - `empty_reason` string: Hint explaining why the data array is empty, when applicable
    - `has_more` boolean: Whether more items may exist beyond this response. For offset-paged endpoints, continue with a larger offset. For time-series endpoints without offset/cursor controls, true means the requested time range hit an upstream cap; narrow from/to to continue. Omitted when exhaustion cannot be proven.
    - `limit` integer, required: Maximum number of items returned in this response
    - `offset` integer, required: Number of items skipped (pagination offset)
    - `total` integer: Total number of matching items (before pagination). Omitted when total is unknown.
    - `watermark` integer: Warehouse watermark (Unix seconds) this response was computed at, on warehouse-backed endpoints (e.g. Hyperliquid /trades/aggregate) — rows up to this time come from the warehouse, newer rows from the live tail. Omitted elsewhere.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)