Skip to content

Instantly share code, notes, and snippets.

@nftkitten

nftkitten/MagicEdenApi.md

Last active March 27, 2024 16:15
Show Gist options
  • Save nftkitten/85023ef77aacd9842bedbb05a9301398 to your computer and use it in GitHub Desktop.
Save nftkitten/85023ef77aacd9842bedbb05a9301398 to your computer and use it in GitHub Desktop.
Download ZIP
magiceden.io API
Raw
MagicEdenApi.md

MagicEden.io Public API

https://api.magiceden.dev/

MagicEden Smart Contract v1

MagicEden Smart Contract v2

MagicEden.io RPC

(I got most of the endpoints from the PieterSpruijt in Solmate discord channel)

JSON RPC Specification

MongoDB Aggregation Operators

Tested operators

Get Listed NFTs By Query

URL : https://api-mainnet.magiceden.dev/rpc/getListedNFTsByQuery

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
nowait true/false
q MongoDB Aggregation Operators

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getListedNFTsByQuery?q=%7B%22%24match%22%3A%7B%22collectionSymbol%22%3A%22cops_game%22%7D%2C%22%24sort%22%3A%7B%22createdAt%22%3A-1%7D%2C%22%24skip%22%3A0%2C%22%24limit%22%3A20%7D", {
    "credentials": "include",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
        "Accept-Language": "en-GB,en;q=0.5",
        "Upgrade-Insecure-Requests": "1",
        "Sec-Fetch-Dest": "document",
        "Sec-Fetch-Mode": "navigate",
        "Sec-Fetch-Site": "cross-site",
        "Sec-Fetch-User": "?1",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "symbol": "astrals",
    "categories": [
      "pfps",
      "games"
    ],
    "createdAt": "2022-03-10T00:15:57.032Z",
    "derivativeDetails": {
      "originName": "",
      "originLink": ""
    },
    "description": "10,000 unique 3d avatars, 200 traits, 16 races, 3500 PX renders with masterfully crafted lore. Astrals is a community-driven project with aspirations of galactic proportions featuring the incredible character design art of Damien Guimoneau. Each Astral is your gateway to our Galaxy DAO and to stake to mine $GLXY - our governance token. Our goal as a community will be to bridge the gap between Solana and the Universe.",
    "discord": "https://www.discord.gg/astralsnft",
    "enabledAttributesFilters": true,
    "image": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/astrals_pfp_1649437133503.png",
    "isDerivative": false,
    "name": "ASTRALS",
    "totalItems": 10000,
    "twitter": "https://www.twitter.com/Astrals_NFT",
    "website": "https://astralsnft.io/",
    "updatedAt": "2022-04-09T04:23:35.286Z",
    "watchlistCount": 1181,
    "isDraft": false,
    "nftImageType": "",
    "onChainCollectionAddress": "",
    "rarity": {
      "showHowrare": true,
      "showMoonrank": true
    },
    "hasAllItems": false
  }
]

Get Activities By Query

URL : https://api-mainnet.magiceden.dev/rpc/getActivitiesByQuery

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
nowait true/false
q MongoDB Aggregation Operators

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getActivitiesByQuery?q=%7B%22%24match%22%3A%7B%22%24or%22%3A%5B%7B%22seller_address%22%3A%224cnM34f2HNAeKPy71pRvPA3gFDMJZKCDH1aYJEKVk19e%22%7D%2C%7B%22buyer_address%22%3A%224cnM34f2HNAeKPy71pRvPA3gFDMJZKCDH1aYJEKVk19e%22%7D%5D%7D%2C%22%24sort%22%3A%7B%22blockTime%22%3A-1%7D%2C%22%24skip%22%3A0%7D", {
    "credentials": "include",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
        "Accept-Language": "en-GB,en;q=0.5",
        "Upgrade-Insecure-Requests": "1",
        "Sec-Fetch-Dest": "document",
        "Sec-Fetch-Mode": "navigate",
        "Sec-Fetch-Site": "cross-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "symbol": "astrals",
    "categories": [
      "pfps",
      "games"
    ],
    "createdAt": "2022-03-10T00:15:57.032Z",
    "derivativeDetails": {
      "originName": "",
      "originLink": ""
    },
    "description": "10,000 unique 3d avatars, 200 traits, 16 races, 3500 PX renders with masterfully crafted lore. Astrals is a community-driven project with aspirations of galactic proportions featuring the incredible character design art of Damien Guimoneau. Each Astral is your gateway to our Galaxy DAO and to stake to mine $GLXY - our governance token. Our goal as a community will be to bridge the gap between Solana and the Universe.",
    "discord": "https://www.discord.gg/astralsnft",
    "enabledAttributesFilters": true,
    "image": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/astrals_pfp_1649437133503.png",
    "isDerivative": false,
    "name": "ASTRALS",
    "totalItems": 10000,
    "twitter": "https://www.twitter.com/Astrals_NFT",
    "website": "https://astralsnft.io/",
    "updatedAt": "2022-04-09T04:23:35.286Z",
    "watchlistCount": 1181,
    "isDraft": false,
    "nftImageType": "",
    "onChainCollectionAddress": "",
    "rarity": {
      "showHowrare": true,
      "showMoonrank": true
    },
    "hasAllItems": false
  }
]

Get Collections With Symbols

