v1

latestOpenAPI 3.0.1Apache 2.02026-07-2686219209.3 KB
collections

Get listings of a collection

get/collections/{symbol}/listings

Path parameters

symbolstring required

collection symbol

Query parameters

offsetinteger

The number of items to skip, default 0, min 0

limitinteger

The numbers of items to return, default 20, min 1, max 100

min_pricenumber

Filter listings that are less than this price

max_pricenumber

Filter listings that are more than this price

Represents a filtering mechanism where the elements within each inner array are logically ORed, and the resulting arrays are ANDed together at the top level. Each inner array consists of objects with two properties: traitType (a string) and value (a string). For example: [[{"traitType":"trait1", "value":"value1"},{"traitType":"trait1", "value":"value2"}]] would return listings that have "value1" OR "value2" for "trait1".

sort'updatedAt' | 'listPrice'

The field to sort the listings, default 'listPrice'

listingAggModeboolean

True to return aggregated marketplace listings, false to return just Magic Eden listings.

sort_direction'asc' | 'desc'

The direction returned elements should be sorted in, default 'asc'

paymentMintsstring[]

Filter listings by the payment mint address that the seller expects. Default to filter for listings that only accept native SOL. Use "ALL" to show all listings.

Response

success response

pricenumber double required
tokenAddressstring required
pdaAddressstring required
auctionHousestring required
tokenMintstring required
sellerstring required
sellerReferralstring
tokenSizenumber double required
expirynumber double required
listingSource'M2' | 'MMM' | 'TENSOR_LISTING' | 'TENSOR_CNFT_LISTING' | 'TENSOR_MARKETPLACE_LISTING' | 'TENSOR_AMM' | 'TENSOR_AMM_V2' | 'HADESWAP_AMM' | 'M3' required