Magic Eden

https://docs.magiceden.io/
Admin
Magic Eden is a multi-chain NFT marketplace API platform providing developer access to Solana,...
Tokens:166,117
Snippets:494
Trust Score:10
Update:6 months ago
Show doc for...
Tokens:
Raw
### GET /instructions

Source: https://docs.magiceden.io/reference/get_instructions-sell

Configures transaction priority fees for instruction requests using lamports.

```APIDOC
## GET /instructions

### Description
Provides parameters to define priority fees for transactions, allowing users to specify either a maximum limit or an exact fee amount in lamports.

### Method
GET

### Endpoint
/instructions

### Parameters
#### Query Parameters
- **maxPrioFeeLamports** (number) - Optional - Maximum priority fee in lamports.
- **exactPrioFeeLamports** (number) - Optional - Exact priority fee in lamports.

### Request Example
GET /instructions?maxPrioFeeLamports=1000

### Response
#### Success Response (200)
- **status** (string) - Indicates the success of the request.
```

--------------------------------

### Get NFT Details - Curl Example

Source: https://docs.magiceden.io/reference/get_collections-symbol-holder-stats-1

This example shows how to retrieve detailed information about a specific NFT using its mint address via a cURL command. It targets the NFT details endpoint of the Magic Eden API. The response is in JSON format.

```bash
curl -X GET "https://api.magiceden.io/v2/tokens/YOUR_MINT_ADDRESS" \
     -H "accept: application/json"
```

--------------------------------

### NFT Marketplace UI (React)

Source: https://docs.magiceden.io/reference/mmm

This example shows a basic React component for an NFT marketplace UI. It demonstrates how to fetch NFT data, display it, and interact with wallet functionalities for actions like buying or bidding.

```JavaScript
function NFTCard({ nft }) {
  return (
    <div>
      <img src={nft.image} alt={nft.name} />
      <h2>{nft.name}</h2>
      <p>{nft.price} SOL</p>
      <button onClick={() => handleBuy(nft.id)}>Buy</button>
    </div>
  );
}
```

--------------------------------

### Get Sell Instruction

Source: https://docs.magiceden.io/reference/get_instructions-sell-now

Retrieves instructions required to sell an NFT and accept an offer.

```APIDOC
## GET /instructions/sell

### Description
This endpoint provides the necessary instructions and parameters to execute a sell order for an NFT, including accepting a specific offer.

### Method
GET

### Endpoint
/instructions/sell

### Parameters
#### Query Parameters
- **nftMintAddress** (string) - Required - The mint address of the NFT to be sold.
- **offerAddress** (string) - Required - The address of the offer to be accepted.

### Request Example
```
GET /instructions/sell?nftMintAddress=YOUR_NFT_MINT_ADDRESS&offerAddress=YOUR_OFFER_ADDRESS
```

### Response
#### Success Response (200)
- **instructions** (object) - Contains the data needed to execute the sell transaction.
  - **buyer** (string) - The wallet address of the buyer.
  - **seller** (string) - The wallet address of the seller.
  - **tokenMint** (string) - The mint address of the NFT.
  - **price** (string) - The price at which the NFT will be sold.
  - **nonce** (string) - A unique identifier for the transaction.
  - **signature** (string) - The signature for the transaction.
  - **expiry** (number) - The expiration timestamp for the instructions.

#### Response Example
```json
{
  "instructions": {
    "buyer": "BuyerWalletAddress",
    "seller": "SellerWalletAddress",
    "tokenMint": "NFTMintAddress",
    "price": "1000000000",
    "nonce": "12345",
    "signature": "ExampleSignature",
    "expiry": 1678886400
  }
}
```
```

--------------------------------

### GET /mmm/instructions/create-pool

Source: https://docs.magiceden.io/reference/get_instructions-mmm-create-pool

Initializes the creation of a new liquidity pool for a specific collection.