URL : https://api-mainnet.magiceden.dev/rpc/getCollectionsWithSymbols

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
nowait true/false
edge_cache true/false
symbols ["collection symbol"]

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getCollectionsWithSymbols?symbols=%5B%22solana_monkey_business%22%5D&edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "symbol": "astrals",
    "categories": [
      "pfps",
      "games"
    ],
    "createdAt": "2022-03-10T00:15:57.032Z",
    "derivativeDetails": {
      "originName": "",
      "originLink": ""
    },
    "description": "10,000 unique 3d avatars, 200 traits, 16 races, 3500 PX renders with masterfully crafted lore. Astrals is a community-driven project with aspirations of galactic proportions featuring the incredible character design art of Damien Guimoneau. Each Astral is your gateway to our Galaxy DAO and to stake to mine $GLXY - our governance token. Our goal as a community will be to bridge the gap between Solana and the Universe.",
    "discord": "https://www.discord.gg/astralsnft",
    "enabledAttributesFilters": true,
    "image": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/astrals_pfp_1649437133503.png",
    "isDerivative": false,
    "name": "ASTRALS",
    "totalItems": 10000,
    "twitter": "https://www.twitter.com/Astrals_NFT",
    "website": "https://astralsnft.io/",
    "updatedAt": "2022-04-09T04:23:35.286Z",
    "watchlistCount": 1181,
    "isDraft": false,
    "nftImageType": "",
    "onChainCollectionAddress": "",
    "rarity": {
      "showHowrare": true,
      "showMoonrank": true
    },
    "hasAllItems": false
  }
]

Get Biddings By Query

URL : https://api-mainnet.magiceden.dev/rpc/getBiddingsByQuery

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
nowait true/false
q MongoDB Aggregation Operators

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getBiddingsByQuery?q={%22%24match%22%3A{%22escrowPubkey%22%3A%22GfhyX9SCkqN5YfQSHvczMxhAFbECiYKHCeHHjL2LbbY5%22}%2C%22%24sort%22%3A{%22createdAt%22%3A-1}}", {
    "credentials": "include",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
        "Accept-Language": "en-GB,en;q=0.5",
        "Upgrade-Insecure-Requests": "1",
        "Sec-Fetch-Dest": "document",
        "Sec-Fetch-Mode": "navigate",
        "Sec-Fetch-Site": "none",
        "Sec-Fetch-User": "?1",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[]

Get NFT By Mint Address

URL : https://api-mainnet.magiceden.dev/rpc/getNFTByMintAddress

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
nowait true/false
q MongoDB Aggregation Operators

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getNFTByMintAddress/FAFt1f1ZV26jYJ4MrshkMfMuy9aJoXMasRfK97eijX4C", {
    "credentials": "include",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
        "Accept-Language": "en-GB,en;q=0.5",
        "Upgrade-Insecure-Requests": "1",
        "Sec-Fetch-Dest": "document",
        "Sec-Fetch-Mode": "navigate",
        "Sec-Fetch-Site": "cross-site",
        "Sec-Fetch-User": "?1",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
 "results": {
  "id": "7mm29BxEdXLptr7XNDDVZbh1E4w13qE25xgwxVw5wZBW",
  "price": 0,
  "owner": "Axc2owCWv1cExF6CcDt52J2eGVnkv3DgiZWxSuXoomDk",
  "img": "https://www.arweave.net/tcdhTpZT_LghNn3f2VUI32w0MfmOGj3yQsuvIoaqHUk?ext=PNG",
  "title": "Girl In The Blue Hat",
  "content": "Girl In The Blue Hat  Sharon Tatem 1992 South Beach Collection Oil on Panel. South Beach may have been  falling to pieces, but all I saw was the most beautiful architecture I had ever seen.  I could not get enough.  So I brought the visions home and painted the color hat South Beach Art Deco Series.  I honestly do not remember the order but all 4 will be in this collection. \n\nBuyer is purchasing a high resolution clean image and the value is that I will be posting all my 600+ fine art paintings.  I am the hardest working fine artist and will not give up until all my paintings are NFT's \n\nEnjoy!\nSincerely \nSharon Tatem\n\nThe purchaser will receive the high resolution image clean from all watermarks.  The image is printable.\nAs a Fine Artist I will be dropping new NFTs on a Daily from the very large collection of fine art I have created over 35 years.  Please enjoy the NFT's and feel free to comment to me.\n",
  "propertyCategory": "image",
  "creators": [
   {
    "address": "FwUR3LNN9H4MHrJYxCnxeT4yfFfvBUjBPoHvR3SojaQr",
    "verified": 1,
    "share": 100
   }
  ],
  "sellerFeeBasisPoints": 2000,
  "mintAddress": "FAFt1f1ZV26jYJ4MrshkMfMuy9aJoXMasRfK97eijX4C",
  "attributes": [
   {
    "trait_type": "South Beach",
    "value": "Art"
   },
   {
    "trait_type": "Sharon Tatem ",
    "value": "South Beach Artist"
   }
  ],
  "properties": {
   "files": [
    {
     "uri": "https://www.arweave.net/KT-FEBIXNlZl_RGGzPlZvQNf6hBnwBUkWsN5WcfnFgE?ext=PNG",
     "type": "image/png"
    }
   ],
   "category": "image",
   "creators": [
    {
     "address": "FwUR3LNN9H4MHrJYxCnxeT4yfFfvBUjBPoHvR3SojaQr",
     "verified": true,
     "share": 100
    }
   ]
  },
  "supply": 1,
  "updateAuthority": "FwUR3LNN9H4MHrJYxCnxeT4yfFfvBUjBPoHvR3SojaQr",
  "primarySaleHappened": 0,
  "onChainCollection": {},
  "tokenDelegateValid": false
 }
}

