# Bids

View and manage bids on marketplace items

## List marketplace 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.<br>

```json
{"openapi":"3.1.0","info":{"title":"Decentraland Marketplace Server API","version":"1.0.0"},"tags":[{"name":"Bids","description":"View and manage bids on marketplace items"}],"servers":[{"url":"https://marketplace-api.decentraland.org","description":"Production server"},{"url":"https://marketplace-api.decentraland.zone","description":"Development server"}],"security":[],"paths":{"/v1/bids":{"get":{"tags":["Bids"],"summary":"List marketplace bids","description":"Retrieves a paginated list of bids placed on marketplace items.\nBids represent offers made by potential buyers on NFTs and items.\n\n**Filter options:**\n- Bidder and seller addresses\n- Contract address, token ID, and item ID\n- Bid status (open, sold, cancelled)\n- Network (Ethereum, Polygon)\n\n**Sorting options:**\n- recently_offered (default)\n- recently_updated\n- most_expensive\n\n**Pagination:** Uses `limit` and `offset` parameters.\n\nResults include bid amounts, timestamps, and current status.\n","operationId":"getBids","parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum number of bids to return per request (default: 100, max: 100)","schema":{"type":"number","default":100,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Number of bids to skip for pagination (default: 0)","schema":{"type":"number","default":0}},{"name":"sortBy","in":"query","required":false,"description":"Sort results by specified criteria","schema":{"type":"string","enum":["recently_offered","recently_updated","most_expensive"]}},{"name":"bidder","in":"query","required":false,"description":"Filter by bidder wallet address","schema":{"type":"string"}},{"name":"seller","in":"query","required":false,"description":"Filter by seller wallet address","schema":{"type":"string"}},{"name":"contractAddress","in":"query","required":false,"description":"Filter by NFT contract address","schema":{"type":"string"}},{"name":"tokenId","in":"query","required":false,"description":"Filter by specific token ID","schema":{"type":"string"}},{"name":"itemId","in":"query","required":false,"description":"Filter by item ID","schema":{"type":"string"}},{"name":"network","in":"query","required":false,"description":"Filter by blockchain network","schema":{"type":"string","enum":["ETHEREUM","MATIC"]}},{"name":"status","in":"query","required":false,"description":"Filter by bid/listing status","schema":{"type":"string","enum":["open","sold","cancelled"]}}],"responses":{"200":{"description":"Paginated list of bids","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","description":"A bid placed on an NFT or item in the marketplace","properties":{"id":{"type":"string","description":"Unique bid identifier"},"bidder":{"type":"string","description":"Bidder wallet address"},"seller":{"type":"string","description":"Seller wallet address"},"price":{"type":"string","description":"Bid price in Wei"},"fingerprint":{"type":"string","description":"Bid fingerprint for verification"},"status":{"type":"string","enum":["open","sold","cancelled"],"description":"Current bid status"},"blockchainId":{"type":"string","description":"Blockchain transaction ID"},"blockNumber":{"type":"string","description":"Block number when bid was created"},"expiresAt":{"type":"number","description":"Expiration timestamp (Unix epoch in milliseconds)"},"createdAt":{"type":"number","description":"Creation timestamp (Unix epoch in milliseconds)"},"updatedAt":{"type":"number","description":"Last update timestamp (Unix epoch in milliseconds)"},"contractAddress":{"type":"string","description":"NFT contract address"},"tokenId":{"type":"string","description":"Token ID being bid on"},"network":{"type":"string","enum":["ETHEREUM","MATIC"],"description":"Blockchain network"},"chainId":{"type":"number","description":"Chain ID"}},"required":["id","bidder","price","status"]}},"total":{"type":"number","description":"Total number of bids matching the filters"},"page":{"type":"number","description":"Current page number (0-indexed)"},"pages":{"type":"number","description":"Total number of pages"},"limit":{"type":"number","description":"Number of items per page"}},"required":["results","total","page","pages","limit"]}},"required":["ok","data"]}}}},"400":{"description":"Bad request - invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"string","description":"Error code"}},"required":["error"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"string","description":"Error code"}},"required":["error"]}}}}}}}}}
```