---
title: "List marketplace bids"
method: GET
path: "/v1/bids"
tags: ["Bids"]
---

# List marketplace bids

`GET /v1/bids`

Retrieves a paginated list of bids placed on marketplace items.
Bids represent offers made by potential buyers on NFTs and items.

**Filter options:**
- Bidder and seller addresses
- Contract address, token ID, and item ID
- Bid status (open, sold, cancelled)
- Network (Ethereum, Polygon)

**Sorting options:**
- recently_offered (default)
- recently_updated
- most_expensive

**Pagination:** Uses `limit` and `offset` parameters.

Results include bid amounts, timestamps, and current status.

## Query parameters

- `limit` number
- `offset` number
- `sortBy` 'recently_offered' | 'recently_updated' | 'most_expensive'
- `bidder` string
- `seller` string
- `contractAddress` string
- `tokenId` string
- `itemId` string
- `network` 'ETHEREUM' | 'MATIC'
- `status` 'open' | 'sold' | 'cancelled'

## Response `200`

Paginated list of bids

- object
  - `ok` boolean, required
  - `data` object, required
    - `results` object[], required
      - `id` string, required — Unique bid identifier
      - `bidder` string, required — Bidder wallet address
      - `seller` string — Seller wallet address
      - `price` string, required — Bid price in Wei
      - `fingerprint` string — Bid fingerprint for verification
      - `status` 'open' | 'sold' | 'cancelled', required — Current bid status
      - `blockchainId` string — Blockchain transaction ID
      - `blockNumber` string — Block number when bid was created
      - `expiresAt` number — Expiration timestamp (Unix epoch in milliseconds)
      - `createdAt` number — Creation timestamp (Unix epoch in milliseconds)
      - `updatedAt` number — Last update timestamp (Unix epoch in milliseconds)
      - `contractAddress` string — NFT contract address
      - `tokenId` string — Token ID being bid on
      - `network` 'ETHEREUM' | 'MATIC' — Blockchain network
      - `chainId` number — Chain ID
    - `total` number, required — Total number of bids matching the filters
    - `page` number, required — Current page number (0-indexed)
    - `pages` number, required — Total number of pages
    - `limit` number, required — Number of items per page

## Other responses

- `400` — Bad request - invalid parameters
- `500` — Internal server error

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)