Collection data endpoints for the Magic Eden Solana NFT marketplace. Provides access to collection listings, collection statistics, collection attributes, collection activities, holder statistics, leaderboard rankings by volume, batch listings, popular collections by time range, and launchpad collections. Supports filtering and pagination across all Solana NFT collections indexed by Magic Eden.
openapi: 3.0.1
info:
title: NFTTOOLS API DOCS FOR MAGIC EDEN
version: 1.0.0
description: A comprehensive API for interacting with Magic Eden, providing tools to handle collections, tokens, activity, bid, list, and buy on Solana, Bitcoin, Ethereum, Base, and Polygon chains.
servers:
- url: https://nfttools.pro/magiceden
description: Production server
tags:
- name: Solana
description: Endpoints related to Solana blockchain
- name: Bitcoin
description: Endpoints related to Bitcoin blockchain
- name: EVM
description: Endpoints related to Ethereum, Polygon and Base blockchain
- name: Rewards
description: Check Diamond Rewards Eligibility
security:
- ApiKeyAuth: []
paths:
/rewards/diamond/eligibility:
get:
summary: Check Diamond Rewards Eligibility
description: Retrieve the eligibility status for Diamond Rewards for a specific wallet address on a given blockchain.
tags:
- Rewards
security:
- cookieAuth: []
- ApiKeyAuth: []
- bearerAuth: []
parameters:
- name: walletAddress
in: query
required: true
schema:
type: string
description: The wallet address to check for eligibility
example: EfdC1uyq5gWqHQYxSENscwNZKY8k2z8CXkpmPRB7mn2N
- name: chain
in: query
required: true
schema:
type: string
enum: [solana, ethereum, polygon, base, bitcoin] # Assuming these are the possible chains
description: The blockchain on which to check eligibility
example: solana
responses:
"200":
description: Successful response
"400":
description: Bad request
"401":
description: Unauthorized
"403":
description: Forbidden
"404":
description: Not found
"500":
description: Internal server error
#SOLANA
/collection_stats/search/solana:
servers:
- url: https://nfttools.pro/magiceden_stats
get:
summary: Search Solana Collection Stats
description: Retrieve collection statistics for Solana NFTs on Magic Eden, with options for sorting, filtering, and pagination.
tags:
- Solana
parameters:
- name: direction
in: query
required: true
schema:
type: string
enum: [asc, desc]
description: The direction to sort the results
example: desc
- name: sort
in: query
required: true
schema:
type: string
enum: [volume, floorPrice, listedCount] # Assuming these are possible sort options
description: The field to sort the results by
example: volume
- name: window
in: query
required: true
schema:
type: string
enum: [1d, 7d, 30d] # Assuming these are the possible values
description: The time window for the stats
example: 1d
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100 # Assuming 100 is the maximum allowed
description: The maximum number of results to return
example: 100
- name: offset
in: query
required: false
schema:
type: integer
minimum: 0
description: The number of results to skip (for pagination)
example: 0
responses:
"200":
description: Successful response
content:
application/json:
schema:
type: object
properties:
collections:
type: array
items:
type: object
properties:
# Define properties of each collection here
# This is a placeholder and should be replaced with the actual response structure
symbol:
type: string
name:
type: string
volume:
type: number
floorPrice:
type: number
listedCount:
type: integer
# Add other top-level properties if they exist in the response
"400":
description: Bad request
"401":
description: Unauthorized
"403":
description: Forbidden
"404":
description: Not found
"500":
description: Internal server error
/rpc/getCollectionHolderStats/{collectionSymbol}:
get:
summary: Get Collection Holder Statistics
description: Retrieve holder statistics for a specific NFT collection on Magic Eden.
tags:
- Solana
parameters:
- name: collectionSymbol
in: path
required: true
schema:
type: string
description: The symbol or identifier of the collection
example: rugens_drip
- name: edge_cache
in: query
required: false
schema:
type: boolean
description: Whether to use edge caching for the request
example: true
responses:
"200":
description: Successful response
content:
application/json:
schema:
type: object
properties:
totalHolders:
type: integer
description: Total number of unique holders in the collection
uniqueHolders:
type: number
description: Percentage of unique holders (possibly out of total supply)
averageHoldingPerWallet:
type: number
description: Average number of NFTs held per wallet
holdersDistribution:
type: object
description: Distribution of holders by number of NFTs held
properties:
"1":
type: integer
description: Number of wallets holding 1 NFT
"2-5":
type: integer
description: Number of wallets holding 2 to 5 NFTs
# Add more ranges as needed
# Add other properties that might be in the response
"400":
description: Bad request
"401":
description: Unauthorized
"403":
description: Forbidden
"404":
description: Collection not found
"500":
description: Internal server error
/idxv2/getAllNftsByCollectionSymbol:
get:
summary: Retrieve all NFTs by collection symbol
tags:
- Solana
parameters:
- name: collectionSymbol
in: query
required: true
schema:
type: string
example: rugens_drip
- name: direction
in: query
required: true
schema:
type: integer
enum: [1, -1]
default: 1
example: 1
- name: field
in: query
required: true
schema:
type: integer
default: 1
example: 1
- name: limit
in: query
required: false
schema:
type: integer
default: 1
example: 1
- name: token22StandardFilter
in: query
required: true
schema:
type: integer
default: 1
example: 1
- name: mplCoreStandardFilter
in: query
required: true
schema:
type: integer
default: 1
example: 1
- name: agg
in: query
required: true
schema:
type: integer
default: 3
example: 3
- name: compressionMode
in: query
required: true
schema:
type: string
enum: [both, compressed, uncompressed]
default: both
example: both
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: NFTs not found
"500":
description: Internal server error
/rpc/getNFTsByOwner/{ownerAddress}:
get:
summary: Retrieve NFTs by owner
tags:
- Solana
parameters:
- name: ownerAddress
in: path
required: true
schema:
type: string
example: EfdC1uyq5gWqHQYxSENscwNZKY8k2z8CXkpmPRB7mn2N
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: NFTs not found
"500":
description: Internal server error
/rpc/getCollectionAttributesStats/{collectionSymbol}:
get:
summary: Retrieve collection attributes stats
tags:
- Solana
parameters:
- name: collectionSymbol
in: path
required: true
schema:
type: string
example: drip_tarimosi
- name: status
in: query
required: false
schema:
type: string
enum: [all, active, inactive]
default: all
example: all
- name: edge_cache
in: query
required: true
schema:
type: boolean
default: true
example: true
- name: agg
in: query
required: true
schema:
type: integer
default: 3
example: 3
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Collection not found
"500":
description: Internal server error
/collections/{collectionSymbol}/organization:
get:
summary: Retrieve collection organization details
tags:
- Solana
parameters:
- name: collectionSymbol
in: path
required: true
schema:
type: string
example: drip_tarimosi
- name: edge_cache
in: query
required: true
schema:
type: boolean
default: true
example: true
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Collection not found
"500":
description: Internal server error
/sft/collection/{collectionSymbol}:
get:
summary: Retrieve collection details with pagination
tags:
- Solana
parameters:
- name: collectionSymbol
in: path
required: true
schema:
type: string
example: drip_tarimosi
- name: offset
in: query
required: false
schema:
type: integer
default: 0
example: 0
- name: limit
in: query
required: false
schema:
type: integer
default: 20
example: 20
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Collection not found
"500":
description: Internal server error
/rpc/getCollectionEscrowStats/{collectionSymbol}:
get:
summary: Retrieve collection escrow stats
tags:
- Solana
parameters:
- name: collectionSymbol
in: path
required: true
schema:
type: string
example: drip_tarimosi
- name: status
in: query
required: false
schema:
type: string
enum: [all, active, inactive]
default: all
example: all
- name: edge_cache
in: query
required: true
schema:
type: boolean
default: true
example: true
- name: agg
in: query
required: true
schema:
type: integer
default: 3
example: 3
- name: enableFloorWithFee
in: query
required: true
schema:
type: boolean
default: true
example: true
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Collection not found
"500":
description: Internal server error
/v2/activities:
get:
summary: Get Collection Activities
description: Retrieve activities for a specific NFT collection on Magic Eden, with options for filtering by activity type and pagination.
tags:
- Solana
parameters:
- name: activityTypes
in: query
required: true
schema:
type: string
description: JSON array of activity types to filter by, URL encoded
example: "%5B%22sale%22%2C%22item_offer%22%2C%22pool_offer%22%2C%22attributes_offer%22%2C%22list%22%2C%22edit_list%22%2C%22delist%22%5D"
- name: collectionSymbol
in: query
required: true
schema:
type: string
description: The symbol or identifier of the collection
example: drip_tarimosi
- name: onChainCollectionAddress
in: query
required: true
schema:
type: string
description: The on-chain address of the collection
example: TAuAUS8neSS3KPSqLXQ7u1aWkKgnVPzqNizihDYuXvN
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 50 # Assuming 50 is the maximum allowed
description: The maximum number of results to return
example: 50
- name: enableSNS
in: query
required: true
schema:
type: boolean
description: Whether to enable SNS (possibly Solana Name Service) resolution
example: true
responses:
"200":
description: Successful response
"400":
description: Bad request
"401":
description: Unauthorized
"403":
description: Forbidden
"404":
description: Collection not found
"500":
description: Internal server error
/idxv2/getListedNftsByCollectionSymbol:
get:
summary: Retrieve listed NFTs by collection symbol
tags:
- Solana
parameters:
- name: collectionSymbol
in: query
required: true
schema:
type: string
example: drip_tarimosi
- name: direction
in: query
required: false
schema:
type: integer
enum: [1, 2]
default: 2
example: 2
- name: field
in: query
required: false
schema:
type: integer
default: 1
example: 1
- name: limit
in: query
required: false
schema:
type: integer
default: 100
example: 100
- name: token22StandardFilter
in: query
required: false
schema:
type: integer
default: 1
example: 1
- name: mplCoreStandardFilter
in: query
required: false
schema:
type: integer
default: 1
example: 1
- name: mode
in: query
required: false
schema:
type: string
enum: [all, listed]
default: all
example: all
- name: agg
in: query
required: false
schema:
type: integer
default: 3
example: 3
- name: compressionMode
in: query
required: false
schema:
type: string
enum: [none, both, compressed, uncompressed]
default: both
example: both
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: NFTs not found
"500":
description: Internal server error
/collection_watchlists/action/checkUserWatchCollection/{collectionSymbol}:
get:
summary: Check if user is watching a collection
tags:
- Solana
parameters:
- name: collectionSymbol
in: path
required: true
schema:
type: string
example: drip_tarimosi
- name: walletAddress
in: query
required: true
schema:
type: string
example: EfdC1uyq5gWqHQYxSENscwNZKY8k2z8CXkpmPRB7mn2N
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Collection or user not found
"500":
description: Internal server error
/collections/{collectionSymbol}:
get:
summary: Retrieve collection details
tags:
- Solana
parameters:
- name: collectionSymbol
in: path
required: true
schema:
type: string
example: drip_tarimosi
- name: edge_cache
in: query
required: false
schema:
type: boolean
default: true
example: true
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Collection not found
"500":
description: Internal server error
/idxv2/getBidsByMintAddresses:
get:
summary: Retrieve bids by mint addresses
tags:
- Solana
parameters:
- name: hideExpired
in: query
required: false
schema:
type: boolean
default: true
example: true
- name: mintAddresses
in: query
required: true
schema:
type: string
example: DmdF3ACqvjmRh4mayaw3SAKuttVQ3tZkmut1N4RxSLCG
- name: direction
in: query
required: false
schema:
type: integer
enum: [1, 2]
default: 1
example: 1
- name: field
in: query
required: false
schema:
type: integer
default: 2
example: 2
- name: limit
in: query
required: false
schema:
type: integer
default: 500
example: 500
- name: offset
in: query
required: false
schema:
type: integer
default: 0
example: 0
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Bids not found
"500":
description: Internal server error
/rpc/getNFTByMintAddress/{mintAddress}:
get:
summary: Retrieve NFT by mint address
tags:
- Solana
parameters:
- name: mintAddress
in: path
required: true
schema:
type: string
example: DmdF3ACqvjmRh4mayaw3SAKuttVQ3tZkmut1N4RxSLCG
- name: agg
in: query
required: false
schema:
type: integer
default: 3
example: 3
- name: useRarity
in: query
required: false
schema:
type: boolean
default: true
example: true
- name: includeBurntMint
in: query
required: false
schema:
type: boolean
default: true
example: true
- name: compressionMode
in: query
required: false
schema:
type: string
enum: [none, both, compressed, uncompressed]
default: both
example: both
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: NFT not found
"500":
description: Internal server error
/rpc/getNFTStatsByMintAddress/{mintAddress}:
get:
summary: Retrieve NFT stats by mint address
tags:
- Solana
parameters:
- name: mintAddress
in: path
required: true
schema:
type: string
example: DmdF3ACqvjmRh4mayaw3SAKuttVQ3tZkmut1N4RxSLCG
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: NFT stats not found
"500":
description: Internal server error
/v2/collections/{symbol}/activities:
get:
summary: Retrieve activities for a collection
tags:
- Solana
parameters:
- name: symbol
in: path
required: true
schema:
type: string
example: drip_tarimosi
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Activities not found
"500":
description: Internal server error
/v2/tokens/{token_mint}/listings:
get:
summary: Retrieve listings for a token
tags:
- Solana
parameters:
- name: token_mint
in: path
required: true
schema:
type: string
example: DmdF3ACqvjmRh4mayaw3SAKuttVQ3tZkmut1N4RxSLCG
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Listings not found
"500":
description: Internal server error
/v2/tokens/{token_mint}/offers_received:
get:
summary: Retrieve offers received for a token
tags:
- Solana
parameters:
- name: token_mint
in: path
required: true
schema:
type: string
example: DmdF3ACqvjmRh4mayaw3SAKuttVQ3tZkmut1N4RxSLCG
- name: min_price
in: query
required: false
schema:
type: integer
example: 1000000
- name: max_price
in: query
required: false
schema:
type: integer
example: 100000000
- name: offset
in: query
required: false
schema:
type: integer
default: 0
example: 0
- name: limit
in: query
required: false
schema:
type: integer
default: 50
example: 50
- name: sort
in: query
required: false
schema:
type: string
enum:
- updatedAt
- bidAmount
example: updatedAt
- name: sort_direction
in: query
required: false
schema:
type: string
enum:
- asc
- desc
example: desc
responses:
"200":
description: Successful response
content:
application/json:
schema:
type: object
properties:
offers:
type: array
items:
type: object
properties:
price:
type: string
example: "1000000000"
buyer:
type: string
example: EfdC1uyq5gWqHQYxSENscwNZKY8k2z8CXkpmPRB7mn2N
mintAddress:
type: string
example: DmdF3ACqvjmRh4mayaw3SAKuttVQ3tZkmut1N4RxSLCG
timestamp:
type: string
example: 2023-07-04T12:34:56Z
"400":
description: Invalid request
"404":
description: Offers not found
"500":
description: Internal server error
/v2/tokens/{token_mint}/activities:
get:
summary: Retrieve activities for a token
tags:
- Solana
parameters:
- name: token_mint
in: path
required: true
schema:
type: string
example: DmdF3ACqvjmRh4mayaw3SAKuttVQ3tZkmut1N4RxSLCG
- name: offset
in: query
required: false
schema:
type: integer
default: 0
example: 0
- name: limit
in: query
required: false
schema:
type: integer
default: 50
example: 50
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Activities not found
"500":
description: Internal server error
/v2/tokens/{token_mint}:
get:
summary: Retrieve token details by mint address
tags:
- Solana
parameters:
- name: token_mint
in: path
required: true
schema:
type: string
example: DmdF3ACqvjmRh4mayaw3SAKuttVQ3tZkmut1N4RxSLCG
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Token not found
"500":
description: Internal server error
/v2/collections/batch/listings:
post:
summary: Batch retrieve listings for collections
tags:
- Solana
parameters:
- name: attributes
in: query
schema:
type: string
description: |
Array of arrays of objects representing a filtering mechanism.
Elements within each inner array are logically ORed, and resulting arrays are ANDed together.
Each inner array consists of objects with properties traitType (string) and value (string).
Example: [[{"traitType":"trait1", "value":"value1"},{"traitType":"trait1", "value":"value2"}]]
- name: offset
required: false
in: query
schema:
type: integer
example: 0
description: Offset for pagination
- name: limit
required: false
in: query
schema:
type: integer
example: 50
description: Number of results per page
- name: min_price
in: query
schema:
type: integer
example: 1000000
description: Minimum price filter
- name: max_price
in: query
schema:
type: integer
example: 100000000
description: Maximum price filter
- name: sort
in: query
schema:
type: string
enum:
- listPrice
- updatedAt
example: listPrice
description: Field to sort the listings
- name: sort_direction
in: query
schema:
type: string
enum:
- asc
- desc
example: asc
description: Sort direction for the returned elements
- name: listingAggMode
in: query
schema:
type: boolean
example: true
description: True to return aggregated marketplace listings, false for Magic Eden listings only
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
collections:
type: array
items:
type: object
properties:
symbol:
type: string
example: drip_tarimosi
mcc:
type: string
responses:
"200":
description: Successful response
"400":
description: Invalid request
"404":
description: Listings not found
"500":
description: Internal server error
/v2/instructions/sell:
get:
tags:
- Solana
summary: Get sell instructions
description: Retrieve instructions for selling an NFT on Magic Eden.
parameters:
- name: seller
in: query
required: true
schema:
type: string
example: EfdC1uyq5gWqHQYxSENscwNZKY8k2z8CXkpmPRB7mn2N
description: The seller's wallet address.
- name: auctionHouseAddress
in: query
required: true
schema:
type: string
example: E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe
description: The address of the auction house.
- name: tokenMint
in: query
required: true
schema:
type: string
example: 7kpQSvaSW5r4usqUHeqXCHK79zj4amadLdv1mpFpDiWR
description: The mint address of the token.
- name: tokenAccount
in: query
required: true
schema:
type: string
example: HLfiWCHHma8BJDHPLt1q65v2cA4UXQKEswPCT1rEbQi4
description: The token account address.
- name: price
in: query
required: true
schema:
type: number
example: 1
description: The price of the token.
responses:
"200":
description: Successful response
"400":
description: Invalid parameters
"500":
description: Internal server error
/v2/tx/{txId}:
post:
tags:
- Solana
summary: Submit signed listing
parameters:
- in: path
name: txId
required: true
schema:
type: string
description: The transaction ID to retrieve details for.
requestBody:
required: false
content:
application/json: {} # Assuming JSON payload, adjust content type if necessary
responses:
"200":
description: Successful response
"400":
description: Bad request
"404":
description: Not found
"500":
description: Internal server error
/v2/instructions/buy:
get:
tags:
- Solana
summary: Get buy instructions
parameters:
- name: buyer
in: query
required: true
schema:
type: string
example: EfdC1uyq5gWqHQYxSENscwNZKY8k2z8CXkpmPRB7mn2N
- name: auctionHouseAddress
in: query
required: true
schema:
type: string
example: E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe
- name: tokenMint
in: query
required: true
schema:
type: string
example: 7kpQSvaSW5r4usqUHeqXCHK79zj4amadLdv1mpFpDiWR
- name: price
in: query
required: true
schema:
type: number
example: 1
responses:
"200":
description: Successful response
/collection_stats/search/{chain}:
servers:
- url: https://nfttools.pro/magiceden_stats
get:
# --- truncated at 32 KB (85 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/magiceden/refs/heads/main/openapi/magiceden-openapi.yaml