```APIDOC
## GET /mmm/instructions/create-pool

### Description
Creates a new pool for a specified collection, allowing users to define payment mints and initial deposits.

### Method
GET

### Endpoint
/mmm/instructions/create-pool

### Parameters
#### Query Parameters
- **paymentMint** (string) - Required - Mint address of payment (default for SOL)
- **collectionSymbol** (string) - Required - Collection symbol for which the pool will be valid
- **owner** (string) - Required - Owner of the pool
- **solDeposit** (number) - Optional - Optional sol amount to deposit with pool creation
- **priorityFee** (number) - Optional - Priority fee (in microlamports) to reprioritize the transaction against others
- **sharedEscrowCount** (number) - Optional - Number of pools (bids) that will share the escrow account

### Request Example
GET /mmm/instructions/create-pool?paymentMint=So11111111111111111111111111111111111111112&collectionSymbol=my_collection&owner=Address123

### Response
#### Success Response (200)
- **status** (string) - Success status of the instruction generation
- **transaction** (string) - The serialized transaction for the pool creation

#### Response Example
{
  "status": "success",
  "transaction": "base64_encoded_transaction_data"
}
```

--------------------------------

### GET /mmm/instructions

Source: https://docs.magiceden.io/reference/get_instructions-mmm-sol-fulfill-buy-1

Retrieves the instructions associated with the MMM market making protocol.

```APIDOC
## GET /mmm/instructions

### Description
Retrieves the current instructions for the MMM protocol, allowing users to understand market making parameters.

### Method
GET

### Endpoint
/mmm/instructions

### Parameters
None

### Request Example
GET /mmm/instructions

### Response
#### Success Response (200)
- **instructions** (number) - The instruction set identifier or value.

#### Response Example
{
  "instructions": 12345
}
```

--------------------------------

### Solana Program Interaction (Rust)

Source: https://docs.magiceden.io/reference/mmm

This example demonstrates interacting with a Solana program from another program using Rust. It outlines the necessary steps for invoking a program, passing accounts, and handling the results, which is crucial for building complex Solana applications.

```Rust
let accounts = vec![AccountMeta::new(target_account, false)];
let instruction = Instruction {
    program_id: target_program_id,
    accounts: accounts,
    data: instruction_data,
};

invoke( &instruction, &mut context.remaining_accounts )?;
```

--------------------------------

### GET /api/v1/collections

Source: https://docs.magiceden.io/reference/mmm

Retrieves a list of NFT collections available on the MagicEden marketplace.

```APIDOC
## GET /api/v1/collections

### Description
Fetches a paginated list of NFT collections currently listed on MagicEden.

### Method
GET

### Endpoint
/api/v1/collections

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Number of collections to return (default: 20)
- **offset** (integer) - Optional - Number of collections to skip

### Request Example
GET /api/v1/collections?limit=10

### Response
#### Success Response (200)
- **collections** (array) - List of collection objects

#### Response Example
{
  "collections": [
    {
      "symbol": "abc_collection",
      "name": "ABC Collection"
    }
  ]
}
```

--------------------------------

### Magic Eden API Interaction

Source: https://docs.magiceden.io/reference/mmm

This snippet demonstrates how to interact with the Magic Eden API. It covers the initial setup and basic request structure for fetching project data.

```javascript
async function fetchProjectData(projectId) {
  const response = await fetch(`https://api-mainnet.magiceden.dev/v2/collections/${projectId}`);
  return await response.json();
}
```

```python
import requests

def fetch_project_data(project_id):
    response = requests.get(f"https://api-mainnet.magiceden.dev/v2/collections/{project_id}")
    return response.json()
```

--------------------------------

### Get Instruction to Sell Now (Accept Offer)

Source: https://docs.magiceden.io/reference/get_instructions-sell-now-1

Retrieves the necessary transaction instructions to accept an offer and sell an NFT immediately. This endpoint requires authentication.

```APIDOC
## GET /instructions/sell_now

### Description
Get instruction to sell now (accept offer).

### Method
GET

### Endpoint
/instructions/sell_now

### Parameters
#### Query Parameters
- **buyer** (string) - Required - Buyer wallet
- **seller** (string) - Required - Seller wallet
- **auctionHouseAddress** (string) - Optional - Auction house Address. If not provided, will use default auction house.
- **tokenMint** (string) - Required - Token mint address
- **tokenATA** (string) - Required - Associate token account
- **price** (number) - Required - Price in SOL
- **newPrice** (number) - Required - New price in SOL
- **sellerExpiry** (number) - Required - timestamp in seconds in the future, 0 means no expiry
- **buyerReferral** (string) - Optional - Buyer referral wallet
- **sellerReferral** (string) - Optional - Seller referral wallet

### Request Example
```json
{
  "example": "Request body not applicable for GET request"
}
```

### Response
#### Success Response (200)
- **tx** (IBuffer) - The transaction object
- **txSigned** (IBuffer) - The signed transaction object