Get Collection Escrow Stats

URL : https://api-mainnet.magiceden.dev/rpc/getCollectionEscrowStats/:symbol

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
:symbol collection symbol

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getCollectionEscrowStats/magicticket", {
    "credentials": "include",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
        "Accept-Language": "en-GB,en;q=0.5",
        "Upgrade-Insecure-Requests": "1",
        "Sec-Fetch-Dest": "document",
        "Sec-Fetch-Mode": "navigate",
        "Sec-Fetch-Site": "none",
        "Sec-Fetch-User": "?1",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
 "results": {
  "symbol": "magicticket",
  "enabledAttributesFilters": true,
  "availableAttributes": [
   {
    "count": 1026,
    "floor": 179000000,
    "attribute": {
     "trait_type": "Level",
     "value": 1
    }
   },
   {
    "count": 282,
    "floor": 468000000,
    "attribute": {
     "trait_type": "Level",
     "value": 2
    }
   },
   {
    "count": 194,
    "floor": 1400000000,
    "attribute": {
     "trait_type": "Level",
     "value": 3
    }
   },
   {
    "count": 1026,
    "floor": 179000000,
    "attribute": {
     "trait_type": "Tier",
     "value": "Normie"
    }
   },
   {
    "count": 282,
    "floor": 468000000,
    "attribute": {
     "trait_type": "Tier",
     "value": "Degen"
    }
   },
   {
    "count": 194,
    "floor": 1400000000,
    "attribute": {
     "trait_type": "Tier",
     "value": "OG"
    }
   }
  ],
  "floorPrice": 179000000,
  "listedCount": 1634,
  "listedTotalValue": 32090254081780,
  "avgPrice24hr": 376218800,
  "volume24hr": 37621880000,
  "volumeAll": 31739450989608
 }
}

Get NFT By Owner

URL : https://api-mainnet.magiceden.dev/rpc/getNFTsByOwner/:token_mint

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
:token_mint mint address

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getNFTsByOwner/F6ZVwoX7Z1Ec81AJFGHyTciJUCumnkPetRWA6SHqpMko", {
    "credentials": "include",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
        "Accept-Language": "en-GB,en;q=0.5",
        "Upgrade-Insecure-Requests": "1",
        "Sec-Fetch-Dest": "document",
        "Sec-Fetch-Mode": "navigate",
        "Sec-Fetch-Site": "none",
        "Sec-Fetch-User": "?1",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
 "results": [
  {
   "id": "3WLSu9sLFwajYEqrWXWLQoaf6Q5WhCAQm8dDjVdQyRg9",
   "price": 0,
   "owner": "F6ZVwoX7Z1Ec81AJFGHyTciJUCumnkPetRWA6SHqpMko",
   "collectionName": "solana_bored_folks",
   "collectionTitle": "Solana Bored Folks",
   "img": "https://www.arweave.net/wUbfDT80cGERTAqLf3AEof0HTrCfUA3ZVM42Ol1e6j4?ext=png",
   "title": "SOLANA BORED FOLKS #154",
   "content": "333 UNIQUE BORED FOLKS",
   "propertyCategory": "image",
   "creators": [
    {
     "address": "MTrrWxZh4bGsE2MESFnNiypp7HZrn8xRyBWd3So9z7L",
     "verified": 1,
     "share": 0
    },
    {
     "address": "3qYAf6BCXsao7gCHton8BUmibEZY6dUKxLNJ9juYeHg2",
     "verified": 0,
     "share": 100
    }
   ],
   "sellerFeeBasisPoints": 700,
   "mintAddress": "HneES7wZge7R5QmnLcYYK8oCBPgG9p8wwm77CqdmSqY2",
   "attributes": [
    {
     "trait_type": "BCKGROUND",
     "value": "MUD"
    },
    {
     "trait_type": "BODY",
     "value": "GRAY"
    },
    {
     "trait_type": "EYES",
     "value": "SQUARE GLASSES"
    },
    {
     "trait_type": "FACE",
     "value": "NONE"
    },
    {
     "trait_type": "HAT",
     "value": "PLANETS"
    },
    {
     "trait_type": "PIPE",
     "value": "LONG"
    }
   ],
   "properties": {
    "files": [
     {
      "uri": "https://www.arweave.net/wUbfDT80cGERTAqLf3AEof0HTrCfUA3ZVM42Ol1e6j4?ext=png",
      "type": "image/png"
     }
    ],
    "category": "image",
    "creators": [
     {
      "address": "3qYAf6BCXsao7gCHton8BUmibEZY6dUKxLNJ9juYeHg2",
      "share": 100
     }
    ]
   },
   "supply": 1,
   "updateAuthority": "3qYAf6BCXsao7gCHton8BUmibEZY6dUKxLNJ9juYeHg2",
   "primarySaleHappened": 1,
   "onChainCollection": {},
   "tokenDelegateValid": false
  }
 ]
}

Get NFT Stats By MintAddress

