---
title: "Get comprehensive auction overview with market insights"
method: GET
path: "/api/v1/public/overview"
tags: ["Public"]
---

# Get comprehensive auction overview with market insights

`GET /api/v1/public/overview`

Retrieve a comprehensive overview of the auction system including active auctions, upcoming auctions, recent results, and market statistics.

## Query parameters

- `next_auctions` integer — Number of next auctions to include
- `completed_auctions` integer — Number of completed auctions to include
- `include_market_stats` boolean, nullable — Include market statistics
- `include_slot_timing` boolean, nullable — Include slot timing information
- `time_range_hours` integer — Time range for statistics in hours

## Response `200`

Comprehensive auction overview

- object
  - `success` true, required
  - `timestamp` number, required
  - `overview` object, required
    - `currentActiveAuctions` 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)
    - `nextScheduledAuctions` 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)
    - `recentCompletedAuctions` 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)
    - `marketStatistics` object
      - `totalAuctions` integer, required
      - `totalBids` integer, required
      - `totalRevenue` string, required — Total revenue in wei
      - `averageClearingPrice` string, required — Average clearing price in wei
      - `averageBidsPerAuction` number, required
    - `slotTiming` object
      - `currentSlot` integer, required
      - `nextSlotIn` number, required — Time until next slot in milliseconds
      - `averageSlotTime` number, required — Average slot duration in milliseconds
      - `slotEfficiency` number, required — Slot efficiency ratio
    - `systemHealth` object, required
      - `auctionSystemStatus` 'healthy' | 'degraded' | 'unhealthy', required
      - `biddingSystemStatus` 'healthy' | 'degraded' | 'unhealthy', required
      - `lastHealthCheck` number, required — Last health check timestamp
  - `metadata` object, required
    - `cacheInfo` object, required
      - `cached` boolean, required
      - `maxAge` number, required
    - `dataFreshness` object, required
      - `activeAuctions` integer, required
      - `upcomingAuctions` integer, required
      - `recentlyCompleted` integer, required
      - `lastUpdate` number, required — Last data update timestamp
    - `queryParams` object, 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/versions/329190dccb50/schema)