#### Response Example
```json
{
  "tx": {
    "type": "Buffer",
    "data": [
      167,
      115,
      111,
      108,
      117,
      110,
      97
    ]
  },
  "txSigned": {
    "type": "Buffer",
    "data": [
      167,
      115,
      111,
      108,
      117,
      110,
      97
    ]
  }
}
```
```

--------------------------------

### Get Collection Activities - Node.js

Source: https://docs.magiceden.io/reference/get_collections-symbol-activities

Example of retrieving collection activities using Node.js with the 'axios' library. It makes a GET request to the Magic Eden API endpoint.

```javascript
const axios = require('axios');

const getCollectionActivities = async (symbol) => {
  try {
    const response = await axios.get(`https://api-mainnet.magiceden.dev/v2/collections/${symbol}/activities`, {
      headers: {
        'accept': 'application/json'
      }
    });
    return response.data;
  } catch (error) {
    console.error('Error fetching collection activities:', error);
    throw error;
  }
};

// Example usage:
// getCollectionActivities('your_collection_symbol').then(data => console.log(data));
```

--------------------------------

### Get NFT Details - JavaScript Example

Source: https://docs.magiceden.io/reference/get_collections-symbol-holder-stats-1

This JavaScript snippet fetches detailed information for a specific NFT using its mint address. It makes a GET request to the token endpoint and parses the JSON response. Ensure a fetch API implementation is available in your environment.

```javascript
async function getNftDetails(mintAddress) {
  const url = `https://api.magiceden.io/v2/tokens/${mintAddress}`;
  try {
    const response = await fetch(url);
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    const data = await response.json();
    console.log(data);
    return data;
  } catch (error) {
    console.error('Error fetching NFT details:', error);
  }
}

// Example usage:
// getNftDetails('YOUR_MINT_ADDRESS');
```

--------------------------------

### GET /instructions

Source: https://docs.magiceden.io/reference/get_instructions-buy-now-transfer-nft

Configures transaction instructions with referral, expiry, and priority fee parameters.

```APIDOC
## GET /instructions

### Description
This endpoint allows users to define specific transaction instructions, including seller referrals, expiration timestamps, and various priority fee configurations to optimize transaction processing.

### Method
GET

### Endpoint
/instructions

### Parameters
#### Query Parameters
- **sellerReferral** (string) - Optional - Seller referral wallet address.
- **buyerExpiry** (number) - Optional - Timestamp in seconds in the future, 0 means no expiry.
- **sellerExpiry** (number) - Required - Timestamp in seconds in the future, 0 means no expiry.
- **buyerCreatorRoyaltyPercent** (number) - Optional - Buyer creator royalty percentage, integer 0-100.
- **priorityFee** (number) - Optional - Priority fee (in microlamports) to reprioritize the transaction.
- **prioFeeMicroLamports** (number) - Optional - Priority fee in microlamports.
- **maxPrioFeeLamports** (number) - Optional - Maximum priority fee in lamports.
- **exactPrioFeeLamports** (number) - Optional - Exact priority fee in lamports.

### Request Example
GET /instructions?sellerExpiry=1735689600&priorityFee=1000

### Response
#### Success Response (200)
- **status** (string) - Confirmation of instruction configuration.

#### Response Example
{
  "status": "success"
}
```

--------------------------------

### Get Collection Details - JavaScript Example

Source: https://docs.magiceden.io/reference/get_collections-symbol-holder-stats-1

This snippet demonstrates how to fetch details for a specific NFT collection using the Magic Eden API. It makes a GET request to the collections endpoint and processes the JSON response. Dependencies include a fetch API implementation.

```javascript
async function getCollectionDetails(symbol) {
  const url = `https://api.magiceden.io/v2/collections/${symbol}`;
  try {
    const response = await fetch(url);
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    const data = await response.json();
    console.log(data);
    return data;
  } catch (error) {
    console.error('Error fetching collection details:', error);
  }
}

// Example usage:
// getCollectionDetails('solana-punks');
```

--------------------------------

### Get Wallet NFTs - Python Example

Source: https://docs.magiceden.io/reference/get_wallets-wallet-address-activities-1

Retrieves a list of NFTs owned by a specific wallet address. Supports pagination with offset and limit parameters. Requires a valid wallet address as input.

```python
import requests

