---
title: "Create a new auction"
method: POST
path: "/api/v1/auctions"
tags: ["auctions"]
---

# Create a new auction

`POST /api/v1/auctions`

Create a new auction for a specific slot. The auction will be initialized
      in 'pending' state and automatically transition through the 9-state lifecycle
      based on Ethereum slot timing.

## Request body

- CreateAuctionDto
  - `slot` number, required — Slot number for the auction
  - `metadata` object — Auction metadata including reserve price and settlement method

## Response `201`

Auction created successfully

- AuctionResponseDto
  - `id` string, required — Unique auction identifier
  - `slot` number, required — Slot number
  - `state` 'pending' | 'bidding' | 'closing' | 'settling' | 'settled' | 'finalizing' | 'finalized' | 'disputed' | 'cancelled', required — Current auction state
  - `createdAt` string, date-time, required — Auction creation timestamp
  - `biddingDeadline` string, date-time, required — Bidding deadline timestamp
  - `settlementDeadline` string, date-time, required — Settlement deadline timestamp
  - `finalizedAt` string, date-time — Finalization timestamp
  - `metadata` object — Auction metadata
  - `totalBids` number, required — Total number of bids
  - `clearingPrice` string — Clearing price in wei
  - `totalAllocated` number — Total allocated quantity

## Other responses

- `400` — Validation failed or slot already exists
- `422` — Business logic error (e.g., slot in the past)

---

[API](https://skmtc.dev/manifoldfinance/apis/eigenlayer-public-api-specification.md) · [All operations](https://skmtc.dev/manifoldfinance/apis/eigenlayer-public-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/manifoldfinance/eigenlayer-public-api-specification/revisions/068b24703dfe/schema)