Launchpad API

Endpoints for browsing token sales on the QsnDEX launchpad, viewing sale details, and checking user contributions.

List Token Sales

GET /api/launchpad/sales

Returns all token sales, including upcoming, active, and completed sales.

Query Parameters:

Parameter	Type	Description
chain_id	integer	Target chain ID
status	string	Filter by status: upcoming, active, completed, all (default: all)
limit	integer	Number of results (default: 20)
offset	integer	Pagination offset (default: 0)

Response:

{
  "success": true,
  "data": [
    {
      "id": "sale_001",
      "token": { "address": "0x...", "name": "New Token", "symbol": "NTK" },
      "status": "active",
      "total_raise_cap_usd": 500000.00,
      "total_raised_usd": 312500.00,
      "token_price_usd": 0.05,
      "start_time": 1700000000,
      "end_time": 1700604800,
      "participants": 245
    }
  ],
  "total": 12
}

Sale Detail

GET /api/launchpad/sales/{id}

Returns full details for a specific token sale.

Path Parameters:

Parameter	Type	Description
id	string	Sale identifier

Response:

{
  "success": true,
  "data": {
    "id": "sale_001",
    "token": {
      "address": "0x...",
      "name": "New Token",
      "symbol": "NTK",
      "decimals": 18,
      "total_supply": "100000000"
    },
    "status": "active",
    "sale_token_amount": "10000000",
    "token_price_usd": 0.05,
    "payment_token": { "address": "0x...", "symbol": "USDC" },
    "total_raise_cap_usd": 500000.00,
    "total_raised_usd": 312500.00,
    "min_contribution_usd": 10.00,
    "max_contribution_usd": 5000.00,
    "start_time": 1700000000,
    "end_time": 1700604800,
    "claim_time": 1700691200,
    "vesting_duration_days": 30,
    "participants": 245,
    "creator": "0x..."
  }
}

Sale Statuses

Status	Description
upcoming	Sale has been created but has not started yet
active	Sale is currently accepting contributions
completed	Sale has ended (either cap reached or time expired)
cancelled	Sale was cancelled by the creator

User Contribution

GET /api/launchpad/sales/{id}/user/{wallet}

Returns a user's contribution to a specific sale.

Path Parameters:

Parameter	Type	Description
id	string	Sale identifier
wallet	string	User wallet address

Response:

{
  "success": true,
  "data": {
    "sale_id": "sale_001",
    "wallet": "0x...",
    "contributed_usd": 2500.00,
    "contributed_amount": "2500000000",
    "token_allocation": "50000.00",
    "claimed": false,
    "claimable_at": 1700691200
  }
}