Magic Eden marketplace API

Get information about Magic Eden's marketplace!

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/magic-eden-marketplace-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

magic-eden-marketplace-api-openapi.yml Raw ↑
openapi: 3.0.1
info:
  title: Magic Eden EVM Activity marketplace API
  description: Aggregated Magic Eden EVM API (v4) for Ethereum and L2 chains (Polygon, Base, ApeChain, Arbitrum, Berachain, BSC, SEI, Abstract). Covers collections, assets, bids, asks, listings, buy/sell, and bulk transfer instructions.
  version: v4
  termsOfService: https://magiceden.io/terms-of-service.pdf
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://api-mainnet.magiceden.dev/v4/evm-public
tags:
- name: marketplace
  description: Get information about Magic Eden's marketplace!
paths:
  /marketplace/popular_collections:
    get:
      deprecated: false
      summary: Get the top popular collections for a time range
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ICollectionV2'
      parameters:
      - name: timeRange
        in: query
        description: The time range to return popular collections for. Default 1d.
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/PopularCollectionsTimeRanges'
      tags:
      - marketplace
components:
  schemas:
    IFloorPriceInfo:
      properties:
        floorPrice:
          type: number
          format: double
        floorListedNftType:
          $ref: '#/components/schemas/ListedNftType'
      required:
      - floorPrice
      - floorListedNftType
      type: object
      additionalProperties: false
    PopularCollectionsTimeRanges:
      type: string
      enum:
      - 1h
      - 1d
      - 7d
      - 30d
    ListedNftType:
      type: string
      enum:
      - M2
      - MMM
      - TENSOR_LISTING
      - TENSOR_CNFT_LISTING
      - TENSOR_MARKETPLACE_LISTING
      - TENSOR_AMM
      - TENSOR_AMM_V2
      - HADESWAP_AMM
      - M3
    ICollectionV2:
      properties:
        symbol:
          type: string
        name:
          type: string
        description:
          type: string
        image:
          type: string
        twitter:
          type: string
        discord:
          type: string
        website:
          type: string
        isFlagged:
          type: boolean
        flagMessage:
          type: string
        categories:
          items:
            type: string
            nullable: true
          type: array
        floorPrice:
          type: number
          format: double
        listedCount:
          type: number
          format: double
        avgPrice24hr:
          type: number
          format: double
        volumeAll:
          type: number
          format: double
        isBadged:
          type: boolean
        hasCNFTs:
          type: boolean
        isOcp:
          type: boolean
        splTokens:
          items:
            type: string
          type: array
        floorPriceWithFee:
          $ref: '#/components/schemas/IFloorPriceInfo'
      required:
      - symbol
      - name
      - description
      - image
      type: object
      additionalProperties: false
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer