---
title: "Get historical auctions with enhanced pagination and filtering"
method: GET
path: "/api/v1/public/auctions/history"
tags: ["Public"]
---

# Get historical auctions with enhanced pagination and filtering

`GET /api/v1/public/auctions/history`

## Request

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

Retrieve a paginated list of historical auctions with optional filtering by state, slot range, date range, and statistical data.

## Query parameters

- `limit` integer: Number of items per page
- `cursor` string: Cursor for pagination
- `state` 'scheduled' | 'active' | 'settling' | 'settled': Filter by auction state
- `include_stats` boolean, nullable: Include statistical data
- `from_date` number, nullable: Start date as Unix timestamp
- `to_date` number, nullable: End date as Unix timestamp
- `slot_from` integer, nullable: Starting slot number
- `slot_to` integer, nullable: Ending slot number
- `sort_by` 'createdAt' | 'slot' | 'state' | 'endTime' | 'settledAt'
- `sort_order` 'asc' | 'desc': Sort order

## Response `200`

Successful operation with enhanced pagination

- 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)
  - `cursor` string
  - `hasMore` boolean, required
  - `total` number
  - `count` number, required
  - `metadata` object, required
    - `totalPages` number
    - `currentPage` number
    - `pageSize` number, required
    - `firstItemTimestamp` number
    - `lastItemTimestamp` number

## 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)