Skip to main content
POST
/
api
/
magiceden
/
collections
/
listings
/magiceden/collections/listings
curl --request POST \
  --url https://api.anysite.io/api/magiceden/collections/listings \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "symbol": "<string>",
  "count": 2,
  "timeout": 300,
  "chain": "solana",
  "sort": "price_asc"
}
'
[
  {
    "mint": "<string>",
    "@type": "MagicedenToken",
    "name": "<string>",
    "image": "<string>",
    "animation_url": "<string>",
    "media_category": "<string>",
    "collection_symbol": "<string>",
    "collection_name": "<string>",
    "owner": "<string>",
    "price": 123,
    "listing_type": "<string>",
    "is_listed": false,
    "listing_updated_at": "<string>",
    "last_sale_price": 123,
    "seller_fee_basis_points": 123,
    "token_standard": 123,
    "supply": 123,
    "is_tradeable": false,
    "is_frozen": false,
    "update_authority": "<string>",
    "escrow_pubkey": "<string>",
    "external_url": "<string>",
    "attributes": [],
    "creators": [],
    "rarity": {
      "@type": "MagicedenRarity",
      "moonrank": 123,
      "howrare": 123,
      "me_instant": 123
    }
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
symbol
string
required

Collection symbol (its human-readable alias, e.g. 'mad_lads')

Minimum string length: 1
Examples:

"mad_lads"

"okay_bears"

count
integer
required

Number of listed tokens to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
chain
enum<string>
default:solana

Blockchain

Available options:
solana
sort
enum<string>
default:price_asc

Order to return listed tokens in

Available options:
price_asc,
price_desc,
rarity_asc,
rarity_desc,
recently_listed

Response

Successful Response

mint
string
required
@type
string
default:MagicedenToken
name
string | null
image
string | null
animation_url
string | null
media_category
string | null
collection_symbol
string | null
collection_name
string | null
owner
string | null
price
number | null
listing_type
string | null
is_listed
boolean
default:false
listing_updated_at
string | null
last_sale_price
number | null
seller_fee_basis_points
integer | null
token_standard
integer | null
supply
integer | null
is_tradeable
boolean
default:false
is_frozen
boolean
default:false
update_authority
string | null
escrow_pubkey
string | null
external_url
string | null
attributes
object[]
creators
object[]
rarity
object