---
title: "Submit a new bid"
method: POST
path: "/api/v1/bids"
tags: ["bids"]
---

# Submit a new bid

`POST /api/v1/bids`

Submit a bid for a specific auction slot. Validates all critical constraints:
      - Temporal validity (before auction deadline)
      - Economic validity (reserve price, value bounds)
      - Gas constraints (fee_cap >= tip_cap)
      - Entity limits (max bids per slot)
      - Rate limits (max bids per time window)
      - Auction state (must be in bidding state)

## Request body

- SubmitBidDto
  - `slot` integer, required — Slot number for the bid (must be future slot)
  - `value` string, required — Bid value in wei (as string for BigInt precision). Must be greater than auction reserve price and follow gas constraints. Example: "1000000000000000000" = 1 ETH
  - `quantity` number — Quantity of units to bid for
  - `gasFeeCap` string, required — Gas fee cap in wei - must be >= gasTipCap for EIP-1559 compatibility
  - `gasTipCap` string, required — Gas tip cap in wei - must be <= gasFeeCap for EIP-1559 compatibility
  - `builderPublicKey` string, required — Builder public key for block proposal (0x-prefixed hex string)
  - `metadata` object — Additional bid metadata

## Response `201`

Bid submitted successfully

- BidResponseDto
  - `id` string, required — Unique bid identifier
  - `slot` number, required — Slot number
  - `entityId` string, required — Entity identifier
  - `value` string, required — Bid value in wei
  - `quantity` number, required — Quantity of units
  - `gasFeeCap` string, required — Gas fee cap in wei
  - `gasTipCap` string, required — Gas tip cap in wei
  - `builderPublicKey` string, required — Builder public key
  - `status` 'pending' | 'submitted' | 'validated' | 'updated' | 'winning' | 'partial' | 'lost' | 'cancelled' | 'expired', required — Current bid status
  - `submittedAt` string, date-time, required — Bid submission timestamp
  - `updatedAt` string, date-time, required — Last update timestamp
  - `validatedAt` string, date-time — Validation timestamp
  - `validFrom` string, date-time, required — Bid valid from timestamp
  - `validUntil` string, date-time, required — Bid valid until timestamp
  - `version` number, required — Bid version number
  - `nonce` string, required — Unique nonce for replay protection
  - `metadata` object — Additional bid metadata
  - `isActive` boolean, required — Whether bid is currently active
  - `isModifiable` boolean, required — Whether bid can be modified
  - `hasExpired` boolean, required — Whether bid has expired

## Other responses

- `400` — Validation failed (temporal, economic, gas, or rate limit constraints)
- `404` — Auction not found for specified slot

---

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