Asks (listings)

get

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

Use this API to search asks

Query Params

chain

string

enum

required

ids[]

array of strings

required

length ≤ 40

Direct fetch asks by ids, other filters will be ignored if ids is provided. Either ids and collectionId must be provided

ids[]*

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[]

makers[]

array of strings

length ≤ 40

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

makers[]

sources[]

array of objects

length ≤ 5

Filter by order source.

sources[]

status[]

array of objects

length ≤ 5

Filter by order status. default active

status[]

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 asc

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

Credentials

Header

Response

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

*/*

200Successful