URL : https://api-mainnet.magiceden.dev/rpc/getNFTStatsByMintAddress/:token_mint

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
:token_mint mint address

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getNFTStatsByMintAddress/FpqUMSWghvdJhdVm9DBCTfgQB7S4FqrbGV3v9N7rnz1c", {
    "credentials": "include",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
        "Accept-Language": "en-GB,en;q=0.5",
        "Upgrade-Insecure-Requests": "1",
        "Sec-Fetch-Dest": "document",
        "Sec-Fetch-Mode": "navigate",
        "Sec-Fetch-Site": "cross-site",
        "Sec-Fetch-User": "?1",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
 "results": {
  "_id": "625132a3fa13153687681997",
  "mintAddress": "FpqUMSWghvdJhdVm9DBCTfgQB7S4FqrbGV3v9N7rnz1c",
  "collectionSymbol": "fly",
  "attrs": [
   {
    "trait_type": "Expression",
    "value": "I Wish",
    "valueCount": 88
   },
   {
    "trait_type": "Jacket",
    "value": "Quarter Zip Green",
    "valueCount": 34
   },
   {
    "trait_type": "Hat",
    "value": "Bell Boy Red",
    "valueCount": 34
   },
   {
    "trait_type": "Head",
    "value": "Cracked Mask Green Pink Mustard",
    "valueCount": 59
   },
   {
    "trait_type": "Background",
    "value": "Chalk Board",
    "valueCount": 48
   }
  ],
  "totalMints": 888,
  "rarityA": 16.88212927756654,
  "rankA": 266
 }
}

Get Global Activities By Query

URL : https://api-mainnet.magiceden.dev/rpc/getGlobalActivitiesByQuery

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
nowait true/false
q MongoDB Aggregation Operators

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getGlobalActivitiesByQuery?q={%22$match%22:{%22collection_symbol%22:%22stoned_ape_crew%22},%22$sort%22:{%22blockTime%22:-1,%22createdAt%22:-1},%22$skip%22:0}", {
    "credentials": "include",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
        "Accept-Language": "en-GB,en;q=0.5",
        "Upgrade-Insecure-Requests": "1",
        "Sec-Fetch-Dest": "document",
        "Sec-Fetch-Mode": "navigate",
        "Sec-Fetch-Site": "none",
        "Sec-Fetch-User": "?1",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
 "results": [
  {
   "_id": "625136ba95f92c7e1d6df043",
   "transaction_id": "4hJX8898UEbHVkSABjy2jYcZEVGnhsFKrpVQgxfDhQnB784qTNkttkFncMGBFEZo7FP7F5Rw4FxVLEgwsgeGKkBT",
   "txType": "initializeEscrow",
   "blockTime": 1649489591,
   "buyer_address": null,
   "collection_symbol": "stoned_ape_crew",
   "createdAt": "2022-04-09T07:33:14.776Z",
   "mint": "EAeKJrqnDKH2ghuD7trmYrgiwqhRez7Ft3SDPkiNUdf4",
   "notifiable": true,
   "onChainCollectionAddress": null,
   "parsedList": {
    "TxType": "initializeEscrow",
    "seller_address": "9xvdQiZC2pXfbkmyko9pBYML4xveGrXQwniJJiR8c4Nm",
    "token_address": "EAeKJrqnDKH2ghuD7trmYrgiwqhRez7Ft3SDPkiNUdf4",
    "amount": 200000000000,
    "collection_symbol": "stoned_ape_crew",
    "mint": "EAeKJrqnDKH2ghuD7trmYrgiwqhRez7Ft3SDPkiNUdf4"
   },
   "seller_address": "9xvdQiZC2pXfbkmyko9pBYML4xveGrXQwniJJiR8c4Nm",
   "slot": 128906507,
   "source": "magiceden_v2",
   "step": 0,
   "totalSteps": 1,
   "txName": "sell",
   "mintObject": {
    "mintAddress": "EAeKJrqnDKH2ghuD7trmYrgiwqhRez7Ft3SDPkiNUdf4",
    "img": "https://www.arweave.net/DQqcV-2Btk_l00Nzdoa77FEHy1Efc_sdtZqwFCRh-yg?ext=png",
    "supply": 1,
    "title": "Stoned Ape #3333",
    "content": "4200 Stoned Apes Form The Genesis Collection In The Crew With 4 Roles, Allowing Staking For Daily Rewards Of Our Utility Token $PUFF, An NFT Evolution Process With Token Burning Mechanics And More Dope Real World Utility. More Than Just Your Typical PFP Project.",
    "attributes": [
     {
      "trait_type": "Role",
      "value": "Farmer"
     },
     {
      "trait_type": "Background",
      "value": "Light Solana Gradient"
     },
     {
      "trait_type": "Eyes",
      "value": "Red"
     },
     {
      "trait_type": "Eyes Items",
      "value": "Big Solana Glasses"
     },
     {
      "trait_type": "Form",
      "value": "Leopard"
     },
     {
      "trait_type": "Hats",
      "value": "Grey Headphones"
     },
     {
      "trait_type": "Mouth",
      "value": "Sad"
     },
     {
      "trait_type": "Hair",
      "value": "Long Wavy Leo"
     },
     {
      "trait_type": "Hand with Items",
      "value": "Watering Can Leo Fur"
     },
     {
      "trait_type": "Random Things",
      "value": "Cannabis Plant"
     },
     {
      "trait_type": "Upper Part",
      "value": "SAC Shirt"
     },
     {
      "trait_type": "Genesis Role?",
      "value": "Yes"
     }
    ],
    "updateAuthority": "PUFFgnKKhQ23vp8uSPwdzrUhEr7WpLmjM85NB1FQgpb",
    "primarySaleHappened": 1,
    "sellerFeeBasisPoints": 742,
    "creators": [
     {
      "address": "7RCBr3ZQ8yhY4jHpFFo3Kmh7MnaCPi1bFuUgXUB9WURf",
      "verified": 1,
      "share": 0
     },
     {
      "address": "PUFFgnKKhQ23vp8uSPwdzrUhEr7WpLmjM85NB1FQgpb",
      "verified": 0,
      "share": 100
     }
    ],
    "propertyCategory": "image",
    "properties": {
     "files": [
      {
       "uri": "https://www.arweave.net/DQqcV-2Btk_l00Nzdoa77FEHy1Efc_sdtZqwFCRh-yg?ext=png",
       "type": "image/png"
      }
     ],
     "category": "image",
     "creators": [
      {
       "address": "PUFFgnKKhQ23vp8uSPwdzrUhEr7WpLmjM85NB1FQgpb",
       "share": 100
      }
     ]
    },
    "onChainName": "Stoned Ape #3333"
   }
  }
 ]
}