def get_wallet_nfts(wallet_address, offset=0, limit=100):
    url = f"https://api.magiceden.io/v2/wallets/{wallet_address}/nft"
    params = {
        "offset": offset,
        "limit": limit
    }
    response = requests.get(url, params=params)
    return response.json()
```

--------------------------------

### Create Pool Instructions (Python)

Source: https://docs.magiceden.io/reference/get_instructions-mmm-create-pool-1

This Python script demonstrates how to retrieve instructions for creating a liquidity pool via the Magic Eden API. It uses the 'requests' library to send a GET request.

```python
import requests

url = "https://api-mainnet.magiceden.dev/v2/instructions/mmm/create-pool"
params = {
    "curveType": "linear",
    "reinvestBuy": "true",
    "reinvestSell": "true"
}
headers = {
    "accept": "application/json"
}

response = requests.get(url, params=params, headers=headers)

print(response.json())
```

--------------------------------

### Get Wallet NFTs - JavaScript Example

Source: https://docs.magiceden.io/reference/get_wallets-wallet-address-activities-1

Fetches NFTs associated with a given wallet address using JavaScript. This function allows for specifying the number of items to skip (offset) and the maximum number of items to return (limit).

```javascript
async function getWalletNfts(walletAddress, offset = 0, limit = 100) {
  const url = `https://api.magiceden.io/v2/wallets/${walletAddress}/nft?offset=${offset}&limit=${limit}`;
  try {
    const response = await fetch(url);
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    const data = await response.json();
    return data;
  } catch (error) {
    console.error('Error fetching wallet NFTs:', error);
    return null;
  }
}
```

--------------------------------

### GET /instructions/buy_now

Source: https://docs.magiceden.io/reference/get_instructions-buy-now-1

Retrieves instructions required to execute a 'buy now' transaction on Magic Eden. This endpoint is secured and requires authentication.

```APIDOC
## GET /instructions/buy_now

### Description
Get instruction to buy now

### Method
GET

### Endpoint
/instructions/buy_now

### Parameters
#### Query Parameters
- **buyer** (string) - Required - Buyer wallet
- **seller** (string) - Required - Seller wallet
- **auctionHouseAddress** (string) - Optional - Auction house Address. If not provided, will use default auction house.
- **tokenMint** (string) - Required - Token mint address
- **tokenATA** (string) - Required - Associate Token Account
- **price** (number) - Required - Price in SOL
- **buyerReferral** (string) - Optional - Buyer referral wallet
- **sellerReferral** (string) - Optional - Seller referral wallet
- **buyerExpiry** (number) - Optional - timestamp in seconds in the future, 0 means no expiry
- **sellerExpiry** (number) - Required - timestamp in seconds in the future, 0 means no expiry

### Request Example
```json
{
  "example": "request body"
}
```

### Response
#### Success Response (200)
- **tx** (IBuffer) - Description of tx
- **txSigned** (IBuffer) - Description of txSigned

#### Response Example
```json
{
  "tx": {
    "type": "Buffer",
    "data": [
      0,
      167,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255
    ]
  },
  "txSigned": {
    "type": "Buffer",
    "data": [
      0,
      167,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255,
      255
    ]
  }
}
```
```

--------------------------------

### Get Collection Stats - Python Example

Source: https://docs.magiceden.io/reference/get_collections-symbol-holder-stats-1

This Python function retrieves statistical data for an NFT collection, such as floor price and volume, using the Magic Eden API. It uses the 'requests' library and includes error handling for network or API issues. The output is a JSON object.

```python
import requests

def get_collection_stats(symbol):
    url = f"https://api.magiceden.io/v2/collections/{symbol}/stats"
    try:
        response = requests.get(url)
        response.raise_for_status()  # Raise an exception for bad status codes
        data = response.json()
        print(data)
        return data
    except requests.exceptions.RequestException as e:
        print(f"Error fetching stats for collection {symbol}: {e}")
        return None

# Example usage:
# get_collection_stats('okaybears')
```

--------------------------------

### GET /instructions

Source: https://docs.magiceden.io/reference/get_instructions-sell-cancel-1

Configures transaction priority fees using query parameters for instruction requests.

```APIDOC
## GET /instructions

### Description
Provides parameters to specify priority fees for transactions, allowing users to optimize for network speed.

### Method
GET

### Endpoint
/instructions

### Parameters
#### Query Parameters
- **maxPrioFeeLamports** (number) - Optional - Maximum priority fee in lamports
- **exactPrioFeeLamports** (number) - Optional - Exact priority fee in lamports

