Magic Eden · Schema

MagicEdenActivity

A marketplace activity event on Magic Eden (sale, listing, bid, transfer, etc.).

NFTNFT MarketplaceMulti-ChainSolanaBitcoinOrdinalsRunesEthereumPolygonWeb3BlockchainDeFiTrading

Properties

Name	Type	Description
signature	string	On-chain transaction signature.
type	string	Type of marketplace activity.
source	string	Marketplace source of the activity (e.g., magic_eden).
tokenMint	string	Mint address of the NFT involved in the activity.
collection	string	Collection symbol the NFT belongs to.
collectionSymbol	string	Unique collection symbol on Magic Eden.
slot	integer	Solana slot number when the activity occurred.
blockTime	integer	Unix timestamp (seconds) when the activity was confirmed on-chain.
buyer	string	Wallet address of the buyer (for sale and bid events).
seller	string	Wallet address of the seller (for sale and list events).
price	number	Transaction price in SOL or native currency.
currency	object	Currency details if the transaction used a non-native SPL token.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/magiceden/main/json-schema/magiceden-activity.json",
  "title": "MagicEdenActivity",
  "description": "A marketplace activity event on Magic Eden (sale, listing, bid, transfer, etc.).",
  "type": "object",
  "properties": {
    "signature": {
      "type": "string",
      "description": "On-chain transaction signature."
    },
    "type": {
      "type": "string",
      "enum": ["sale", "list", "delist", "bid", "cancelBid", "transfer"],
      "description": "Type of marketplace activity."
    },
    "source": {
      "type": "string",
      "description": "Marketplace source of the activity (e.g., magic_eden)."
    },
    "tokenMint": {
      "type": "string",
      "description": "Mint address of the NFT involved in the activity."
    },
    "collection": {
      "type": "string",
      "description": "Collection symbol the NFT belongs to."
    },
    "collectionSymbol": {
      "type": "string",
      "description": "Unique collection symbol on Magic Eden."
    },
    "slot": {
      "type": "integer",
      "description": "Solana slot number when the activity occurred."
    },
    "blockTime": {
      "type": "integer",
      "description": "Unix timestamp (seconds) when the activity was confirmed on-chain."
    },
    "buyer": {
      "type": "string",
      "description": "Wallet address of the buyer (for sale and bid events)."
    },
    "seller": {
      "type": "string",
      "description": "Wallet address of the seller (for sale and list events)."
    },
    "price": {
      "type": "number",
      "description": "Transaction price in SOL or native currency."
    },
    "currency": {
      "type": "object",
      "description": "Currency details if the transaction used a non-native SPL token.",
      "properties": {
        "symbol": { "type": "string" },
        "address": { "type": "string" },
        "decimals": { "type": "integer" }
      }
    }
  },
  "required": ["signature", "type", "blockTime"]
}