MagicEden.io Undocumented API

Featured Carousels

URL : https://api-mainnet.magiceden.dev/featured_carousels

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/featured_carousels?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "_id": "624b8d9fad7bc10011a9363e",
    "description": "We are Solana's #1 marketplace! Check out some of our curated collections below 👇",
    "image": "https://dl.airtable.com/.attachments/af7f9cc33de0f9abc14153c2a0c6ffcf/56460aa1/ETHfrens1.gif",
    "title": "Welcome to Magic Eden!",
    "index": 0,
    "publishedAt": null,
    "removedAt": null,
    "url": ""
  }
]

Featured Collections Carousels

URL : https://api-mainnet.magiceden.dev/featured_collections_carousels

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/featured_collections_carousels?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "_id": "6210cfdf82216400117a2f6c",
    "title": "Launchpad Drops",
    "index": 0,
    "collections": [],
    "type": "upcoming-launches",
    "publishedAt": null,
    "removedAt": null
  }
]

Popular Collections

URL : https://api-mainnet.magiceden.dev/popular_collections

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false
more true/false
timeRang 1d/7d/30d

Request examples:

await fetch("https://api-mainnet.magiceden.dev/popular_collections?timeRange=1d&edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
  "collections": [
    {
      "_id": "61e20147fd5137001097cedb",
      "symbol": "degods",
      "candyMachineIds": [
        "8RMqBV79p8sb51nMaKMWR94XKjUvD2kuUSAkpEJTmxyx"
      ],
      "name": "DeGods",
      "image": "https://i.imgur.com/fO3tI1t.png",
      "categories": [
        "pfps",
        "art"
      ],
      "description": "A collection of degenerates, punks, and misfits. Gods of the metaverse & masters of our own universe. DeGods can be converted to DeadGods with DUST.",
      "createdAt": "2022-01-14T23:03:33.857Z",
      "enabledAttributesFilters": true,
      "isDraft": false,
      "website": "https://degods.com/",
      "twitter": "https://twitter.com/degodsnft",
      "discord": "https://discord.com/invite/dedao",
      "derivativeDetails": {
        "originLink": "",
        "originName": ""
      },
      "isDerivative": false,
      "nftImageType": "",
      "rarity": {
        "showHowrare": false,
        "showMoonrank": false
      },
      "updatedAt": "2022-04-09T04:32:02.174Z",
      "watchlistCount": 1294,
      "onChainCollectionAddress": ""
    }
  ]
}

Drops

URL : https://api-mainnet.magiceden.dev/drops

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false
top 10/?

Request examples:

await fetch("https://api-mainnet.magiceden.dev/drops?edge_cache=true&top=10", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "name": "Decimus Dynamics",
    "symbol": "decimusdynamics",
    "description": "It is the year 3081. The Earth is now a desolate landscape uninhabitable for the human race. A group of aliens, the Zeons invaded the Earth and decimated the population of Earth with chemicals and poisonous gasses. These chemicals have an adverse effect on the Earth's raccoon population and enhance their mental capacities to levels beyond former human intelligence. These now mentally enhanced raccoons have headed underground and started building a new civilization. They create 4000 robots they can pilot, first to help with digging and moving things too heavy for their small bodies, but after years underground there is unrest between different factions of the raccoon civilization.",
    "assets": {
      "profileImage": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/decimusdynamics_pfp_1648575083383.png"
    },
    "derivative": null,
    "links": {
      "twitter": "https://twitter.com/DecimusDynamic",
      "discord": "https://discord.gg/Decimus"
    },
    "launchDate": "2022-04-09T17:00:00.000Z",
    "isMeLaunchPad": false,
    "upvote": 428
  }
]

Auctions