### Request Example
GET /instructions?maxPrioFeeLamports=100000

### Response
#### Success Response (200)
- **status** (string) - The status of the instruction request.

#### Response Example
{
  "status": "success"
}
```

--------------------------------

### Get Collection Activities - Ruby

Source: https://docs.magiceden.io/reference/get_collections-symbol-activities

Demonstrates how to retrieve collection activities using Ruby with the 'httparty' gem. It performs a GET request to the Magic Eden API.

```ruby
require 'httparty'

def get_collection_activities(symbol)
  url = "https://api-mainnet.magiceden.dev/v2/collections/#{symbol}/activities"
  headers = {
    'accept' => 'application/json'
  }
  begin
    response = HTTParty.get(url, headers: headers)
    if response.success?
      return response.parsed_response
    else
      puts "Error fetching collection activities: #{response.code} - #{response.message}"
      return nil
    end
  rescue StandardError => e
    puts "An error occurred: #{e.message}"
    return nil
  end
end

# Example usage:
# activities = get_collection_activities('your_collection_symbol')
# puts activities
```

--------------------------------

### POST /v2/instructions/buy_now

Source: https://docs.magiceden.io/reference/ixslistget

Endpoint to generate the required signing data for creating a new asset listing.

```APIDOC
## POST /v2/instructions/buy_now

### Description
Generates the necessary transaction instructions and signing data for listing an asset on Magic Eden. After receiving this data, the client must sign the transaction and submit it to the finalization endpoint.

### Method
POST

### Endpoint
/v2/instructions/buy_now

### Parameters
#### Request Body
- **mintAddress** (string) - Required - The public key of the asset to be listed.
- **price** (number) - Required - The listing price in lamports.
- **seller** (string) - Required - The public key of the seller wallet.

### Request Example
{
  "mintAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83fqRuJosg5U",
  "price": 1000000000,
  "seller": "83294829482948294829482948294829"
}

### Response
#### Success Response (200)
- **unsignedTransaction** (string) - The base64 encoded unsigned transaction data.
- **blockhash** (string) - The recent blockhash for the transaction.

#### Response Example
{
  "unsignedTransaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==",
  "blockhash": "5s999999999999999999999999999999999999999999"
}
```

--------------------------------

### Get Collection Activities - PHP

Source: https://docs.magiceden.io/reference/get_collections-symbol-activities

This PHP snippet illustrates fetching collection activities using cURL. It makes a GET request to the Magic Eden API endpoint.

```php
<?php

function getCollectionActivities(string $symbol)
{
    $url = "https://api-mainnet.magiceden.dev/v2/collections/{$symbol}/activities";
    $headers = [
        'accept: application/json'
    ];

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    if (curl_errno($ch)) {
        echo 'Error:' . curl_error($ch);
        curl_close($ch);
        return null;
    }

    curl_close($ch);

    if ($httpCode >= 200 && $httpCode < 300) {
        return json_decode($response, true);
    } else {
        echo "HTTP Error: {$httpCode}" . PHP_EOL;
        return null;
    }
}

// Example usage:
// $symbol = 'your_collection_symbol';
// $activities = getCollectionActivities($symbol);
// if ($activities) {
//     print_r($activities);
// }
```

--------------------------------

### GET /instructions/buy

Source: https://docs.magiceden.io/reference/get_instructions-buy

Retrieves the necessary transaction instructions to execute a buy (bid) order on the platform.

```APIDOC
## GET /instructions/buy

### Description
Get instruction to buy (bid) an asset on the blockchain.

### Method
GET

### Endpoint
/instructions/buy

### Parameters
#### Query Parameters
- **buyer** (string) - Required - Buyer wallet address
- **tokenMint** (string) - Required - Token mint address
- **price** (number) - Required - Price in SOL
- **auctionHouseAddress** (string) - Optional - Auction house address
- **buyerReferral** (string) - Optional - Buyer referral wallet
- **buyerCreatorRoyaltyPercent** (number) - Optional - Royalty percentage (0-100)
- **expiry** (number) - Optional - Expiry timestamp in seconds
- **priorityFee** (number) - Optional - Priority fee in microlamports

### Request Example
GET /instructions/buy?buyer=WALLET_ADDRESS&tokenMint=MINT_ADDRESS&price=1.5

### Response
#### Success Response (200)
- **tx** (IBuffer) - The transaction buffer data
- **txSigned** (IBuffer) - Optional signed transaction buffer

#### Response Example
{
  "tx": {
    "type": "Buffer",
    "data": [0, 1, 2]
  }
}
```

--------------------------------

### Get Collection Activities - Python

Source: https://docs.magiceden.io/reference/get_collections-symbol-activities

This Python snippet shows how to fetch collection activities using the 'requests' library. It sends a GET request to the specified API endpoint.

```python
import requests

def get_collection_activities(symbol):
    url = f"https://api-mainnet.magiceden.dev/v2/collections/{symbol}/activities"
    headers = {
        'accept': 'application/json'
    }
    try:
        response = requests.get(url, headers=headers)
        response.raise_for_status()  # Raise an exception for bad status codes
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Error fetching collection activities: {e}")
        return None

# Example usage:
# activities = get_collection_activities('your_collection_symbol')
# if activities:
#     print(activities)
```

--------------------------------

### GET /instructions/buy_now

Source: https://docs.magiceden.io/reference/get_instructions-buy-now

Retrieves the necessary transaction instructions to execute a 'buy now' operation on the Magic Eden marketplace.

```APIDOC
## GET /instructions/buy_now

### Description
Fetches the transaction data required to perform an immediate purchase of an NFT. This endpoint requires bearer authentication.

### Method
GET

### Endpoint
/instructions/buy_now

### Parameters
#### Query Parameters
- **buyer** (string) - Required - Buyer wallet address
- **seller** (string) - Required - Seller wallet address
- **auctionHouseAddress** (string) - Optional - Auction house address
- **tokenMint** (string) - Required - Token mint address
- **tokenATA** (string) - Required - Associate Token Account
- **price** (number) - Required - Price in SOL
- **buyerReferral** (string) - Optional - Buyer referral wallet
- **sellerReferral** (string) - Optional - Seller referral wallet
- **buyerExpiry** (number) - Optional - Timestamp in seconds for buyer expiry
- **sellerExpiry** (number) - Required - Timestamp in seconds for seller expiry

### Request Example
GET /instructions/buy_now?buyer=...&seller=...&tokenMint=...&tokenATA=...&price=1.5&sellerExpiry=1700000000

### Response
#### Success Response (200)
- **tx** (IBuffer) - The transaction buffer data
- **txSigned** (IBuffer) - Optional signed transaction buffer

#### Response Example
{
  "tx": {
    "type": "Buffer",
    "data": [0, 1, 2]
  }
}
```

--------------------------------

### Get Collection Holder Stats (cURL)

Source: https://docs.magiceden.io/reference/get_collections-symbol-holder-stats

This cURL command demonstrates how to make a GET request to the Magic Eden API to retrieve holder statistics for a specific NFT collection. It includes the necessary URL and headers for the request.

```shell
curl --request GET \
     --url https://api-mainnet.magiceden.dev/v2/collections/symbol/holder_stats \
     --header 'accept: application/json'
```

--------------------------------

### GET /instructions

Source: https://docs.magiceden.io/reference/get_instructions-sell-now-1

Retrieves transaction instructions with optional parameters for buyer expiry and priority fees.

```APIDOC
## GET /instructions

### Description
Retrieves transaction instructions for Magic Eden operations, allowing for custom buyer expiry and priority fee settings.

### Method
GET

### Endpoint
/instructions

### Parameters
#### Query Parameters
- **buyerExpiry** (number) - Optional - Timestamp in seconds in the future, 0 means no expiry.
- **priorityFee** (number) - Optional - Priority fee (in microlamports) to reprioritize the transaction against others.

### Request Example
GET /instructions?buyerExpiry=1700000000&priorityFee=1000

### Response
#### Success Response (200)
- **status** (string) - The status of the instruction generation.

#### Response Example
{
  "status": "success"
}
```

--------------------------------

### Get Collection Holder Stats (Node.js)

Source: https://docs.magiceden.io/reference/get_collections-symbol-holder-stats

This Node.js snippet shows how to fetch holder statistics for an NFT collection using the 'axios' library. It makes a GET request to the Magic Eden API endpoint, specifying the collection symbol.

```javascript
const axios = require('axios');

const getHolderStats = async (symbol) => {
  try {
    const response = await axios.get(`https://api-mainnet.magiceden.dev/v2/collections/${symbol}/holder_stats`);
    return response.data;
  } catch (error) {
    console.error('Error fetching holder stats:', error);
    return null;
  }
};

// Example usage:
// getHolderStats('your_collection_symbol').then(data => console.log(data));
```

--------------------------------

### Get Collection Holder Stats (Python)

Source: https://docs.magiceden.io/reference/get_collections-symbol-holder-stats

This Python script utilizes the 'requests' library to get holder statistics for an NFT collection from the Magic Eden API. It constructs the URL with the provided collection symbol and handles potential request errors.

```python
import requests

def get_holder_stats(symbol):
    url = f"https://api-mainnet.magiceden.dev/v2/collections/{symbol}/holder_stats"
    headers = {
        "accept": "application/json"
    }
    try:
        response = requests.get(url, headers=headers)
        response.raise_for_status()  # Raise an exception for bad status codes
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Error fetching holder stats: {e}")
        return None

# Example usage:
# collection_symbol = 'your_collection_symbol'
# stats = get_holder_stats(collection_symbol)
# if stats:
#     print(stats)
```

--------------------------------

### Create Pool Instructions (Node.js)

Source: https://docs.magiceden.io/reference/get_instructions-mmm-create-pool-1

This Node.js snippet shows how to fetch instructions for creating a liquidity pool using the Magic Eden API. It utilizes the 'node-fetch' library to make the GET request.

```javascript
const fetch = require('node-fetch');

const url = 'https://api-mainnet.magiceden.dev/v2/instructions/mmm/create-pool?curveType=linear&reinvestBuy=true&reinvestSell=true';

fetch(url, {
  method: 'GET',
  headers: {
    'accept': 'application/json'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));
```

--------------------------------

### Create Pool Instructions (PHP)

Source: https://docs.magiceden.io/reference/get_instructions-mmm-create-pool-1

This PHP snippet shows how to fetch instructions for creating a liquidity pool using the Magic Eden API. It uses cURL to make the GET request.

```php
<?php

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, 'https://api-mainnet.magiceden.dev/v2/instructions/mmm/create-pool?curveType=linear&reinvestBuy=true&reinvestSell=true');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, array('accept: application/json'));

$response = curl_exec($curl);

if (curl_errno($curl)) {
    echo 'Error:' . curl_error($curl);
}

custom_close($curl);

echo $response;
?>
```

--------------------------------

### Get Collection Holder Stats (Ruby)

Source: https://docs.magiceden.io/reference/get_collections-symbol-holder-stats

This Ruby code snippet demonstrates how to fetch holder statistics for an NFT collection using the 'httparty' gem. It sends a GET request to the Magic Eden API endpoint, including the collection symbol in the URL.

```ruby
require 'httparty'

def get_holder_stats(symbol)
  url = "https://api-mainnet.magiceden.dev/v2/collections/#{symbol}/holder_stats"
  headers = { 'accept' => 'application/json' }
  begin
    response = HTTParty.get(url, headers: headers)
    if response.success?
      return response.parsed_response
    else
      puts "Error fetching holder stats: #{response.code} - #{response.message}"
      return nil
    end
  rescue StandardError => e
    puts "An error occurred: #{e.message}"
    return nil
  end
end

# Example usage:
# collection_symbol = 'your_collection_symbol'
# stats = get_holder_stats(collection_symbol)
# puts stats
```

--------------------------------

### Smart Contract Deployment (Anchor)

Source: https://docs.magiceden.io/reference/mmm

This code demonstrates deploying a Solana smart contract using the Anchor framework. It includes the necessary configuration and commands to compile and deploy the contract to a specified network.

```Shell
anchor deploy --provider.cluster devnet
```

--------------------------------

### GET /block/info

Source: https://docs.magiceden.io/reference/get_v2-ord-btc-raresats-listings

Retrieves metadata for a specific block on the blockchain.

```APIDOC
## GET /block/info

### Description
Retrieves the block hash, block height, and block time for a requested block.

### Method
GET

### Endpoint
/block/info

### Parameters
#### Query Parameters
- **blockHeight** (number) - Required - The height of the block to retrieve.

### Request Example
GET /block/info?blockHeight=12345

### Response
#### Success Response (200)
- **blockHash** (string) - The unique hash identifier of the block.
- **blockHeight** (number) - The height of the block.
- **blockTime** (string) - The timestamp of when the block was mined.

#### Response Example
{
  "blockHash": "0xabc123...",
  "blockHeight": 12345,
  "blockTime": "2023-10-27T10:00:00Z"
}
```
Tokens:
Raw