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

# Create new auction

`POST /api/v1/auctions`

Create a new auction with the specified parameters. Requires authentication with auction_manage permissions.

## Request body

- object
  - `slot` integer, required — Ethereum slot number for the auction
  - `scheduledStart` number, required — Scheduled start timestamp
  - `duration` integer, required — Auction duration in milliseconds
  - `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)
  - `metadata` object — Additional auction metadata

## Response `201`

Auction created successfully

- 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)
    - `createdBy` string, required — ID of user who created the auction
    - `metadata` object — Additional auction metadata
    - `biddingRounds` integer, required — Number of bidding rounds
    - `lastBidAt` number — Timestamp of last bid
    - `settledBy` string — ID of user who settled the auction
    - `settlementReason` string — Reason for settlement
    - `gasUsed` string — Gas used for settlement
    - `revenueDistribution` object
      - `totalRevenue` string, required — Total revenue generated
      - `platformFee` string, required — Platform fee amount
      - `netRevenue` string, required — Net revenue after fees
  - `message` string, required — Success message

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions
- `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)