v1

latestOpenAPI 3.0.1Apache 2.02026-07-2686219209.3 KB
Orders

Bids (offers)

Use this API to search bids

get/orders/bids

Query parameters

chain'ethereum' | 'abstract' | 'apechain' | 'arbitrum' | 'base' | 'berachain' | 'bsc' | 'polygon' | 'sei' | 'avalanche' | 'monad' required
ids[]string[] required

Direct fetch bids by ids, other filters will be ignored if ids is provided. Either ids and bidTypes[] + collectionId must be provided

bidTypes[]BidTypeEnum[] required

Filter by bid types

collectionIdstring required

Filter by collectionId. example: 0xbd3531da5cf5857e7cfaa92426877b022e612cf8. Either ids and collectionId must be provided

assetIds[]string[]

Filter by asset ids. example: 0xbd3531da5cf5857e7cfaa92426877b022e612cf8:0

attributes[]string[]

Filter by attributes, could be a list, format as <attribute_name>:<attribute_value>, example: Background:Black

makers[]string[]

Filter by makers who made these bids. example: 0x47d88afbba889709abba07339ed1c88079944ca3

sources[]FilterOrderSourceEnum[]

Filter by order source.

status[]OrderStatusEnum[]

Filter by order status. default active

createAfterstring required

Filter orders after some create timestamp using UTC format. example: 2025-05-01T06:01:09.000Z.

updateAfterstring required

Filter orders after some update timestamp using UTC format. example: 2025-05-01T06:01:09.000Z.

sortBy'price' | 'createdAt' | 'updatedAt'
sortDir'asc' | 'desc'
limitnumber

Amount of items returned, default to 20

continuationstring

Use continuation token to request next offset of items.

Response

Successful