Bids

View and manage bids on marketplace items

List marketplace bids

get

https://marketplace-api.decentraland.orghttps://marketplace-api.decentraland.zone

/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

limitnumber · max: 100Optional

Maximum number of bids to return per request (default: 100, max: 100)

Default: 100Example: 10

offsetnumberOptional

Number of bids to skip for pagination (default: 0)

Default: 0Example: 0

sortBystring · enumOptional

Sort results by specified criteria

Example: recently_offeredPossible values:

bidderstringOptional

Filter by bidder wallet address

Example: 0x1234567890abcdef1234567890abcdef12345678

sellerstringOptional

Filter by seller wallet address

contractAddressstringOptional

Filter by NFT contract address

Example: 0x1234567890abcdef1234567890abcdef12345678

tokenIdstringOptional

Filter by specific token ID

itemIdstringOptional

Filter by item ID

networkstring · enumOptional

Filter by blockchain network

Example: MATICPossible values:

statusstring · enumOptional

Filter by bid/listing status

Example: openPossible values:

Responses

200

Paginated list of bids

application/json

400

Bad request - invalid parameters

application/json

500

Internal server error

application/json

get

/v1/bids

HTTPcURLJavaScriptPython

GET /v1/bids HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*

{
  "ok": true,
  "data": {
    "results": [
      {
        "id": "text",
        "bidder": "0x1234567890abcdef1234567890abcdef12345678",
        "seller": "0x1234567890abcdef1234567890abcdef12345678",
        "price": "1000000000000000000",
        "fingerprint": "text",
        "status": "open",
        "blockchainId": "text",
        "blockNumber": "text",
        "expiresAt": 1,
        "createdAt": 1,
        "updatedAt": 1,
        "contractAddress": "text",
        "tokenId": "text",
        "network": "ETHEREUM",
        "chainId": 1
      }
    ],
    "total": 1,
    "page": 1,
    "pages": 1,
    "limit": 1
  }
}