URL : https://api-mainnet.magiceden.dev/auctions

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/auctions?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "_id": "61f973d054b68f00116723c9",
    "type": "english",
    "slug": "zodiac_snake",
    "configId": "JDZ1Zokxa2K3WDkNE82FKHqHmJpq23s2Y3Z4DCD5p9ZT",
    "name": "Zodiac Collection: Snake",
    "description": "Thousands of years ago, the Zodiac Calendar was created as a way to measure time. The first twelve animals to cross a fast flowing river would have a year named after them.  Inspired by eastern calligraphy, Snake is one of twelve unique pieces from my Zodiac Collection, bringing ancient legend to the forefront of blockchain technology.   Celebrated by a quarter of the world, the Lunar New Year is a time of giving, family, prosperity, food and among many other things, spending time together.  Wishing you a prosperous Lunar New Year.  xoxo  Ms Zenith",
    "creatorName": "Ms Zenith",
    "websiteLink": "https://mszenith.my.canva.site/",
    "discordLink": "",
    "twitterLink": "https://twitter.com/MsZenithArt",
    "imageWidth": 1000,
    "imageHeight": 1000,
    "published": true,
    "featured": false,
    "collection": "MSZ",
    "config": {
      "bump": 254,
      "authority": "HYPJr6AErcnQ4kJj8UVojReNJnY3jH6KpbQFfBL2HDxM",
      "minBid": 1000000000,
      "minBidIncrement": 500000000,
      "startDate": "2022-02-02T17:00:00.000Z",
      "endDate": "2022-02-04T02:10:00.000Z",
      "tokenAccount": "4wWoQ7JEUfZubXQY55g5SsrvuobZDTVjxXZ1yRksyNnS",
      "tokenMint": "EuS4tqpKQu3detrLrZA8ZDznPjnQ2ZVdrRAYJihtpkFF",
      "highestBid": "FmtCEcYYVVVhHqTXLbAefcE7UKFDDuzpRLoN5i7EuuKc",
      "highestBidAmount": 2500000000,
      "highestBidder": "6JzXsCwJKiGH9o29HCveDyLD7TyioY3qAmTQthSdEvfP",
      "acceptingBids": true,
      "auctionClosed": true,
      "timeExtension": 600,
      "timeExtensionThreshold": 600
    },
    "updatedAt": "2022-02-19T20:48:00.178Z"
  }
]

Highest Sold NFTs

URL : https://api-mainnet.magiceden.dev/highest_sold_nfts

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false
more true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/highest_sold_nfts?more=true&edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
  "result": [
    {
      "nft": {
        "id": "FwyM7d7nXwo4qTwWZffDdvx4VSgQpsrEA6fuKWHJ9Vpw",
        "price": 0,
        "owner": "4ZGWPgjMNGHMrUJqyLFzEk92XDJwUFvyaAWbSm17ueHC",
        "collectionName": "portals",
        "collectionTitle": "Portals",
        "img": "https://arweave.net/Kpi85acYI9i9HZVnnhRuO3Vi_1XDpshHx80eGA3mhD4?ext=jpg",
        "title": "Portals | Onyx #256",
        "content": "This expansive space strikes the perfect balance of splendor and functionality.",
        "animationURL": "https://arweave.net/SuRJK0fVU2Mg1L0qIJggeNQsWhHz7HUOboS9-gGhPAg?ext=mp4",
        "propertyCategory": "video",
        "creators": [
          {
            "address": "5grvMeoBqv5ZdHq9JMy5RrxLPNAt1nzc9cpqYWFUwizz",
            "verified": 1,
            "share": 0
          },
          {
            "address": "EmdsWm9dJ1d6BgQzHDcMJkDvB5SVvpfrAtpiGMVW1gxx",
            "verified": 1,
            "share": 0
          },
          {
            "address": "GdtkQajEADGbfSUEBS5zctYrhemXYQkqnrMiGY7n7vAw",
            "verified": 0,
            "share": 100
          }
        ],
        "sellerFeeBasisPoints": 500,
        "mintAddress": "3KGGHD48w6JtePqfLhtiH2N2yBxm9yTGJpWXRN2EYk5o",
        "attributes": [
          {
            "trait_type": "Unit Type",
            "value": "Onyx"
          },
          {
            "trait_type": "Unit Number",
            "value": 256
          }
        ],
        "properties": {
          "files": [
            {
              "uri": "https://arweave.net/Kpi85acYI9i9HZVnnhRuO3Vi_1XDpshHx80eGA3mhD4?ext=jpg",
              "type": "image/jpeg"
            },
            {
              "uri": "https://arweave.net/SuRJK0fVU2Mg1L0qIJggeNQsWhHz7HUOboS9-gGhPAg?ext=mp4",
              "type": "video/mp4"
            }
          ],
          "category": "video",
          "creators": [
            {
              "address": "EmdsWm9dJ1d6BgQzHDcMJkDvB5SVvpfrAtpiGMVW1gxx",
              "share": 0
            },
            {
              "address": "GdtkQajEADGbfSUEBS5zctYrhemXYQkqnrMiGY7n7vAw",
              "share": 100
            }
          ]
        },
        "supply": 1,
        "updateAuthority": "EmdsWm9dJ1d6BgQzHDcMJkDvB5SVvpfrAtpiGMVW1gxx",
        "primarySaleHappened": 1,
        "onChainCollection": {},
        "tokenDelegateValid": false
      },
      "totalAmount": 333000000000
    }
  ]
}

New Collections

