Bids (offers)

get

https://api-mainnet.magiceden.dev/v4/evm-public/orders/bids

Use this API to search bids

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

chain

string

enum

required

ids[]

array of strings

required

length ≤ 40

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

ids[]*

bidTypes[]

array of objects

required

Filter by bid types

bidTypes[]*

Allowed:

collectionId

string

required

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

assetIds[]

array of strings

length ≤ 40

Filter by asset ids. example: 0xbd3531da5cf5857e7cfaa92426877b022e612cf8:0

assetIds[]

attributes[]

array of strings

length ≤ 40

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

attributes[]

makers[]

array of strings

length ≤ 40

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

makers[]

sources[]

array of objects

length ≤ 5

Filter by order source.

sources[]

Allowed:

status[]

array of objects

length ≤ 5

Filter by order status. default active

status[]

Allowed:

createAfter

string

required

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

updateAfter

string

required

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

sortBy

string

enum

Defaults to price

Allowed:

sortDir

string

enum

Defaults to desc

Allowed:

limit

number

1 to 100

Defaults to 20

Amount of items returned, default to 20

continuation

string

Use continuation token to request next offset of items.

Response

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

200Successful