latestOpenAPI 3.1.02026-08-1013317298.0 KB
d94e0e0f1821
Bids
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.
get/v1/bids
Query parameters
limitnumber
Maximum number of bids to return per request (default: 100, max: 100)
offsetnumber
Number of bids to skip for pagination (default: 0)
sortBy'recently_offered' | 'recently_updated' | 'most_expensive'
Sort results by specified criteria
bidderstring
Filter by bidder wallet address
sellerstring
Filter by seller wallet address
contractAddressstring
Filter by NFT contract address
tokenIdstring
Filter by specific token ID
itemIdstring
Filter by item ID
network'ETHEREUM' | 'MATIC'
Filter by blockchain network
status'open' | 'sold' | 'cancelled'
Filter by bid/listing status
Response
Paginated list of bids