URL : https://api-mainnet.magiceden.dev/new_collections

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false
more true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/new_collections?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
  "collections": [
    {
      "symbol": "zuixmetadream",
      "categories": [
        "art",
        "virtual_worlds"
      ],
      "createdAt": "2022-04-09T04:46:20.894Z",
      "derivativeDetails": {
        "originName": "",
        "originLink": ""
      },
      "description": "1/1 Uniques NFT's ✔ is an attempt to recreate the fantastical dreamworlds we all experience every night through the lens of AI. By combining the power of language interpretation and visual perception using a highly customized VQGAN+CLIP pipeline, the pieces in this collection each evoke their own unique dreamworld that should be experienced rather than understood",
      "discord": "https://www.discord.gg/PM7t6q7N",
      "enabledAttributesFilters": true,
      "image": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/zuixmetadream_pfp_1649473565172.jpeg",
      "isDerivative": false,
      "name": "Zuix METADREAM ART",
      "totalItems": 13,
      "twitter": "https://www.twitter.com/Zuix_Arts"
    }
  ]
}

Volumes

URL : https://api-mainnet.magiceden.dev/volumes

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/volumes?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
  "total": 9583951.24066862,
  "last24Hrs": 65142.248224952,
  "last7Days": 511836.551518149,
  "last30Days": 2157121.574039251
}

Global Warning

URL : https://api-mainnet.magiceden.dev/globalWarning

Method : GET

Public : NO

Auth required : NO

Request examples:

await fetch("https://api-mainnet.magiceden.dev/globalWarning", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
  "_id": "62487d10bea360023ded4888",
  "active": false,
  "dismissable": false,
  "tooltipText": "",
  "warningText": "",
  "tpsThreshold": 1800,
  "severity": "Warning"
}

All Collections With Escrow Data

URL : https://api-mainnet.magiceden.dev/all_collections_with_escrow_data

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/all_collections_with_escrow_data?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
  "collections": [
    {
      "symbol": "komodo_lizardz",
      "categories": [
        "pfps",
        "art"
      ],
      "createdAt": "2022-04-09T04:31:28.426Z",
      "derivativeDetails": {
        "originName": "",
        "originLink": ""
      },
      "description": "455⠀Komodo⠀Lizardz⠀in⠀Solana.⠀Stake2Earn⠀$ZARD,⠀Breed⠀and⠀Much⠀More.",
      "discord": "https://www.discord.gg/fxQ9X9Yeng",
      "enabledAttributesFilters": true,
      "image": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/komodo_lizardz_pfp_1649431771365.jpeg",
      "isDerivative": false,
      "name": "Komodo Lizardz",
      "totalItems": 455,
      "twitter": "https://www.twitter.com/KomodoLizardz",
      "volumeAll": 0
    }
  ]
}

All Organizations

URL : https://api-mainnet.magiceden.dev/all_organizations

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/all_organizations?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "name": "Moshiheads",
    "symbol": "moshiheads",
    "description": "3,000 Moshiheads sworn to protect the Solana space from evil sludge monsters.",
    "assets": {
      "bannerImage": "https://bafkreibz4ccegtopq7l5okdle5an2iwu75ysza363hwkeh4xb7ea5se6qm.ipfs.nftstorage.link/"
    },
    "links": {
      "twitter": "https://twitter.com/Moshiheads",
      "discord": "https://discord.gg/moshiheads",
      "website": "http://moshiheads.com/"
    }
  }
]

Launchpad Collections

URL : https://api-mainnet.magiceden.dev/launchpad_collections

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/launchpad_collections?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "_id": "6157eb8106fcd7a36e3664ec",
    "symbol": "zoolana",
    "name": "Zoolana",
    "description": "Zoolana is a play-and-earn social strategy game being built for mobile. Players will collect resources, control units, and rally with their tribe to take on opponents in the Zoolana valley.\nThe Teaser Edition is Zoolana's historic first mint and illustrated by industry leading concept artists. Holders will have a chance to win our Alpha Edition NFT dropping in early November which is the VIP pass for Zoolana. People who hold Alpha Edition can expect airdrops of an in-game character + monthly equipment NFTs + other freebies and perks!",
    "published": true,
    "mint": {
      "candyMachineId": "3iNYkwM1q3Fgz4NJHy2i5A12Tn5nXZD2tHrjpiPWFA7z",
      "config": "JDwQWA9rngVxmUqLmVSF564iHZKYgjQtzrUHNaAyFSaQ",
      "treasury": "6QNWBWhxBfEMkwBUTeTsGyxohBicA3k6EGWr6X8KmzUL"
    },
    "image": "https://i.imgur.com/L2PGzor.gif",
    "launchDate": "2021-10-15T19:00:00.000Z",
    "price": 0.00001,
    "size": 2550,
    "updatedAt": "2022-01-30T06:00:47.039Z",
    "createdAt": "2022-01-26T06:13:53.357Z",
    "__v": 0,
    "featured": false
  }
]

New Games

URL : https://api-mainnet.magiceden.dev/new_games

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/new_games?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "symbol": "hockey_heroes",
    "candyMachineIds": [],
    "name": "Hockey Heroes",
    "image": "https://dl.airtable.com/.attachmentThumbnails/f6aefbc5e2334b7e388027960a9ef5a5/a0816e97",
    "categories": [
      "sports"
    ],
    "description": "The greatest hockey NFT collection on #Solana. 3333 packs hide 111 all-star players claimable as rare physical collectibles.",
    "createdAt": "2022-02-15T01:35:51.837Z",
    "enabledAttributesFilters": true,
    "isDraft": false,
    "website": "https://t.co/pcsS7KvFI2",
    "twitter": "https://twitter.com/hockeyheroes_io",
    "discord": "https://t.co/qnwwhIomeS",
    "derivativeDetails": {
      "originLink": "",
      "originName": ""
    },
    "isDerivative": false,
    "nftImageType": "",
    "flagMessage": "",
    "isFlagged": false,
    "updatedAt": "2022-04-08T16:08:38.394Z",
    "watchlistCount": 10
  }
]

