---
title: "Get specific auction by ID (public view) with enhanced data"
method: GET
path: "/api/v1/public/auctions/{id}"
tags: ["Public"]
---

# Get specific auction by ID (public view) with enhanced data

`GET /api/v1/public/auctions/{id}`

Retrieve detailed information about a specific auction with optional analytics and bid statistics.

## Path parameters

- `id` string, required — Auction ID

## Query parameters

- `include_analytics` boolean, nullable — Include analytics data
- `include_bid_stats` boolean, nullable — Include bid statistics

## Response `200`

Auction details with optional analytics

- object
  - `success` true, required
  - `timestamp` number, required
  - `auction` object, required
    - `id` string, required — Unique auction identifier
    - `slot` integer, required — Ethereum slot number
    - `state` 'scheduled' | 'active' | 'settling' | 'settled', required
    - `createdAt` number, required — Creation timestamp
    - `scheduledStart` number, required — Scheduled start timestamp
    - `actualStart` number — Actual start timestamp
    - `endTime` number, required — End timestamp
    - `settledAt` number — Settlement timestamp
    - `minBid` string, required — Minimum bid amount in wei
    - `elasticSupply` object, required
      - `basePrice` string, required — Base price in wei
      - `maxCapacity` integer, required — Maximum capacity
      - `minCapacity` integer, required — Minimum capacity
      - `elasticity` number, required — Elasticity factor (0-1)
    - `currentSupply` integer, required — Current allocated supply
    - `totalBids` integer, required — Total number of bids
    - `clearingPrice` string — Clearing price in wei
    - `highestBidAmount` string — Highest bid amount in wei (no bidder info)
  - `analytics` object
    - `timeElapsed` number, required — Time elapsed since start (ms)
    - `timeRemaining` number, required — Time remaining until end (ms)
    - `duration` number, required — Total auction duration (ms)
    - `progressPercentage` number, required — Progress percentage
    - `isOvertime` boolean, required — Whether auction is past end time
    - `phaseInfo` object, required
      - `current` 'scheduled' | 'active' | 'settling' | 'settled', required
      - `isPreStart` boolean, required
      - `isActive` boolean, required
      - `isSettling` boolean, required
      - `isComplete` boolean, required
  - `bidStats` object
    - `totalBids` integer, required
    - `currentAllocation` integer, required
    - `maxCapacity` integer, required
    - `allocationRatio` number, required — Allocation ratio as percentage
    - `competitionLevel` number, required — Competition level (0-10)
    - `priceDiscovery` object, required
      - `hasClearing` boolean, required
      - `clearingPrice` string, nullable, required
      - `minBid` string, required
      - `priceRange` object, nullable, required
        - `spread` string, required
        - `multiplier` number, required

## Other responses

- `400` — Bad Request - Invalid input parameters
- `404` — Not Found - Resource not found
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error

---

[API](https://skmtc.net/manifoldfinance/apis/xga-auction-system-api.md) · [All operations](https://skmtc.net/manifoldfinance/apis/xga-auction-system-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/manifoldfinance/xga-auction-system-api/revisions/329190dccb50/schema)