Get Listings

get

https://api-mainnet.magiceden.dev/v2/ord/btc/raresats/listings

Get Rare Sats Listings by a Variety of Filters and Sorting Orders

Query Params

sortBy

array of strings

Defaults to priceAsc

Sort By

sortBy

limit

integer

100 to 500

Defaults to 100

Page limit

offset

integer

0 to 20000

Defaults to 0

Page offset

satributes

array of objects

Filter listings that have the given satributes in the same sat range

satributes

minListedAt

integer

Filter items that were listed after the given timestamp

maxListedAt

integer

Filter items that were listed before the given timestamp

minPrice

integer

Filter by minimum listed price in satoshis

maxPrice

integer

Filter by maximum listed price in satoshis

minUtxoSize

integer

Filter by minimum utxo size in satoshis

maxUtxoSize

integer

Filter by maximum utxo size in satoshis

minSatRange

integer

Filter by minimum sat range in sats

maxSatRange

integer

Filter by maximum sat range in sats

minBlockNumber

integer

Filter listings that only contain sats that were created after the given block number

maxBlockNumber

integer

Filter listings that only contain sats that were created before the given block number

minBlockTimestamp

integer

Filter listings that only contain sats that were created after the given timestamp

maxBlockTimestamp

integer

Filter listings that only contain sats that were created before the given timestamp

Response

Language

Response

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

application/json

200Successful response