---
title: "Get latest auction results with enhanced data"
method: GET
path: "/api/v1/public/auctions/latest-results"
tags: ["Public"]
---

# Get latest auction results with enhanced data

`GET /api/v1/public/auctions/latest-results`

## Request

- Base URL: `https://xga-auction-system.workers.dev`
- URL: `https://xga-auction-system.workers.dev/api/v1/public/auctions/latest-results`
- Auth: none declared
- TypeScript: <https://skmtc.dev/manifoldfinance/apis/xga-auction-system-api/docs/api/v1/public/auctions/latest-results/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the latest auction results with optional analytics, trend analysis, and market metrics.

## Query parameters

- `limit` integer: Number of items per page
- `cursor` string: Cursor for pagination
- `include_metrics` boolean, nullable: Include advanced metrics
- `include_trend_analysis` boolean, nullable: Include trend analysis
- `include_market_metrics` boolean, nullable: Include market metrics
- `include_performance_data` boolean, nullable: Include performance data
- `slot_from` integer, nullable: Starting slot number
- `slot_to` integer, nullable: Ending slot number
- `sort_by` 'settledAt' | 'slot' | 'clearingPrice' | 'totalBids'
- `sort_order` 'asc' | 'desc': Sort order

## Response `200`

Latest auction results with optional analytics

- object
  - `success` true, required
  - `timestamp` number, required
  - `data` 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)
  - `statistics` 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
  - `trendAnalysis` object
    - `priceMovement` 'up' | 'down' | 'stable', required
    - `volatility` number, required: Price volatility (0-1)
    - `demandTrend` number, required: Demand trend factor
    - `supplyUtilization` number, required: Supply utilization rate
  - `marketMetrics` object
    - `totalVolume` string, required: Total trading volume in wei
    - `averagePrice` string, required: Average clearing price in wei
    - `priceVolatility` number, required: Price volatility index
    - `supplyUtilization` number, required: Average supply utilization
    - `demandIntensity` number, required: Demand intensity metric
  - `performanceData` object
    - `processingTime` number, required: Processing time in milliseconds
    - `cacheHitRate` number, required: Cache hit rate
    - `dataSource` 'live' | 'cached', required: Data source type
    - `lastUpdate` number, required: Last data update timestamp
  - `metadata` object, required
    - `queryParams` object, required
    - `cacheInfo` object, required
      - `key` string, required
      - `strategy` string, required
      - `ttl` number, required
    - `processingTime` number
    - `dataSource` string
  - `count` integer, required
  - `total` integer, 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.dev/manifoldfinance/apis/xga-auction-system-api.md) - [All operations](https://skmtc.dev/manifoldfinance/apis/xga-auction-system-api/llms.txt) - [OpenAPI document](https://skmtc.dev/manifoldfinance/apis/xga-auction-system-api/revisions/329190dccb50?raw)