Popular Games

URL : https://api-mainnet.magiceden.dev/popular_games

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false

Request examples:

await fetch("https://api-mainnet.magiceden.dev/popular_games?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

[
  {
    "symbol": "yaku_corp",
    "candyMachineIds": [],
    "name": "Yaku Engineering ONI-S01",
    "image": "https://bafybeidykoipw77pm7ivk52vmbduvxzx6tj4tyrgjc6fskcon5usb45n2m.ipfs.nftstorage.link/",
    "categories": [
      "games",
      "virtual_worlds"
    ],
    "description": "YAKU Engineering ONI-S01 is the first playable customizable motorcycle in the Yakuverse - Race your way in search of $YAKU on these Seisui technology powered motorcycles.",
    "createdAt": "2022-02-15T19:09:33.442Z",
    "enabledAttributesFilters": true,
    "isDraft": false,
    "website": "http://yakushima.io/",
    "twitter": "https://twitter.com/yakucorp?s=21",
    "discord": "https://discord.gg/MH6u9cEcZz",
    "derivativeDetails": {
      "originLink": "",
      "originName": ""
    },
    "isDerivative": false,
    "nftImageType": "",
    "rarity": {
      "showHowrare": false,
      "showMoonrank": false
    },
    "updatedAt": "2022-04-09T05:21:34.154Z",
    "watchlistCount": 516,
    "onChainCollectionAddress": ""
  }
]

Get Aggregated Collection Metrics

URL : https://api-mainnet.magiceden.dev/getAggregatedCollectionMetrics

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false
timeframe 1d/7d/30d

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getAggregatedCollectionMetrics?timeframe=1d&edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
  "results": [
    {
      "_id": "61c8187186e5dc0f9ac46c69",
      "symbol": "floofers",
      "name": "Floofers",
      "date": "2022-04-09",
      "totalItems": 0,
      "image": "https://dl.airtable.com/.attachmentThumbnails/1bb43aa8410073b5a44c2514eebc7be8/a2229815",
      "txVolume": {
        "valueAT": 16.79299,
        "value1d": 0,
        "prev1d": 0,
        "delta1d": 0,
        "value1dME": 0
      },
      "avgPrice": {
        "valueAT": 0.25443924242424243,
        "value1d": 0.08,
        "prev1d": 0.08,
        "delta1d": 1
      },
      "floorPrice": {
        "value1d": 0.09,
        "prev1d": 0.09,
        "delta1d": 1
      },
      "txVolumeME": {
        "valueAT": 16.61299,
        "value1d": 0,
        "prev1d": 0,
        "delta1d": 0
      }
    }
  ]
}

Get Aggregated Marketplace Metrics

URL : https://api-mainnet.magiceden.dev/getAggregatedMarketplaceMetrics

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false
timeframe 1d/7d/30d

Request examples:

await fetch("https://api-mainnet.magiceden.dev/rpc/getAggregatedMarketplaceMetrics?edge_cache=true", {
    "credentials": "omit",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "application/json, text/plain, */*",
        "Accept-Language": "en-GB,en;q=0.5",
        "Sec-Fetch-Dest": "empty",
        "Sec-Fetch-Mode": "cors",
        "Sec-Fetch-Site": "same-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
  "results": [
    {
      "name": "Magic Eden",
      "txVolume": {
        "value1d": 63867.841089802,
        "value7d": 511078.290558699,
        "value30d": 2155436.94161858
      },
      "txCount": {
        "value1d": 21850,
        "value7d": 192032,
        "value30d": 819760
      },
      "activeWallets": {
        "value1d": 20262,
        "value7d": 79667,
        "value30d": 182092
      }
    }
  ]
}

Check User Watch Collection

URL : https://api-mainnet.magiceden.dev/collection_watchlists/action/checkUserWatchCollection/:symbol

Method : GET

Public : NO

Auth required : NO

Query Parameters:

Name Value
edge_cache true/false
:symbol collection symbol

Request examples:

await fetch("https://api-mainnet.magiceden.dev/collection_watchlists/action/checkUserWatchCollection/degods?walletAddress=9gHuet9vB9o9La7P8Tbse9XdVUatZ5xeKvL9FthiE2cG", {
    "credentials": "include",
    "headers": {
        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:99.0) Gecko/20100101 Firefox/99.0",
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
        "Accept-Language": "en-GB,en;q=0.5",
        "Upgrade-Insecure-Requests": "1",
        "Sec-Fetch-Dest": "document",
        "Sec-Fetch-Mode": "navigate",
        "Sec-Fetch-Site": "cross-site",
        "Pragma": "no-cache",
        "Cache-Control": "no-cache"
    },
    "referrer": "https://magiceden.io/",
    "method": "GET",
    "mode": "cors"
});

Success Response:

Code : 200 OK

Content Examples:

{
    "watching": false
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment