openapi: 3.0.1
info:
  title: Magic Eden Solana API
  description: Aggregated Magic Eden Solana NFT marketplace API covering collections, tokens, wallets, instructions (buy/sell/bid),
    MMM AMM pools, launchpad, and marketplace endpoints.
  version: v2
  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/v2
- url: https://api-devnet.magiceden.dev/v2
components:
  schemas:
    ListedNftType:
      type: string
      enum:
      - M2
      - MMM
      - TENSOR_LISTING
      - TENSOR_CNFT_LISTING
      - TENSOR_MARKETPLACE_LISTING
      - TENSOR_AMM
      - TENSOR_AMM_V2
      - HADESWAP_AMM
      - M3
    IFloorPriceInfo:
      properties:
        floorPrice:
          type: number
          format: double
        floorListedNftType:
          $ref: '#/components/schemas/ListedNftType'
      required:
      - floorPrice
      - floorListedNftType
      type: object
      additionalProperties: false
    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
    RequestMetadata:
      properties:
        paging:
          type: boolean
      type: object
      additionalProperties: false
    PagingMetadata:
      properties:
        total:
          type: number
          format: double
        start:
          type: number
          format: double
        end:
          type: number
          format: double
      required:
      - total
      - start
      - end
      type: object
      additionalProperties: false
    ResponseMetadata:
      properties:
        paging:
          $ref: '#/components/schemas/PagingMetadata'
      type: object
      additionalProperties: false
    IAttributeV2:
      properties:
        trait_type:
          type: string
        value: {}
      required:
      - trait_type
      - value
      type: object
      additionalProperties: false
    AvailableAttribute:
      properties:
        attribute:
          $ref: '#/components/schemas/IAttributeV2'
        count:
          type: number
          format: double
        floor:
          type: number
          format: double
        countByListingType:
          properties: {}
          additionalProperties:
            type: number
            format: double
          type: object
      required:
      - attribute
      - count
      - floor
      - countByListingType
      type: object
      additionalProperties: false
    CollectionAttributesResults:
      properties:
        symbol:
          type: string
        availableAttributes:
          items:
            $ref: '#/components/schemas/AvailableAttribute'
          type: array
      required:
      - symbol
      - availableAttributes
      type: object
      additionalProperties: false
    CollectionAttributes:
      properties:
        results:
          $ref: '#/components/schemas/CollectionAttributesResults'
      required:
      - results
      type: object
      additionalProperties: false
    SwaggerFriendlyTokenAmount:
      properties:
        rawAmount:
          type: string
        address:
          type: string
          description: The identifier of the amount.
        decimals:
          type: number
          format: double
          description: The number of decimals in the amount.
      required:
      - rawAmount
      - address
      - decimals
      type: object
      additionalProperties: false
    SwaggerFriendlyPriceInfo:
      properties:
        solPrice:
          $ref: '#/components/schemas/SwaggerFriendlyTokenAmount'
        splPrice:
          $ref: '#/components/schemas/SwaggerFriendlyTokenAmount'
      required:
      - solPrice
      type: object
      additionalProperties: false
    SwaggerFriendlyIActivityV2:
      properties:
        type:
          type: string
        collection:
          type: string
          deprecated: true
        image:
          type: string
        price:
          type: number
          format: double
        tokenMint:
          type: string
        seller:
          type: string
          nullable: true
        sellerReferral:
          type: string
        signature:
          type: string
        source:
          type: string
        collectionSymbol:
          type: string
        slot:
          type: number
          format: double
        blockTime:
          type: number
          format: double
        buyer:
          type: string
          nullable: true
        buyerReferral:
          type: string
        priceInfo:
          $ref: '#/components/schemas/SwaggerFriendlyPriceInfo'
      required:
      - type
      - price
      - signature
      - source
      - slot
      - blockTime
      type: object
      additionalProperties: false
    SwaggerFriendlyIIndividualHolderStats:
      properties:
        owner:
          type: string
        tokens:
          type: number
          format: double
        avatarMintImg:
          type: string
        ownerDisplay:
          properties:
            sol:
              type: string
          required:
          - sol
          type: object
      required:
      - owner
      - tokens
      type: object
      additionalProperties: false
    SwaggerFriendlyICollectionHolderStatsV2:
      properties:
        symbol:
          type: string
        tokenHistogram:
          properties:
            bars:
              items:
                properties:
                  r_val:
                    type: number
                    format: double
                  hight:
                    type: number
                    format: double
                  l_val:
                    type: number
                    format: double
                required:
                - hight
                - l_val
                type: object
              type: array
          type: object
        totalSupply:
          type: number
          format: double
        uniqueHolders:
          type: number
          format: double
        topHolders:
          items:
            $ref: '#/components/schemas/SwaggerFriendlyIIndividualHolderStats'
          type: array
      required:
      - symbol
      - tokenHistogram
      - topHolders
      type: object
      additionalProperties: false
    IPropertiesV2File:
      properties:
        uri:
          type: string
        type:
          type: string
        cdn:
          type: boolean
      required:
      - uri
      - type
      type: object
      additionalProperties: false
    Partial_ICreatorV2_:
      properties:
        address:
          type: string
        verified:
          type: boolean
        share:
          type: number
          format: double
      type: object
      description: Make all properties in T optional
    IPropertiesV2:
      properties:
        files:
          items:
            $ref: '#/components/schemas/IPropertiesV2File'
          type: array
        category:
          type: string
        creators:
          items:
            $ref: '#/components/schemas/Partial_ICreatorV2_'
          type: array
      required:
      - files
      - category
      - creators
      type: object
      additionalProperties: false
    TokenStandard:
      enum:
      - 0
      - 1
      - 2
      - 3
      - 4
      - 5
      - -1
      type: number
    SwaggerFriendlyITokenV2:
      properties:
        mintAddress:
          type: string
        owner:
          type: string
        supply:
          type: number
          format: double
        delegate:
          type: string
        collection:
          type: string
        collectionName:
          type: string
        name:
          type: string
        updateAuthority:
          type: string
        primarySaleHappened:
          type: boolean
        sellerFeeBasisPoints:
          type: number
          format: double
        image:
          type: string
        tokenStandard:
          $ref: '#/components/schemas/TokenStandard'
        animationUrl:
          type: string
        externalUrl:
          type: string
        attributes:
          items:
            $ref: '#/components/schemas/IAttributeV2'
          type: array
        properties:
          $ref: '#/components/schemas/IPropertiesV2'
        listStatus:
          type: string
          enum:
          - listed
          - unlisted
        price:
          type: number
          format: double
        tokenAddress:
          type: string
        isCompressed:
          type: boolean
        priceInfo:
          $ref: '#/components/schemas/SwaggerFriendlyPriceInfo'
      required:
      - mintAddress
      - owner
      - supply
      - name
      - updateAuthority
      - primarySaleHappened
      - sellerFeeBasisPoints
      - image
      type: object
      additionalProperties: false
    MoonrankCrawl:
      properties:
        complete:
          type: boolean
          description: 'Flag for if Moonrank has fully crawled the collection. If this is false,

            then it means the rarity values are incomplete and should not be used.'
        id:
          type: string
      type: object
      additionalProperties: false
    IXAttribute:
      properties:
        traitType:
          type: string
        value:
          type: string
        count:
          type: number
          format: double
        rarity:
          type: number
          format: double
        topBidValue:
          type: number
          format: double
        floorAskPrice:
          type: number
          format: double
        onSaleCount:
          type: number
          format: double
      required:
      - traitType
      - value
      type: object
      additionalProperties: false
    MeTokenRarity:
      properties:
        tokenKey:
          type: string
        score:
          type: number
          format: double
        rank:
          type: number
          format: double
        totalSupply:
          type: number
          format: double
        attributeWithCounts:
          items:
            $ref: '#/components/schemas/IXAttribute'
          type: array
      required:
      - tokenKey
      - score
      type: object
      additionalProperties: false
    MeInstantRarity:
      properties:
        rank:
          type: number
          format: double
      required:
      - rank
      type: object
      additionalProperties: false
    NFTRarity:
      properties:
        howrare:
          properties:
            rank:
              type: number
              format: double
          required:
          - rank
          type: object
        moonrank:
          properties:
            crawl:
              $ref: '#/components/schemas/MoonrankCrawl'
            absolute_rarity:
              type: number
              format: double
            rank:
              type: number
              format: double
          required:
          - crawl
          - absolute_rarity
          - rank
          type: object
        merarity:
          $ref: '#/components/schemas/MeTokenRarity'
        meInstant:
          $ref: '#/components/schemas/MeInstantRarity'
      type: object
      additionalProperties: false
    IExtraPublicInfo:
      properties:
        img:
          type: string
      type: object
      additionalProperties: false
    SwaggerFriendlyIListingV2:
      properties:
        price:
          type: number
          format: double
        tokenAddress:
          type: string
        pdaAddress:
          type: string
        auctionHouse:
          type: string
        tokenMint:
          type: string
        seller:
          type: string
        sellerReferral:
          type: string
        tokenSize:
          type: number
          format: double
        rarity:
          $ref: '#/components/schemas/NFTRarity'
        extra:
          $ref: '#/components/schemas/IExtraPublicInfo'
        expiry:
          type: number
          format: double
        listingSource:
          $ref: '#/components/schemas/ListedNftType'
        priceInfo:
          $ref: '#/components/schemas/SwaggerFriendlyPriceInfo'
        token:
          $ref: '#/components/schemas/SwaggerFriendlyITokenV2'
      required:
      - price
      - tokenAddress
      - pdaAddress
      - auctionHouse
      - tokenMint
      - seller
      - tokenSize
      - rarity
      - expiry
      - listingSource
      - token
      type: object
      additionalProperties: false
    SwaggerNftAttribute:
      properties:
        traitType:
          type: string
        value:
          type: string
      required:
      - traitType
      - value
      type: object
      additionalProperties: false
    SwaggerNftAttributeSchema:
      items:
        items:
          $ref: '#/components/schemas/SwaggerNftAttribute'
        type: array
      type: array
    SortDirQuery:
      type: string
      enum:
      - asc
      - desc
    ListingSortOptions:
      type: string
      enum:
      - updatedAt
      - listPrice
    CollectionStats:
      properties:
        symbol:
          type: string
        floorPrice:
          type: number
          format: double
        listedCount:
          type: number
          format: double
        avgPrice24hr:
          type: number
          format: double
        volumeAll:
          type: number
          format: double
      required:
      - symbol
      type: object
      additionalProperties: false
    BatchListings:
      properties:
        result:
          items:
            $ref: '#/components/schemas/SwaggerFriendlyIListingV2'
          type: array
        nextCursor:
          type: string
      required:
      - result
      - nextCursor
      type: object
      additionalProperties: false
    IBuffer:
      properties:
        type:
          type: string
          enum:
          - Buffer
          nullable: false
        data:
          items:
            type: number
            format: double
          type: array
      required:
      - type
      - data
      type: object
      additionalProperties: false
    Transaction:
      properties:
        tx:
          $ref: '#/components/schemas/IBuffer'
        txSigned:
          $ref: '#/components/schemas/IBuffer'
      required:
      - tx
      type: object
      additionalProperties: false
    ILaunchpadCollectionV2:
      properties:
        symbol:
          type: string
        name:
          type: string
        description:
          type: string
        featured:
          type: boolean
        image:
          type: string
        price:
          type: number
          format: double
        size:
          type: number
          format: double
        launchDatetime:
          type: string
          description: Launch date time in simplified extended ISO format
        chainId:
          type: string
          description: Stringified EVM chain id, or "solana" for SOL launches
        contractAddress:
          type: string
          description: Candy machine id on SOL, contract address for EVM
      required:
      - symbol
      - name
      - description
      - image
      - chainId
      type: object
      additionalProperties: false
    PopularCollectionsTimeRanges:
      type: string
      enum:
      - 1h
      - 1d
      - 7d
      - 30d
    MMM.CurveKindString:
      type: string
      enum:
      - linear
      - exp
      - xyk
    MMM.PoolTypeString:
      type: string
      enum:
      - buy_sided
      - sell_sided
      - two_sided
      - invalid
    ISharedEscrowInfo:
      properties:
        sharedEscrowAddress:
          type: string
        sharedEscrowCount:
          type: number
          format: double
        sharedEscrowBuysidePaymentAmount:
          type: number
          format: double
      required:
      - sharedEscrowAddress
      - sharedEscrowCount
      - sharedEscrowBuysidePaymentAmount
      type: object
      additionalProperties: false
    Pick_IMmmPoolV2.Exclude_keyofIMmmPoolV2.updatedAt__:
      properties:
        collectionName:
          type: string
        attributes:
          items:
            items:
              $ref: '#/components/schemas/IAttributeV2'
            type: array
          type: array
        expiry:
          type: number
          format: double
        collectionSymbol:
          type: string
        spotPrice:
          type: number
          format: double
        curveType:
          $ref: '#/components/schemas/MMM.CurveKindString'
        curveDelta:
          type: number
          format: double
        reinvestFulfillBuy:
          type: boolean
        reinvestFulfillSell:
          type: boolean
        lpFeeBp:
          type: number
          format: double
        buysideCreatorRoyaltyBp:
          type: number
          format: double
        poolOwner:
          type: string
        sellsideAssetAmount:
          type: number
          format: double
        buysidePaymentAmount:
          type: number
          format: double
        buyOrdersAmount:
          type: number
          format: double
          description: quantity of buy orders
        poolType:
          $ref: '#/components/schemas/MMM.PoolTypeString'
          description: can be buy_sided, sell_sided, two_sided
        uuid:
          type: string
        poolKey:
          type: string
        cosigner:
          type: string
        blockedAt:
          type: string
          format: date-time
        mints:
          items:
            type: string
          type: array
        collectionSellerFeeBasisPoints:
          type: number
          format: double
        lpFeeEarned:
          type: number
          format: double
        buyPriceTaker:
          type: number
          format: double
        isMIP1:
          type: boolean
        isOCP:
          type: boolean
        sharedEscrowInfo:
          $ref: '#/components/schemas/ISharedEscrowInfo'
      required:
      - collectionName
      - expiry
      - collectionSymbol
      - spotPrice
      - curveType
      - curveDelta
      - reinvestFulfillBuy
      - reinvestFulfillSell
      - lpFeeBp
      - buysideCreatorRoyaltyBp
      - poolOwner
      - sellsideAssetAmount
      - buysidePaymentAmount
      - buyOrdersAmount
      - poolType
      - uuid
      - poolKey
      - cosigner
      - collectionSellerFeeBasisPoints
      - lpFeeEarned
      type: object
      description: From T, pick a set of properties whose keys are in the union K
    Omit_IMmmPoolV2.updatedAt_:
      $ref: '#/components/schemas/Pick_IMmmPoolV2.Exclude_keyofIMmmPoolV2.updatedAt__'
      description: Construct a type with the properties of T except for those in type K.
    IMmmPoolV2Response:
      properties:
        results:
          items:
            allOf:
            - $ref: '#/components/schemas/Omit_IMmmPoolV2.updatedAt_'
            - properties:
                updatedAt:
                  type: string
              required:
              - updatedAt
              type: object
          type: array
      required:
      - results
      type: object
    FieldOptions:
      type: string
      enum:
      - '0'
      - '1'
      - '2'
      - '5'
      nullable: false
    DirectionOptions:
      type: string
      enum:
      - '0'
      - '1'
      - '2'
      nullable: false
    IOfferV2:
      properties:
        pdaAddress:
          type: string
        tokenMint:
          type: string
        auctionHouse:
          type: string
        buyer:
          type: string
        buyerReferral:
          type: string
        tokenSize:
          type: number
          format: double
        price:
          type: number
          format: double
        expiry:
          type: number
          format: double
      required:
      - pdaAddress
      - tokenMint
      - auctionHouse
      - buyer
      - tokenSize
      - price
      - expiry
      type: object
      additionalProperties: false
    OfferReceivedSort:
      type: string
      enum:
      - updatedAt
      - bidAmount
    IWalletOwnerInfo:
      properties:
        walletAddress:
          type: string
        displayName:
          type: string
        avatar:
          type: string
        bio:
          type: string
      required:
      - walletAddress
      type: object
      additionalProperties: false
    EscrowBalance:
      properties:
        buyerEscrow:
          type: string
        balance:
          type: number
          format: double
      required:
      - buyerEscrow
      - balance
      type: object
      additionalProperties: false
    ListStatus:
      type: string
      enum:
      - listed
      - unlisted
      - both
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
    bearerAuth:
      bearerFormat: auth-scheme
      description: 'Bearer HTTP authentication. Allowed headers-- Authorization: Bearer <api_key>'
      scheme: bearer
      type: http
tags:
- name: collections
  description: Get information of collections
- name: instructions
  description: Get instructions for the blockchain
- name: launchpad
  description: Get launchpad information
- name: marketplace
  description: Get information about Magic Eden's marketplace!
- name: mmm
  description: Get AMM information
- name: tokens
  description: Get information of a token / NFT
- name: wallets
  description: Get information of a wallet
paths:
  /collections:
    get:
      deprecated: false
      summary: Get collections
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ICollectionV2'
              example:
              - symbol: trippinshrooms
                name: Trippin Shrooms
                description: 'A collection of 555 NFTs spreading some love across the Solana blockchain.


                  No roadmap, no promises just awesome vibes!'
                image: https://arweave.net/PO6QTMV1xuQjWPCgZFe7wSuVtmtNGiK3zRM4jsEL4ao
                twitter: https://www.twitter.com/Trippin_Shrooms
                discord: https://www.discord.gg/zPqyBpRNXd
                categories:
                - pfps
                - art
              - symbol: shadow_lords
                name: Shadow Lords
                description: When darkness falls, Shadow Lords reign supreme.
                image: https://creator-hub-prod.s3.us-east-2.amazonaws.com/shadow_lords_pfp_1656315133604.gif
                twitter: https://www.twitter.com/ShadowLordsNFT
                discord: https://www.discord.gg/9JNJWYBGBu
                website: ''
                categories:
                - pfps
                - art
          headers:
            ME-Pub-API-Metadata:
              description: Will return paging metadata if requested
              schema:
                $ref: '#/components/schemas/ResponseMetadata'
      parameters:
      - name: ME-Pub-API-Metadata
        in: header
        description: This endpoint supports paging metadata
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/RequestMetadata'
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 200, min 1, max 500
        required: false
        deprecated: false
        schema:
          type: integer
      tags:
      - collections
  /collections/{collectionSymbol}/attributes:
    get:
      deprecated: false
      summary: Get attributes of a collection
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionAttributes'
        '400':
          description: Invalid symbol
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Collection not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: collectionSymbol
        in: path
        description: collection symbol
        required: true
        deprecated: false
        schema:
          type: string
      tags:
      - collections
  /collections/{symbol}/activities:
    get:
      deprecated: false
      summary: Get activities of a collection
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SwaggerFriendlyIActivityV2'
              example:
              - signature: ntGRVYH31VtYYatGmax4evUAdEejh2bHRCUR9Fwe1mjMQYDVBngbxRf3ATDwUyeKoMwJD7SA6sEDQYj4T34qufo
                type: list
                source: magiceden_v2
                tokenMint: Hn35U1k6N8ZJ4ToAKxJvwwb5iyoNb6crxChK186AtRp5
                collection: magicticket
                collectionSymbol: magicticket
                slot: 139232690
                blockTime: 1656332000
                buyer: null
                buyerReferral: ''
                seller: JB9knFr8FkiT5vRf3U2UKTdyWnkotG2MYmBnR1HuhLXv
                sellerReferral: ''
                price: 5.1
              - signature: 3aaYEqfiJmwuQ7cSDQtiQs8iCqTsVLjrNR5fNzH82aLZpH2n7PsfUKv4peZyjJd1NgysV2qhCouA1woranzeArmD
                type: list
                source: magiceden_v2
                tokenMint: 2DXPYVMF2Urc11Pi5UGsZPBqYqBb1vNYy71TpuMBFXTd
                collection: magicticket
                collectionSymbol: magicticket
                slot: 139232688
                blockTime: 1656331999
                buyer: null
                buyerReferral: ''
                seller: JB9knFr8FkiT5vRf3U2UKTdyWnkotG2MYmBnR1HuhLXv
                sellerReferral: ''
                price: 5.05
        '400':
          description: Invalid symbol
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: symbol
        in: path
        description: collection symbol
        required: true
        deprecated: false
        schema:
          type: string
        example: btest
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 100, min 1, max 1000
        required: false
        deprecated: false
        schema:
          type: integer
      tags:
      - collections
  /collections/{symbol}/holder_stats:
    get:
      deprecated: false
      summary: Get holder stats of a collection
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SwaggerFriendlyICollectionHolderStatsV2'
              example:
                symbol: magicticket
                totalSupply: 30662
                uniqueHolders: 19989
                tokenHistogram:
                  bars:
                  - l_val: 1
                    hight: 17625
                  - l_val: 2
                    hight: 2023
                  - l_val: 6
                    hight: 276
                  - l_val: 25
                    hight: 34
                  - l_val: 50
                    hight: 32
                topHolders:
                - tokens: 491
                  owner: 74Vzf7H6F4fYtyUDAPsUyRLpKFgA95PC3Hxv6HDMzZkB
                  ownerDisplay:
                    sol: testName
                - tokens: 375
                  owner: ApLq7vqXswhpecF85MNhY2Zoj3sTbuLXpUgiY3wmwacj
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 319
                  owner: 3D3jTdYc1QwT4PgHqFMhFgTWpBiHVvQGC8r154cnF65L
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 295
                  owner: pikbd74fyjELkW8Xt9aeDf6oQZbKsdwqmSsxR3eJEzH
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 199
                  owner: DPhBRMQJyCRKPrbY7Yi7J3u61KNkecSB17FytSuvu1VV
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 174
                  owner: 6HL9R6k3jy6vr2ELycBWv3HcUcVfpEv1ZKfLvkfcZSkX
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 156
                  owner: GJvu3coUrkqTGMomAKmNdRqKaEaZrhLss3KUFpdcsr6F
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 134
                  owner: 5k5P9oEkeSbLa2NvXtHWhdLSRkz8zctSYoMrpdHQso24
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 111
                  owner: BruKPymvNxe8tyAZ24qV4WX1LhZ3DkuA7tAa8wNpEbbN
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 107
                  owner: 9fzxydhgTTPgfmkhZLkrESXnj2GYB4h89YqX3RiAQvdZ
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 98
                  owner: 4FbCC89pNRcX3t4kTXuiKXW6LrMTCZNVsyfHiUrEvn5R
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 96
                  owner: B8T5kw3VzpryjigyTkxce7jshSAC8TXBWD1kYMW62Cwx
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 92
                  owner: 9L7bB2baDcRsyxgj1tUbyL1cmXp7KsAKgYArWdfBxZJm
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 87
                  owner: GdMZBAhi181dduNCPDqLb7GLcpyBqvKHPixRZiTj7iKW
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 86
                  owner: 6aL8gF1dCCZiyeuqjzqHozJGNTp7KVjogjWUdMrTxm29
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 85
                  owner: HwuBTkReWdd9Ceoud52NCfhyBsGhPiFDnox7jgES7M3o
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 85
                  owner: AAoaMhv9vxGZhp4AZvxuza2FZJJNtEgWp3bm2aqkgPJ1
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 82
                  owner: 4HVo14THtjrENSsibnUCZFTgMzmsA5d5XTNG1a2Ae5FQ
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 77
                  owner: 8ZWy2E1uMEngWt68TR6xgnSKu441wb2c5xWRptF4bZdg
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 74
                  owner: Aok6SNAqmqy2Hhod9VD4jY9VXUVaaiTBBPF3nHT6V79U
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 71
                  owner: 3S4WYxbPnzzFhwvtL3jejTsFhhupvdyx1FH699E7aZ5e
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 70
                  owner: 2TMzcRk2d6V8aqjKSRVuwtBfkP4i3si6MHDG8YpEn6qG
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 66
                  owner: GHAEXyW1zZnk8ignwryaRnUA2czkTp1kYZPCcYmMQCQB
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 63
                  owner: 9oVgU4qyN7kVNJPA43vkSXdYwEeQdCRpXwbCv47Nf93C
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 59
                  owner: EgqTxbFfcbPMcoUyBcfBDfxcRSsm9s3qSpX3CtNJkAJT
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 58
                  owner: C45tbZRx36qbRWAQuifrocVg3XeyEALrsegqrT4wbE2f
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 57
                  owner: CToMigeH6Nu8sD7y9YDD1U8dedpF6bBKTCxzCj335r12
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 56
                  owner: Dduv1mpbKDvroYnaVDm3HQq9X8rtqxsJ1a4qPVDTC1kY
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 55
                  owner: FYu1XyfhaQQvuWGbf2xmBmjrQpzNgVwHhAhi9Kaz73P1
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 53
                  owner: CmvNNpdGVDGujBadaMmgKc8xgFfyV6G9PNEjD8zEND6L
                  ownerDisplay:
                    sol: sns-display-name
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: symbol
        in: path
        description: collection symbol
        required: true
        deprecated: false
        schema:
          type: string
      tags:
      - collections
  /collections/{symbol}/leaderboard:
    get:
      deprecated: false
      summary: Get wallets rank sorted by volume for one collection
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SwaggerFriendlyICollectionHolderStatsV2'
              example:
                symbol: magicticket
                totalSupply: 30662
                uniqueHolders: 19989
                tokenHistogram:
                  bars:
                  - l_val: 1
                    hight: 17625
                  - l_val: 2
                    hight: 2023
                  - l_val: 6
                    hight: 276
                  - l_val: 25
                    hight: 34
                  - l_val: 50
                    hight: 32
                topHolders:
                - tokens: 491
                  owner: 74Vzf7H6F4fYtyUDAPsUyRLpKFgA95PC3Hxv6HDMzZkB
                  ownerDisplay:
                    sol: testName
                - tokens: 375
                  owner: ApLq7vqXswhpecF85MNhY2Zoj3sTbuLXpUgiY3wmwacj
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 319
                  owner: 3D3jTdYc1QwT4PgHqFMhFgTWpBiHVvQGC8r154cnF65L
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 295
                  owner: pikbd74fyjELkW8Xt9aeDf6oQZbKsdwqmSsxR3eJEzH
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 199
                  owner: DPhBRMQJyCRKPrbY7Yi7J3u61KNkecSB17FytSuvu1VV
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 174
                  owner: 6HL9R6k3jy6vr2ELycBWv3HcUcVfpEv1ZKfLvkfcZSkX
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 156
                  owner: GJvu3coUrkqTGMomAKmNdRqKaEaZrhLss3KUFpdcsr6F
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 134
                  owner: 5k5P9oEkeSbLa2NvXtHWhdLSRkz8zctSYoMrpdHQso24
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 111
                  owner: BruKPymvNxe8tyAZ24qV4WX1LhZ3DkuA7tAa8wNpEbbN
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 107
                  owner: 9fzxydhgTTPgfmkhZLkrESXnj2GYB4h89YqX3RiAQvdZ
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 98
                  owner: 4FbCC89pNRcX3t4kTXuiKXW6LrMTCZNVsyfHiUrEvn5R
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 96
                  owner: B8T5kw3VzpryjigyTkxce7jshSAC8TXBWD1kYMW62Cwx
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 92
                  owner: 9L7bB2baDcRsyxgj1tUbyL1cmXp7KsAKgYArWdfBxZJm
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 87
                  owner: GdMZBAhi181dduNCPDqLb7GLcpyBqvKHPixRZiTj7iKW
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 86
                  owner: 6aL8gF1dCCZiyeuqjzqHozJGNTp7KVjogjWUdMrTxm29
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 85
                  owner: HwuBTkReWdd9Ceoud52NCfhyBsGhPiFDnox7jgES7M3o
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 85
                  owner: AAoaMhv9vxGZhp4AZvxuza2FZJJNtEgWp3bm2aqkgPJ1
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 82
                  owner: 4HVo14THtjrENSsibnUCZFTgMzmsA5d5XTNG1a2Ae5FQ
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 77
                  owner: 8ZWy2E1uMEngWt68TR6xgnSKu441wb2c5xWRptF4bZdg
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 74
                  owner: Aok6SNAqmqy2Hhod9VD4jY9VXUVaaiTBBPF3nHT6V79U
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 71
                  owner: 3S4WYxbPnzzFhwvtL3jejTsFhhupvdyx1FH699E7aZ5e
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 70
                  owner: 2TMzcRk2d6V8aqjKSRVuwtBfkP4i3si6MHDG8YpEn6qG
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 66
                  owner: GHAEXyW1zZnk8ignwryaRnUA2czkTp1kYZPCcYmMQCQB
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 63
                  owner: 9oVgU4qyN7kVNJPA43vkSXdYwEeQdCRpXwbCv47Nf93C
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 59
                  owner: EgqTxbFfcbPMcoUyBcfBDfxcRSsm9s3qSpX3CtNJkAJT
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 58
                  owner: C45tbZRx36qbRWAQuifrocVg3XeyEALrsegqrT4wbE2f
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 57
                  owner: CToMigeH6Nu8sD7y9YDD1U8dedpF6bBKTCxzCj335r12
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 56
                  owner: Dduv1mpbKDvroYnaVDm3HQq9X8rtqxsJ1a4qPVDTC1kY
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 55
                  owner: FYu1XyfhaQQvuWGbf2xmBmjrQpzNgVwHhAhi9Kaz73P1
                  ownerDisplay:
                    sol: sns-display-name
                - tokens: 53
                  owner: CmvNNpdGVDGujBadaMmgKc8xgFfyV6G9PNEjD8zEND6L
                  ownerDisplay:
                    sol: sns-display-name
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: symbol
        in: path
        description: collection symbol
        required: true
        deprecated: false
        schema:
          type: string
      - name: limit
        in: query
        description: The numbers of items to return, default 100, min 1, max 100
        required: false
        deprecated: false
        schema:
          type: integer
      tags:
      - collections
  /collections/{symbol}/listings:
    get:
      deprecated: false
      summary: Get listings of a collection
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SwaggerFriendlyIListingV2'
              example:
              - pdaAddress: DH4GmB44wrCHp1GnhWLFbBd4bsjSM6WyjZiY5s8TM2QW
                auctionHouse: E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe
                tokenAddress: J61sq4dZidoX27mFo3QNoCNo3Zh4Jnqfwg7udo5Nr81a
                tokenMint: HqRZKSAWHig98928x6jezNxUUmwY8VrHn1WF6NzeVU27
                seller: EMs8aMgETr2CnZtKihiH1xLa3mtGe7cN3nFkBKSWfp6P
                sellerReferral: autMW8SgBkVYeBgqYiTuJZnkvDZMVU2MHJh9Jh7CSQ2
                tokenSize: 1
                price: 2.87
                rarity: {}
                extra:
                  img: https://bafybeihr7vi77syiup5o4avvzemhlp4v4nplpc23haderjcjkkzgah2a5u.ipfs.dweb.link/0.gif?ext=gif
                expiry: -1
                token:
                  mintAddress: G5pULE3aTgGaVuFmABiYHsFrZqmZmjBKA3nMsQoKbnjb
                  owner: udQA9PjJA9vUMKEpeDUYUD6y84ZRaphRf1tWTCng8SM
                  supply: 1
                  collection: magicticket
                  name: 'Magic Ticket: OG #7354'
                  updateAuthority: 2PB2jBx5Trwxcv3Cn3yzw8acc6kdZDHABkp6QbsFraya
                  primarySaleHappened: true
                  sellerFeeBasisPoints: 500
                  image: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                  animationUrl: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.mp4
                  externalUrl: https://magiceden.io
                  attributes:
                  - trait_type: Level
                    value: 3
                  - trait_type: Tier
                    value: OG
                  properties:
                    category: video
                    files:
                    - uri: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.mp4?ext=mp4
                      type: video/mp4
                    - uri: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                      type: image/png
                    creators:
                    - address: RRUMF9KYPcvNSmnicNMAFKx5wDYix3wjNa6bA7R6xqA
                      share: 95
                    - address: mdaoMkGbmV2udu6wpzv4LhQ6fwcHudP4whu1r1k2Jac
                      share: 5
                listingSource: M2
              - pdaAddress: CLAUb44eYwX6kWmydJDSxfuZCzFACCQfefzMzuApvrhv
                auctionHouse: E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe
                tokenAddress: 86LEHMJs63wjWZ9Z1ZbJx47vAptsDo88SG7F4BSNvwD6
                tokenMint: 5qiToEtKs4uf2CAxYxCM7RQXqbKK9Hd8XEe9XR7k2jG8
                seller: DD7QCur1hMdq8DEESwuAKviCpXmesXUpMDx54AXXHLLH
                sellerReferral: autMW8SgBkVYeBgqYiTuJZnkvDZMVU2MHJh9Jh7CSQ2
                tokenSize: 1
                price: 9
                rarity: {}
                extra:
                  img: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                expiry: -1
                token:
                  mintAddress: EU6muWpunxdVqA1QPYrSGn6kJEojWimWkBDTmY3bvFtM
                  owner: ABpA7SJJURVo4g3U7cVLA17JLT7NHn1R8Q7RmMKcApEF
                  supply: 1
                  collection: magicticket
                  name: 'Magic Ticket: OG #618'
                  updateAuthority: 2PB2jBx5Trwxcv3Cn3yzw8acc6kdZDHABkp6QbsFraya
                  primarySaleHappened: true
                  sellerFeeBasisPoints: 500
                  image: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                  animationUrl: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.mp4
                  externalUrl: https://magiceden.io
                  attributes:
                  - trait_type: Level
                    value: 3
                  - trait_type: Tier
                    value: OG
                  properties:
                    category: video
                    files:
                    - uri: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.mp4?ext=mp4
                      type: video/mp4
                    - uri: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                      type: image/png
                    creators:
                    - address: RRUMF9KYPcvNSmnicNMAFKx5wDYix3wjNa6bA7R6xqA
                      share: 95
                    - address: mdaoMkGbmV2udu6wpzv4LhQ6fwcHudP4whu1r1k2Jac
                      share: 5
                listingSource: M2
        '400':
          description: Invalid symbol
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: symbol
        in: path
        description: collection symbol
        required: true
        deprecated: false
        schema:
          type: string
        example: btest
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 20, min 1, max 100
        required: false
        deprecated: false
        schema:
          type: integer
      - name: min_price
        in: query
        description: Filter listings that are less than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: max_price
        in: query
        description: Filter listings that are more than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: attributes
        in: query
        description: 'Represents a filtering mechanism where the elements within each inner array are logically ORed, and
          the resulting arrays are ANDed together at the top level. Each inner array consists of objects with two properties:
          traitType (a string) and value (a string). For example: [[{"traitType":"trait1", "value":"value1"},{"traitType":"trait1",
          "value":"value2"}]] would return listings that have "value1" OR "value2" for "trait1".'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/SwaggerNftAttributeSchema'
      - name: sort
        in: query
        description: The field to sort the listings, default 'listPrice'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/ListingSortOptions'
      - name: listingAggMode
        in: query
        description: True to return aggregated marketplace listings, false to return just Magic Eden listings.
        required: false
        deprecated: false
        schema:
          type: boolean
      - name: sort_direction
        in: query
        description: The direction returned elements should be sorted in, default 'asc'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/SortDirQuery'
      - name: paymentMints
        in: query
        description: Filter listings by the payment mint address that the seller expects. Default to filter for listings that
          only accept native SOL. Use "ALL" to show all listings.
        required: false
        deprecated: false
        schema:
          type: array
          items:
            type: string
      tags:
      - collections
  /collections/{symbol}/stats:
    get:
      deprecated: false
      summary: Get stats of a collection
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionStats'
              example:
                symbol: magicticket
                floorPrice: 2850000000
                listedCount: 877
                avgPrice24hr: 3009962636.8159204
                volumeAll: 76113329022113
        '400':
          description: Invalid symbol
          content:
            application/json:
              schema:
                type: object
        '404':
          description: Collection not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: symbol
        in: path
        description: collection symbol
        required: true
        deprecated: false
        schema:
          type: string
      - name: timeWindow
        in: query
        description: Time window for stats, default all. '24h', '7d', '30d', 'all'
        required: false
        deprecated: false
        schema:
          type: string
      - name: listingAggMode
        in: query
        description: True to return aggregated marketplace listings, false to return just Magic Eden listings. Defaults to
          false.
        required: false
        deprecated: false
        schema:
          type: boolean
      tags:
      - collections
  /collections/batch/listings:
    post:
      deprecated: false
      summary: Get batch listings of a collection
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BatchListings'
              example:
              - pdaAddress: DH4GmB44wrCHp1GnhWLFbBd4bsjSM6WyjZiY5s8TM2QW
                auctionHouse: E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe
                tokenAddress: J61sq4dZidoX27mFo3QNoCNo3Zh4Jnqfwg7udo5Nr81a
                tokenMint: HqRZKSAWHig98928x6jezNxUUmwY8VrHn1WF6NzeVU27
                seller: EMs8aMgETr2CnZtKihiH1xLa3mtGe7cN3nFkBKSWfp6P
                sellerReferral: autMW8SgBkVYeBgqYiTuJZnkvDZMVU2MHJh9Jh7CSQ2
                tokenSize: 1
                price: 2.87
                rarity: {}
                extra:
                  img: https://bafybeihr7vi77syiup5o4avvzemhlp4v4nplpc23haderjcjkkzgah2a5u.ipfs.dweb.link/0.gif?ext=gif
                expiry: -1
                token:
                  mintAddress: G5pULE3aTgGaVuFmABiYHsFrZqmZmjBKA3nMsQoKbnjb
                  owner: udQA9PjJA9vUMKEpeDUYUD6y84ZRaphRf1tWTCng8SM
                  supply: 1
                  collection: magicticket
                  name: 'Magic Ticket: OG #7354'
                  updateAuthority: 2PB2jBx5Trwxcv3Cn3yzw8acc6kdZDHABkp6QbsFraya
                  primarySaleHappened: true
                  sellerFeeBasisPoints: 500
                  image: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                  animationUrl: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.mp4
                  externalUrl: https://magiceden.io
                  attributes:
                  - trait_type: Level
                    value: 3
                  - trait_type: Tier
                    value: OG
                  properties:
                    category: video
                    files:
                    - uri: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.mp4?ext=mp4
                      type: video/mp4
                    - uri: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                      type: image/png
                    creators:
                    - address: RRUMF9KYPcvNSmnicNMAFKx5wDYix3wjNa6bA7R6xqA
                      share: 95
                    - address: mdaoMkGbmV2udu6wpzv4LhQ6fwcHudP4whu1r1k2Jac
                      share: 5
                listingSource: M2
              - pdaAddress: CLAUb44eYwX6kWmydJDSxfuZCzFACCQfefzMzuApvrhv
                auctionHouse: E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe
                tokenAddress: 86LEHMJs63wjWZ9Z1ZbJx47vAptsDo88SG7F4BSNvwD6
                tokenMint: 5qiToEtKs4uf2CAxYxCM7RQXqbKK9Hd8XEe9XR7k2jG8
                seller: DD7QCur1hMdq8DEESwuAKviCpXmesXUpMDx54AXXHLLH
                sellerReferral: autMW8SgBkVYeBgqYiTuJZnkvDZMVU2MHJh9Jh7CSQ2
                tokenSize: 1
                price: 9
                rarity: {}
                extra:
                  img: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                expiry: -1
                token:
                  mintAddress: EU6muWpunxdVqA1QPYrSGn6kJEojWimWkBDTmY3bvFtM
                  owner: ABpA7SJJURVo4g3U7cVLA17JLT7NHn1R8Q7RmMKcApEF
                  supply: 1
                  collection: magicticket
                  name: 'Magic Ticket: OG #618'
                  updateAuthority: 2PB2jBx5Trwxcv3Cn3yzw8acc6kdZDHABkp6QbsFraya
                  primarySaleHappened: true
                  sellerFeeBasisPoints: 500
                  image: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                  animationUrl: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.mp4
                  externalUrl: https://magiceden.io
                  attributes:
                  - trait_type: Level
                    value: 3
                  - trait_type: Tier
                    value: OG
                  properties:
                    category: video
                    files:
                    - uri: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.mp4?ext=mp4
                      type: video/mp4
                    - uri: https://bafybeihlkgqlslyayv3u5c6ix4tuis27jp6mrapyfqjosgwaqb7prickbi.ipfs.dweb.link/0.gif?ext=gif
                      type: image/png
                    creators:
                    - address: RRUMF9KYPcvNSmnicNMAFKx5wDYix3wjNa6bA7R6xqA
                      share: 95
                    - address: mdaoMkGbmV2udu6wpzv4LhQ6fwcHudP4whu1r1k2Jac
                      share: 5
                listingSource: M2
        '400':
          description: Invalid symbol
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 20, min 1, max 100
        required: false
        deprecated: false
        schema:
          type: integer
      - name: min_price
        in: query
        description: Filter listings that are less than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: max_price
        in: query
        description: Filter listings that are more than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: attributes
        in: query
        description: 'Represents a filtering mechanism where the elements within each inner array are logically ORed, and
          the resulting arrays are ANDed together at the top level. Each inner array consists of objects with two properties:
          traitType (a string) and value (a string). For example: [[{"traitType":"trait1", "value":"value1"},{"traitType":"trait1",
          "value":"value2"}]] would return listings that have "value1" OR "value2" for "trait1".'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/SwaggerNftAttributeSchema'
      - name: sort
        in: query
        description: The field to sort the listings, default 'listPrice'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/ListingSortOptions'
      - name: sort_direction
        in: query
        description: The direction returned elements should be sorted in, default 'asc'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/SortDirQuery'
      - name: listingAggMode
        in: query
        description: True to return aggregated marketplace listings, false to return just Magic Eden listings.
        required: false
        deprecated: false
        schema:
          type: boolean
      tags:
      - collections
  /instructions/buy:
    get:
      deprecated: false
      summary: Get instruction to buy (bid)
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: buyer
        in: query
        description: Buyer wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: tokenMint
        in: query
        description: Token mint address
        required: true
        deprecated: false
        schema:
          type: string
      - name: price
        in: query
        description: Price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: buyerReferral
        in: query
        description: Buyer referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: expiry
        in: query
        description: timestamp in seconds in the future, 0 will default to 7 days.
        required: false
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /instructions/buy_cancel:
    get:
      deprecated: false
      summary: Get instruction to cancel a buy
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: buyer
        in: query
        description: Buyer wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: tokenMint
        in: query
        description: Token mint address
        required: true
        deprecated: false
        schema:
          type: string
      - name: price
        in: query
        description: Price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: buyerReferral
        in: query
        description: Buyer referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: expiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: false
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      - name: prioFeeMicroLamports
        in: query
        description: Priority fee in microlamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: maxPrioFeeLamports
        in: query
        description: Maximum priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: exactPrioFeeLamports
        in: query
        description: Exact priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /instructions/buy_change_price:
    get:
      deprecated: false
      summary: Get instruction to change a buy price
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: buyer
        in: query
        description: Buyer wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: tokenMint
        in: query
        description: Token mint address
        required: true
        deprecated: false
        schema:
          type: string
      - name: price
        in: query
        description: Old price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: newPrice
        in: query
        description: New price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: buyerReferral
        in: query
        description: Buyer referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: expiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: false
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /instructions/buy_now:
    get:
      deprecated: false
      summary: Get instruction to buy now
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: buyer
        in: query
        description: Buyer wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: seller
        in: query
        description: Seller wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: tokenMint
        in: query
        description: Token mint address
        required: true
        deprecated: false
        schema:
          type: string
      - name: tokenATA
        in: query
        description: Associate Token Account
        required: true
        deprecated: false
        schema:
          type: string
      - name: price
        in: query
        description: Price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: buyerReferral
        in: query
        description: Buyer referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: sellerReferral
        in: query
        description: Seller referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: buyerExpiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: false
        deprecated: false
        schema:
          type: number
      - name: sellerExpiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: true
        deprecated: false
        schema:
          type: number
      - name: buyerCreatorRoyaltyPercent
        in: query
        description: buyerCreatorRoyaltyPercent, integer 0-100
        required: false
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      - name: prioFeeMicroLamports
        in: query
        description: Priority fee in microlamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: maxPrioFeeLamports
        in: query
        description: Maximum priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: exactPrioFeeLamports
        in: query
        description: Exact priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: splPrice
        in: query
        description: SPL token price information (JSON string)
        required: false
        deprecated: false
        schema:
          type: string
      tags:
      - instructions
  /instructions/buy_now_transfer_nft:
    get:
      deprecated: false
      summary: Get instruction to buy now and transfer nft to another owner
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: buyer
        in: query
        description: Buyer wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: seller
        in: query
        description: Seller wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: tokenMint
        in: query
        description: Token mint address
        required: true
        deprecated: false
        schema:
          type: string
      - name: tokenATA
        in: query
        description: Associate Token Account
        required: true
        deprecated: false
        schema:
          type: string
      - name: price
        in: query
        description: Price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: destinationATA
        in: query
        description: Associated token account to send bought NFT to
        required: true
        deprecated: false
        schema:
          type: string
      - name: destinationOwner
        in: query
        description: Owner of token account
        required: true
        deprecated: false
        schema:
          type: string
      - name: createATA
        in: query
        description: whether to include create ATA instructions
        required: true
        deprecated: false
        schema:
          type: boolean
      - name: buyerReferral
        in: query
        description: Buyer referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: sellerReferral
        in: query
        description: Seller referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: buyerExpiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: false
        deprecated: false
        schema:
          type: number
      - name: sellerExpiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: true
        deprecated: false
        schema:
          type: number
      - name: buyerCreatorRoyaltyPercent
        in: query
        description: buyerCreatorRoyaltyPercent, integer 0-100
        required: false
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      - name: prioFeeMicroLamports
        in: query
        description: Priority fee in microlamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: maxPrioFeeLamports
        in: query
        description: Maximum priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: exactPrioFeeLamports
        in: query
        description: Exact priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /instructions/deposit:
    get:
      deprecated: false
      summary: Get instruction to deposit to escrow
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: buyer
        in: query
        description: Buyer wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: amount
        in: query
        description: Amount in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      - name: prioFeeMicroLamports
        in: query
        description: Priority fee in microlamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: maxPrioFeeLamports
        in: query
        description: Maximum priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: exactPrioFeeLamports
        in: query
        description: Exact priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /instructions/sell:
    get:
      deprecated: false
      summary: Get instruction to sell (list)
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: seller
        in: query
        description: Seller wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: tokenMint
        in: query
        description: Token mint address
        required: true
        deprecated: false
        schema:
          type: string
      - name: tokenAccount
        in: query
        description: Token account
        required: true
        deprecated: false
        schema:
          type: string
      - name: price
        in: query
        description: Price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: sellerReferral
        in: query
        description: Seller referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: expiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: false
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      - name: prioFeeMicroLamports
        in: query
        description: Priority fee in microlamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: maxPrioFeeLamports
        in: query
        description: Maximum priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: exactPrioFeeLamports
        in: query
        description: Exact priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /instructions/sell_cancel:
    get:
      deprecated: false
      summary: Get instruction to cancel a sell
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: seller
        in: query
        description: Seller wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: tokenMint
        in: query
        description: Token mint address
        required: true
        deprecated: false
        schema:
          type: string
      - name: tokenAccount
        in: query
        description: Token account
        required: true
        deprecated: false
        schema:
          type: string
      - name: price
        in: query
        description: Price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: sellerReferral
        in: query
        description: Seller referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: expiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: false
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      - name: prioFeeMicroLamports
        in: query
        description: Priority fee in microlamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: maxPrioFeeLamports
        in: query
        description: Maximum priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: exactPrioFeeLamports
        in: query
        description: Exact priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /instructions/sell_change_price:
    get:
      deprecated: false
      summary: Get instruction to change a sell price
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: seller
        in: query
        description: Seller wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: tokenMint
        in: query
        description: Token mint address
        required: true
        deprecated: false
        schema:
          type: string
      - name: tokenAccount
        in: query
        description: Token account
        required: true
        deprecated: false
        schema:
          type: string
      - name: price
        in: query
        description: Price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: newPrice
        in: query
        description: New price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: sellerReferral
        in: query
        description: Seller referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: expiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: true
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /instructions/sell_now:
    get:
      deprecated: false
      summary: Get instruction to sell now (accept offer)
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: buyer
        in: query
        description: Buyer wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: seller
        in: query
        description: Seller wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: tokenMint
        in: query
        description: Token mint address
        required: true
        deprecated: false
        schema:
          type: string
      - name: tokenATA
        in: query
        description: Associate token account
        required: true
        deprecated: false
        schema:
          type: string
      - name: price
        in: query
        description: Price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: newPrice
        in: query
        description: New price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: sellerExpiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: true
        deprecated: false
        schema:
          type: number
      - name: buyerReferral
        in: query
        description: Buyer referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: sellerReferral
        in: query
        description: Seller referral wallet
        required: false
        deprecated: false
        schema:
          type: string
      - name: buyerExpiry
        in: query
        description: timestamp in seconds in the future, 0 means no expiry
        required: false
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /instructions/withdraw:
    get:
      deprecated: false
      summary: Get instruction to withdraw from escrow
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: buyer
        in: query
        description: Buyer wallet
        required: true
        deprecated: false
        schema:
          type: string
      - name: auctionHouseAddress
        in: query
        description: Auction house Address. If not provided, will use default auction house.
        required: false
        deprecated: false
        schema:
          type: string
      - name: amount
        in: query
        description: Amount in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      - name: prioFeeMicroLamports
        in: query
        description: Priority fee in microlamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: maxPrioFeeLamports
        in: query
        description: Maximum priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      - name: exactPrioFeeLamports
        in: query
        description: Exact priority fee in lamports
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - instructions
  /launchpad/collections:
    get:
      deprecated: false
      summary: Get launchpad collections
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ILaunchpadCollectionV2'
              example:
              - symbol: mini_royale
                name: 'Mini Royale: Nations'
                description: 'Vikings and soldiers with one goal: dominate the Miniverse'
                image: https://bafybeia6mayvhdf3rd53woqmnzo254xoayi5hzeum6aulz4ii7wcqtmloe.ipfs.dweb.link
                price: 0.01
                size: 2500
                launchDatetime: '2021-12-01T12:40:00.000Z'
                chainId: solana
              - symbol: test_lp_1
                name: Launchpad w/ 3 stages
                description: As I've said, it has 3 Stages
                featured: false
                image: https://bafybeia6mayvhdf3rd53woqmnzo254xoayi5hzeum6aulz4ii7wcqtmloe.ipfs.dweb.link
                price: 0.1
                size: 5000
                launchDatetime: '2022-02-03T12:00:00.000Z'
                chainId: solana
              - symbol: test_lp_2
                name: Test Launchpad 2
                description: 3 stages
                featured: false
                image: https://bafybeia6mayvhdf3rd53woqmnzo254xoayi5hzeum6aulz4ii7wcqtmloe.ipfs.dweb.link
                price: 0.1
                size: 5000
                launchDatetime: '2022-02-03T12:11:00.000Z'
                chainId: '1'
                contractAddress: '0x3888Fd82F8406E80B3d8eBA0353D0e9Ec51E6812'
      parameters:
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 200, min 1, max 500
        required: false
        deprecated: false
        schema:
          type: integer
      tags:
      - launchpad
  /instructions/magic_ticket/burns:
    get:
      deprecated: false
      summary: Construct and return burn txs for given mint addresses
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: walletAddress
        in: query
        description: Wallet address that owns the tickets
        required: true
        deprecated: false
        schema:
          type: string
      - name: mintAddresses
        in: query
        description: Comma-separated list of mint addresses to burn
        required: true
        deprecated: false
        schema:
          type: string
      tags:
      - magic-ticket
      - instructions
  /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
  /instructions/mmm/create-pool:
    get:
      deprecated: false
      summary: Get instruction to create a pool
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: spotPrice
        in: query
        description: Pool initial spot price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: curveType
        in: query
        description: Type curve, either 'linear' or 'exp'
        required: true
        deprecated: false
        schema:
          $ref: '#/components/schemas/MMM.CurveKindString'
      - name: curveDelta
        in: query
        description: Curve delta used to change price after a fill
        required: true
        deprecated: false
        schema:
          type: number
      - name: reinvestBuy
        in: query
        description: Whether to reinvest bought asset or transfer directly to owner
        required: true
        deprecated: false
        schema:
          type: boolean
      - name: reinvestSell
        in: query
        description: Whether to reinvest payment from sale or transfer directly to owner
        required: true
        deprecated: false
        schema:
          type: boolean
      - name: expiry
        in: query
        description: Timestamp in seconds in the future, 0 means no expiry
        required: false
        deprecated: false
        schema:
          type: number
      - name: lpFeeBp
        in: query
        description: Requested liquidity provider fee in basis points
        required: true
        deprecated: false
        schema:
          type: number
      - name: buysideCreatorRoyaltyBp
        in: query
        description: Amount of creator royalty the pool should pay in basis points
        required: true
        deprecated: false
        schema:
          type: number
      - name: paymentMint
        in: query
        description: Mint address of payment (default for SOL)
        required: true
        deprecated: false
        schema:
          type: string
      - name: collectionSymbol
        in: query
        description: Collection symbol for which the pool will be valid
        required: true
        deprecated: false
        schema:
          type: string
      - name: owner
        in: query
        description: Owner of the pool
        required: true
        deprecated: false
        schema:
          type: string
      - name: solDeposit
        in: query
        description: Optional sol amount to deposit with pool creation
        required: false
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      - name: sharedEscrowCount
        in: query
        description: Number of pools (bids) that will share the escrow account
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - mmm
      - instructions
  /instructions/mmm/sol-close-pool:
    get:
      deprecated: false
      summary: Get instruction to close a pool after all assets and payment have been withdrawn
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: pool
        in: query
        description: Public key of pool to close
        required: true
        deprecated: false
        schema:
          type: string
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - mmm
      - instructions
  /instructions/mmm/sol-deposit-buy:
    get:
      deprecated: false
      summary: Get instruction to deposit SOL into a pool for buying
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: pool
        in: query
        description: Public key of pool to deposit into
        required: true
        deprecated: false
        schema:
          type: string
      - name: solAmount
        in: query
        description: The amount of SOL to deposit
        required: true
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - mmm
      - instructions
  /instructions/mmm/sol-fulfill-buy:
    get:
      deprecated: false
      summary: Get instruction to have a pool fulfill a buy
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: pool
        in: query
        description: Public key of pool to interact with
        required: true
        deprecated: false
        schema:
          type: string
      - name: assetAmount
        in: query
        description: Amount of asset to transact
        required: true
        deprecated: false
        schema:
          type: number
      - name: minPaymentAmount
        in: query
        description: Minimum payment amount acceptible by the seller, in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: seller
        in: query
        description: Public key of seller of asset
        required: true
        deprecated: false
        schema:
          type: string
      - name: assetMint
        in: query
        description: Public key of mint account of asset
        required: true
        deprecated: false
        schema:
          type: string
      - name: assetTokenAccount
        in: query
        description: Public key of token account of asset
        required: true
        deprecated: false
        schema:
          type: string
      - name: allowlistAuxAccount
        in: query
        description: The allowlist aux account used for token authentication
        required: false
        deprecated: false
        schema:
          type: string
      - name: skipDelist
        in: query
        description: Whether to skip trying to delist the NFT if it is detected to be listed
        required: false
        deprecated: false
        schema:
          type: boolean
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - mmm
      - instructions
  /instructions/mmm/sol-fulfill-sell:
    get:
      deprecated: false
      summary: Get instruction to have a pool fulfill a sell
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: pool
        in: query
        description: Public key of pool to interact with
        required: true
        deprecated: false
        schema:
          type: string
      - name: assetAmount
        in: query
        description: Amount of asset to transact
        required: true
        deprecated: false
        schema:
          type: number
      - name: maxPaymentAmount
        in: query
        description: Maximum payment amount to be paid by the buyer, in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: buysideCreatorRoyaltyBp
        in: query
        description: Amount of royalty to be paid, in basis points of total royalty
        required: true
        deprecated: false
        schema:
          type: number
      - name: buyer
        in: query
        description: Public key of buyer of asset
        required: true
        deprecated: false
        schema:
          type: string
      - name: assetMint
        in: query
        description: Public key of mint account of asset
        required: true
        deprecated: false
        schema:
          type: string
      - name: allowlistAuxAccount
        in: query
        description: The allowlist aux account used for token authentication
        required: false
        deprecated: false
        schema:
          type: string
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - mmm
      - instructions
  /instructions/mmm/sol-withdraw-buy:
    get:
      deprecated: false
      summary: Get instruction to withdraw SOL from a pool
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: pool
        in: query
        description: Public key of pool to withdraw from
        required: true
        deprecated: false
        schema:
          type: string
      - name: solAmount
        in: query
        description: The amount of SOL to withdraw
        required: true
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - mmm
      - instructions
  /instructions/mmm/update-pool:
    get:
      deprecated: false
      summary: Get instruction to update an existing pool
      security:
      - bearerAuth: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
      parameters:
      - name: pool
        in: query
        description: Public key of pool to modify
        required: true
        deprecated: false
        schema:
          type: string
      - name: spotPrice
        in: query
        description: Pool initial spot price in SOL
        required: true
        deprecated: false
        schema:
          type: number
      - name: curveType
        in: query
        description: Type curve, either 'linear' or 'exp'
        required: true
        deprecated: false
        schema:
          type: string
      - name: curveDelta
        in: query
        description: Curve delta used to change price after a fill
        required: true
        deprecated: false
        schema:
          type: number
      - name: reinvestBuy
        in: query
        description: Whether to reinvest bought asset or transfer directly to owner (this value must remain unchanged from
          when the pool was created)
        required: true
        deprecated: false
        schema:
          type: boolean
      - name: reinvestSell
        in: query
        description: Whether to reinvest payment from sale or transfer directly to owner (this value must remain unchanged
          from when the pool was created)
        required: true
        deprecated: false
        schema:
          type: boolean
      - name: expiry
        in: query
        description: Timestamp in seconds in the future, 0 means no expiry
        required: true
        deprecated: false
        schema:
          type: number
      - name: lpFeeBp
        in: query
        description: Requested liquidity provider fee in basis points
        required: true
        deprecated: false
        schema:
          type: number
      - name: buysideCreatorRoyaltyBp
        in: query
        description: Amount of creator royalty the pool should pay in basis points
        required: true
        deprecated: false
        schema:
          type: number
      - name: priorityFee
        in: query
        description: Priority fee (in microlamports) to reprioritize the transaction against others
        required: false
        deprecated: false
        schema:
          type: number
      - name: sharedEscrowCount
        in: query
        description: Number of pools (bids) that will share the escrow account
        required: false
        deprecated: false
        schema:
          type: number
      tags:
      - mmm
      - instructions
  /mmm/pools:
    get:
      deprecated: false
      summary: Get AMM pools corresponding to an owner or collection symbol. At least one of required collectionSymbol or
        owner is required!
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IMmmPoolV2Response'
              example:
                results:
                - spotPrice: 53042450000
                  curveType: exp
                  curveDelta: 0
                  reinvestFulfillBuy: false
                  reinvestFulfillSell: false
                  expiry: 0
                  lpFeeBp: 0
                  buysideCreatorRoyaltyBp: 0
                  poolOwner: AC1r4GYj1TZ62ASZS4VT6GnNtMzoD78wYNWfxJ3Uzbxy
                  sellsideAssetAmount: 0
                  buysidePaymentAmount: 53095492450
                  buyOrdersAmount: 1
                  collectionSymbol: okay_bears
                  collectionName: Okay Bears
                  poolType: buy_sided
                  updatedAt: '2023-05-10T06:37:11.823Z'
                  uuid: 9KHoeTEnFFCxh1guDCB18hX6Cj1kcP1Z2hcpLCyV3hTo
                  poolKey: 7Tjbkwp234hPKjmTXNwpjdQnUqA1hXLAJEduVB2xkg8p
                  cosigner: NTYeYJ1wr4bpM5xo6zx5En44SvJFAd35zTxxNoERYqd
                  mints: []
                  collectionSellerFeeBasisPoints: 500
                  lpFeeEarned: 0
                  isMIP1: true
                - spotPrice: 53042440000
                  curveType: exp
                  curveDelta: 0
                  reinvestFulfillBuy: false
                  reinvestFulfillSell: false
                  expiry: 0
                  lpFeeBp: 0
                  buysideCreatorRoyaltyBp: 0
                  poolOwner: oKAYXGwLFF4TAqnC5G62PpwYo2GgPgzqwZ13JL1dWjE
                  sellsideAssetAmount: 0
                  buysidePaymentAmount: 53095482440
                  buyOrdersAmount: 1
                  collectionSymbol: okay_bears
                  collectionName: Okay Bears
                  poolType: buy_sided
                  updatedAt: '2023-05-10T06:36:59.374Z'
                  uuid: HRmPrYoqwN55uSVzofgrAPb4ryZH87UUWnK9PkRUPEHJ
                  poolKey: 9akMvSF6UHixPQBHQ5tpY6hF6bVyo7CQG4bVn5AhWPD9
                  cosigner: NTYeYJ1wr4bpM5xo6zx5En44SvJFAd35zTxxNoERYqd
                  mints: []
                  collectionSellerFeeBasisPoints: 500
                  lpFeeEarned: 0
                  isMIP1: true
                  isOCP: false
                - spotPrice: 53042230000
                  curveType: exp
                  curveDelta: 0
                  reinvestFulfillBuy: false
                  reinvestFulfillSell: false
                  expiry: 0
                  lpFeeBp: 0
                  buysideCreatorRoyaltyBp: 0
                  poolOwner: AgxfD7iS3M6hSR75dfhBZxXYEym5ohanPBBge5QhfQCK
                  sellsideAssetAmount: 0
                  buysidePaymentAmount: 53095272230
                  buyOrdersAmount: 1
                  collectionSymbol: okay_bears
                  collectionName: Okay Bears
                  poolType: buy_sided
                  updatedAt: '2023-05-10T06:14:52.337Z'
                  uuid: 4HTWKn5r7gH7Ma42FKCScB43uMGFruJExmbxr8DwCz6G
                  poolKey: 6q4UscJzMpJLM1ehwm7i9BHPxXQECPc4qMr2S6XSjD1j
                  cosigner: NTYeYJ1wr4bpM5xo6zx5En44SvJFAd35zTxxNoERYqd
                  mints: []
                  collectionSellerFeeBasisPoints: 500
                  lpFeeEarned: 0
                  isMIP1: true
                  isOCP: false
      parameters:
      - name: collectionSymbol
        in: query
        description: The collection symbol to query the pools from. At least this or "owner" must be passed in
        required: false
        deprecated: false
        schema:
          type: string
      - name: pools
        in: query
        description: The pools key to query by.
        required: false
        deprecated: false
        schema:
          type: array
          items:
            type: string
      - name: owner
        in: query
        description: The owner public key to query the pools created by. At least this or "collectionSymbol" must be passed
          in
        required: false
        deprecated: false
        schema:
          type: string
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 100, min 1, max 500
        required: false
        deprecated: false
        schema:
          type: integer
      - name: field
        in: query
        description: 'Sort pools by field. 0: NONE (no sorting field, default), 1: ADDRESS (sort pools by pool address), 2:
          SPOT_PRICE (sort pools by pool spot price), 5: BUYSIDE_ADJUSTED_PRICE (sort pools by buyside_adjusted_price = spot_price
          - royalty_fee - lp_fee)'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/FieldOptions'
      - name: direction
        in: query
        description: 'Sort pools by field in specified directions. 0: NONE (no sorting direction, default to increasing order
          if field is specified), 1: DESC (descending), 2: INC (increasing)'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/DirectionOptions'
      tags:
      - mmm
  /mmm/token/{mint_address}/pools:
    get:
      deprecated: false
      summary: Get best offers for an NFT
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IMmmPoolV2Response'
              example:
                results:
                - spotPrice: 44193250
                  curveType: exp
                  curveDelta: 0
                  reinvestFulfillBuy: false
                  reinvestFulfillSell: false
                  expiry: 0
                  lpFeeBp: 0
                  buysideCreatorRoyaltyBp: 9302
                  poolOwner: 9PBa4wED2V9CFzjpE94K23LWBquqmX4XanxoqiJgZnQo
                  sellsideAssetAmount: 0
                  buysidePaymentAmount: 44414216
                  buyOrdersAmount: 1
                  collectionSymbol: pastel_pandas
                  collectionName: PASTEL PANDAS
                  poolType: buy_sided
                  updatedAt: '2023-05-09T12:20:04.201Z'
                  uuid: 6qknG6Ko6vYcUk3wo8JpdY2HCNwm5gzmiEgW4gGuGdgX
                  poolKey: D6J69jm38rh5nPJdit37L3VMQWVs8m9veNxsPPFVKsPy
                  cosigner: NTYeYJ1wr4bpM5xo6zx5En44SvJFAd35zTxxNoERYqd
                  mints: []
                  collectionSellerFeeBasisPoints: 750
                  lpFeeEarned: 0
                  buyPriceTaker: 40447209
                  isMIP1: false
                  isOCP: false
                  attributes:
                  - - trait_type: Attributes Count
                      value: '8'
      parameters:
      - name: mint_address
        in: path
        description: Mint address of the NFT
        required: true
        deprecated: false
        schema:
          type: string
        example: 6XkPLDtV2w17UUsyzah39PTBjZ9xTY8HokqRdWcmDhBa
      - name: limit
        in: query
        description: Total best offers to return, defaults 1, max 5. Best offer will come first
        required: false
        deprecated: false
        schema:
          type: integer
      tags:
      - mmm
  /tokens/{token_mint}:
    get:
      deprecated: false
      summary: Get token metadata by mint address
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SwaggerFriendlyITokenV2'
              example:
                mintAddress: 4uvpqEL73361hRXCrHqBZQWeqfbKPQw55yKSFZvLQYTq
                owner: 8ao31PYJ7jHiGQDAkRN1sDWxUgUMwTjMZ7uyiS5F9aNs
                supply: 1
                collection: devnet_zoolana
                name: Beyond Reach
                updateAuthority: 7DiTpjUsvRS63EoaEsjEnQj3ncqVeQeiB116kNrhMBNw
                primarySaleHappened: true
                sellerFeeBasisPoints: 500
                image: https://ipfs.io/ipfs/QmY4PDbfRsuwCvmJeY6NdzaRXFJhypgVwzNyDwin91dsM2
                animationUrl: https://ipfs.io/ipfs/QmWhd7tAWgogpcndBec5gSKTuzJ5tiNqrTsdsho2Mk5c7m?ext=mp4
                externalUrl: https://www.zoolana.io
                attributes:
                - trait_type: Edition
                  value: Teaser
                - trait_type: Tribe
                  value: Vand
                - trait_type: Rarity
                  value: Bronze
                properties:
                  files:
                  - uri: https://ipfs.io/ipfs/QmY4PDbfRsuwCvmJeY6NdzaRXFJhypgVwzNyDwin91dsM2
                    type: image/png
                  - uri: https://ipfs.io/ipfs/QmWhd7tAWgogpcndBec5gSKTuzJ5tiNqrTsdsho2Mk5c7m?ext=mp4
                    type: video/mp4
                  category: ''
                  creators:
                  - address: 6QNWBWhxBfEMkwBUTeTsGyxohBicA3k6EGWr6X8KmzUL
                    share: 50
                  - address: 4Tysv54Lxh1L16h5Yt5ncFGbG5ont8iXvCUzFFkfCYFY
                    share: 50
        '400':
          description: Token not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: token_mint
        in: path
        description: Mint address of the token or asset ID of compressed NFT
        required: true
        deprecated: false
        schema:
          type: string
        example: 4uvpqEL73361hRXCrHqBZQWeqfbKPQw55yKSFZvLQYTq
      tags:
      - tokens
  /tokens/{token_mint}/activities:
    get:
      deprecated: false
      summary: Get activities for a token
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SwaggerFriendlyIActivityV2'
              example:
              - signature: 3HM6raDqMF6W134NmDw7tUhpMSePbr32FRnigx3w4THfMGdtgnz9f7FxNHDmLY625o2vmpidqa3WaJL5uAUcNTpd
                type: list
                source: magiceden_v2
                tokenMint: 6XkPLDtV2w17UUsyzah39PTBjZ9xTY8HokqRdWcmDhBa
                collectionSymbol: null
                slot: 138008605
                blockTime: 1654024725
                buyer: null
                buyerReferral: ''
                seller: AmGLq5ZRGKjCXPq4tMAEgsKogMu1qFV5Yj28NM4ZZHKN
                sellerReferral: ''
                price: 1.12
              - signature: 3HM6raDqMF6W134NmDw7tUhpMSePbr32FRnigx3w4THfMGdtgnz9f7FxNHDmLY625o2vmpidqa3WaJL5uAUcNTpd
                type: list
                source: magiceden_v2
                tokenMint: 6XkPLDtV2w17UUsyzah39PTBjZ9xTY8HokqRdWcmDhBa
                collectionSymbol: devnet_zoolana
                slot: 138008605
                blockTime: 1654024725
                buyer: null
                buyerReferral: ''
                seller: AmGLq5ZRGKjCXPq4tMAEgsKogMu1qFV5Yj28NM4ZZHKN
                sellerReferral: ''
                price: 1.12
        '400':
          description: Token not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: token_mint
        in: path
        description: Mint address of the token or asset ID of compressed NFT
        required: true
        deprecated: false
        schema:
          type: string
        example: 6XkPLDtV2w17UUsyzah39PTBjZ9xTY8HokqRdWcmDhBa
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 100, min 1, max 500
        required: false
        deprecated: false
        schema:
          type: integer
      tags:
      - tokens
  /tokens/{token_mint}/listings:
    get:
      deprecated: false
      summary: Get listings for a token
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SwaggerFriendlyIListingV2'
              example:
              - pdaAddress: 7PkCbEWQsndTKgSWySWjkggWxpZwPnrDop8vJc8vxevs
                auctionHouse: E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe
                tokenAddress: NosfJM1SyMYED4eBnbZxa4pfnQYeeXw97Fep9w9Tqzu
                tokenMint: 6XkPLDtV2w17UUsyzah39PTBjZ9xTY8HokqRdWcmDhBa
                seller: AmGLq5ZRGKjCXPq4tMAEgsKogMu1qFV5Yj28NM4ZZHKN
                sellerReferral: autMW8SgBkVYeBgqYiTuJZnkvDZMVU2MHJh9Jh7CSQ2
                tokenSize: 1
                price: 1.12
                rarity: {}
                expiry: -1
                token:
                  mintAddress: 4uvpqEL73361hRXCrHqBZQWeqfbKPQw55yKSFZvLQYTq
                  owner: 8ao31PYJ7jHiGQDAkRN1sDWxUgUMwTjMZ7uyiS5F9aNs
                  supply: 1
                  collection: devnet_zoolana
                  name: Beyond Reach
                  updateAuthority: 7DiTpjUsvRS63EoaEsjEnQj3ncqVeQeiB116kNrhMBNw
                  primarySaleHappened: true
                  sellerFeeBasisPoints: 500
                  image: https://ipfs.io/ipfs/QmY4PDbfRsuwCvmJeY6NdzaRXFJhypgVwzNyDwin91dsM2
                  animationUrl: https://ipfs.io/ipfs/QmWhd7tAWgogpcndBec5gSKTuzJ5tiNqrTsdsho2Mk5c7m?ext=mp4
                  externalUrl: https://www.zoolana.io
                  attributes:
                  - trait_type: Edition
                    value: Teaser
                  - trait_type: Tribe
                    value: Vand
                  - trait_type: Rarity
                    value: Bronze
                  properties:
                    files:
                    - uri: https://ipfs.io/ipfs/QmY4PDbfRsuwCvmJeY6NdzaRXFJhypgVwzNyDwin91dsM2
                      type: image/png
                    - uri: https://ipfs.io/ipfs/QmWhd7tAWgogpcndBec5gSKTuzJ5tiNqrTsdsho2Mk5c7m?ext=mp4
                      type: video/mp4
                    category: ''
                    creators:
                    - address: 6QNWBWhxBfEMkwBUTeTsGyxohBicA3k6EGWr6X8KmzUL
                      share: 50
                    - address: 4Tysv54Lxh1L16h5Yt5ncFGbG5ont8iXvCUzFFkfCYFY
                      share: 50
                listingSource: M2
        '400':
          description: Token not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: token_mint
        in: path
        description: Mint address of the token or asset ID of compressed NFT
        required: true
        deprecated: false
        schema:
          type: string
        example: 6XkPLDtV2w17UUsyzah39PTBjZ9xTY8HokqRdWcmDhBa
      - name: listingAggMode
        in: query
        description: True to return aggregated marketplace listings, false to return just Magic Eden listings. Defaults to
          false.
        required: false
        deprecated: false
        schema:
          type: boolean
      tags:
      - tokens
  /tokens/{token_mint}/offers_received:
    get:
      deprecated: false
      summary: Get received offers for a token
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/IOfferV2'
              example:
              - pdaAddress: 6pDTQ8eSLQCBeAsagmYbpjqbrW82Q5gwbVF8cEj2Tg6j
                tokenMint: 6eGfgGuxA1pBtTX4k2oubpa6m1Z3eaJUBxgtZFB7sjZA
                auctionHouse: ''
                buyer: AnCKk6ThHEhgHMUpM2JoNDRwJ4neyzcj6a3TRPGH5Pa5
                buyerReferral: ''
                tokenSize: 1
                price: 0.007
                expiry: 0
              - pdaAddress: H54aiNrbDZi31YSycp1sz5iXM9Cvs3BWjCTPgmBTjQKt
                tokenMint: 6eGfgGuxA1pBtTX4k2oubpa6m1Z3eaJUBxgtZFB7sjZA
                auctionHouse: ''
                buyer: CEMnY2UPQJUZ9MahFcbogQFUfFzoHVFgSZpJmZW5WpH6
                buyerReferral: ''
                tokenSize: 1
                price: 0.51
                expiry: 0
        '400':
          description: Token not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: token_mint
        in: path
        description: Mint address of the token
        required: true
        deprecated: false
        schema:
          type: string
        example: 7ThMgi8Qh2XEAYBvnrEHNfaTNnHyqQCVH5XbFgGgu6bn
      - name: min_price
        in: query
        description: Filter offers that are less than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: max_price
        in: query
        description: Filter offers that are more than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 100, min 1, max 500
        required: false
        deprecated: false
        schema:
          type: integer
      - name: sort
        in: query
        description: The field to sort the offers received, default 'updatedAt'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/OfferReceivedSort'
      - name: sort_direction
        in: query
        description: The direction returned elements should be sorted in, default 'desc'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/SortDirQuery'
      tags:
      - tokens
  /wallets/owner/activities:
    get:
      deprecated: false
      summary: Get ownership activities of a wallet.
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SwaggerFriendlyIActivityV2'
              example:
              - signature: 2v5HjvhZf1bPJ6iFoHkbJWgcwEpYoTvhdWwDESDmrTsY6sX7MtN3eeEvLngoXMVrneyRboG74sQWScVcEFR7R5Qg
                type: buyNow
                source: magiceden_v2
                tokenMint: 4DbHsohxbkSJRZUNeVPPdxgYKJwEtXVge1ibQivi9x3T
                collectionSymbol: runcible
                slot: 110921876
                blockTime: 1643408148
                buyer: FtynbMEVKQnZp5iUmVaooR2JNW4brGD68eU4PLUUjNdX
                buyerReferral: ''
                seller: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
                sellerReferral: ''
                price: 0.045
              - signature: NYXnQ6uFLbbZhQveYoheWZKFYsb1ZznLYxLxknsobhuPWGufnhGd6JHD5JUsAqkerYHVpc6roMDhYxJiRQ4VXwe
                type: bid
                source: magiceden
                tokenMint: 6c5ZKCMXN4NY1q2H1wBroskEyrWcKFKGnUQVyTiDYvma
                collectionSymbol: btest
                slot: 110736942
                blockTime: 1643335720
                buyer: 4nNQvp6dwo26FVxvFjgZQm66QjwkihPgeW33Z24HaU2T
                buyerReferral: ''
                seller: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
                sellerReferral: ''
                price: 0.03
        '400':
          description: Wallet not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: owner
        in: query
        description: wallet address.
        required: true
        deprecated: false
        schema:
          type: string
        example: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
      - name: createdAt
        in: query
        description: Filter activities that are created after this time
        required: false
        deprecated: false
        schema:
          type: string
      tags:
      - wallets
  /wallets/{wallet_address}:
    get:
      deprecated: false
      summary: Get info about the wallet owner.
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IWalletOwnerInfo'
              example:
                walletAddress: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
                displayName: Channing
                avatar: 8DGghzXuaRSe1n1qwabfC3wtfmn4WjiWgNJse1F8Aa6C
        '400':
          description: Wallet not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: wallet_address
        in: path
        description: wallet address.
        required: true
        deprecated: false
        schema:
          type: string
        example: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
      tags:
      - wallets
  /wallets/{wallet_address}/activities:
    get:
      deprecated: false
      summary: Get activities of a wallet.
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SwaggerFriendlyIActivityV2'
              example:
              - signature: 2v5HjvhZf1bPJ6iFoHkbJWgcwEpYoTvhdWwDESDmrTsY6sX7MtN3eeEvLngoXMVrneyRboG74sQWScVcEFR7R5Qg
                type: buyNow
                source: magiceden_v2
                tokenMint: 4DbHsohxbkSJRZUNeVPPdxgYKJwEtXVge1ibQivi9x3T
                collectionSymbol: runcible
                slot: 110921876
                blockTime: 1643408148
                buyer: FtynbMEVKQnZp5iUmVaooR2JNW4brGD68eU4PLUUjNdX
                buyerReferral: ''
                seller: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
                sellerReferral: ''
                price: 0.045
              - signature: NYXnQ6uFLbbZhQveYoheWZKFYsb1ZznLYxLxknsobhuPWGufnhGd6JHD5JUsAqkerYHVpc6roMDhYxJiRQ4VXwe
                type: bid
                source: magiceden
                tokenMint: 6c5ZKCMXN4NY1q2H1wBroskEyrWcKFKGnUQVyTiDYvma
                collectionSymbol: btest
                slot: 110736942
                blockTime: 1643335720
                buyer: 4nNQvp6dwo26FVxvFjgZQm66QjwkihPgeW33Z24HaU2T
                buyerReferral: ''
                seller: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
                sellerReferral: ''
                price: 0.03
        '400':
          description: Wallet not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: wallet_address
        in: path
        description: wallet address.
        required: true
        deprecated: false
        schema:
          type: string
        example: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 100, min 1, max 500
        required: false
        deprecated: false
        schema:
          type: integer
      tags:
      - wallets
  /wallets/{wallet_address}/escrow_balance:
    get:
      deprecated: false
      summary: Get escrow balance for a wallet.
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EscrowBalance'
              example:
                buyerEscrow: 6XpzgXRA92qg1j6Krfeqhxufnnn2PQNxiAhFFxLprYmj
                balance: 0.03
        '400':
          description: Wallet not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: wallet_address
        in: path
        description: wallet address.
        required: true
        deprecated: false
        schema:
          type: string
        example: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
      tags:
      - wallets
  /wallets/{wallet_address}/offers_made:
    get:
      deprecated: false
      summary: Get offers made by a wallet.
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/IOfferV2'
              example:
              - pdaAddress: ABk7HjjQkQmhFaZK9mmDaCTu7L4FJRDLBUU8Lk3ajReH
                tokenMint: AKnh88U3Via1A3wFYBPzEa9wH3fXinpXY3ApZhC2ExCf
                auctionHouse: ''
                buyer: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
                price: 0.03
                tokenSize: 1
                expiry: 0
              - pdaAddress: EPEHNmPbApdYjPKZSAhiW987MGssi3SoqhXUzuqhXTQd
                tokenMint: 3nCs3tqujtQ37gygKsPKoHbZUsK4ZbMx1EEpoijU4P4A
                auctionHouse: E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe
                buyer: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
                buyerReferral: autMW8SgBkVYeBgqYiTuJZnkvDZMVU2MHJh9Jh7CSQ2
                price: 0.02
                tokenSize: 1
                expiry: 0
              - pdaAddress: 5BwQZ1DcDeZNGHumZesvQgtf1Y3Y11ZjJuZ988RgJqCr
                tokenMint: 6c5ZKCMXN4NY1q2H1wBroskEyrWcKFKGnUQVyTiDYvma
                auctionHouse: ''
                buyer: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
                price: 0.5
                tokenSize: 1
                expiry: 0
        '400':
          description: Wallet not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: wallet_address
        in: path
        description: wallet address.
        required: true
        deprecated: false
        schema:
          type: string
        example: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
      - name: min_price
        in: query
        description: Filter offers that are less than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: max_price
        in: query
        description: Filter offers that are more than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 100, max 500
        required: false
        deprecated: false
        schema:
          type: integer
      - name: sort
        in: query
        description: The field to sort the offers made, default 'bidAmount'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/OfferReceivedSort'
      - name: sort_direction
        in: query
        description: The direction returned elements should be sorted in, default 'desc'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/SortDirQuery'
      tags:
      - wallets
  /wallets/{wallet_address}/offers_received:
    get:
      deprecated: false
      summary: Get offers received by a wallet.
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/IOfferV2'
              example:
              - pdaAddress: 7QsrcdcXBXqMAwrDkc4XBGBnub7TNaso2oVMDJK5Pbgm
                tokenMint: 9oTf3TfpCiS9LppP8BuTJ8XQpeg1GHVHuHDRcgWkS38a
                auctionHouse: ''
                buyer: BSrs8zdg2VN6GGPpzT6Ss1o6jVGWUXtDXyrvfMbpgxy1
                price: 3
                tokenSize: 1
                expiry: 0
        '400':
          description: Wallet not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: wallet_address
        in: path
        description: wallet address.
        required: true
        deprecated: false
        schema:
          type: string
        example: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
      - name: min_price
        in: query
        description: Filter offers that are less than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: max_price
        in: query
        description: Filter offers that are more than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: sort
        in: query
        description: The field to sort the offers received, default 'updatedAt'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/OfferReceivedSort'
      - name: sort_direction
        in: query
        description: The direction returned elements should be sorted in, default 'desc'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/SortDirQuery'
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 100, min 1, max 500
        required: false
        deprecated: false
        schema:
          type: integer
      tags:
      - wallets
  /wallets/{wallet_address}/tokens:
    get:
      deprecated: false
      summary: Get tokens owned by a wallet.
      security: []
      responses:
        '200':
          description: success response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SwaggerFriendlyITokenV2'
              example:
              - mintAddress: HdcrPMF4kHKqy5V9JibNSoWLNpqnxQUBDEBeimZkLf7u
                owner: EWmtsfBA8EikR3vvhsXgxn7cBQCUZfXJ7jMwXUpYRzXY
                supply: 1
                name: Scanning of Picasso
                updateAuthority: 7YNKWyPW5iqu1QHqnQ5Csj9yWpEEnqAzLcuzudMMHqbk
                primarySaleHappened: false
                sellerFeeBasisPoints: 1250
                image: https://www.arweave.net/c-5vOkt_YZZmlU8pjijlIYPFVZLDrm7jLAs918aFe-g?ext=JPG
                attributes: []
                properties:
                  files:
                  - uri: https://www.arweave.net/c-5vOkt_YZZmlU8pjijlIYPFVZLDrm7jLAs918aFe-g?ext=JPG
                    type: image/jpeg
                  category: image
                  creators:
                  - address: 7YNKWyPW5iqu1QHqnQ5Csj9yWpEEnqAzLcuzudMMHqbk
                    verified: true
                    share: 100
                listStatus: listed
        '400':
          description: Wallet not found
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: wallet_address
        in: path
        description: wallet address.
        required: true
        deprecated: false
        schema:
          type: string
        example: 4wejSnr97csngztZ5SU7A6iZRXJD7B3Y1R1koCQ5NjmD
      - name: collection_symbol
        in: query
        description: Filter tokens that are part of this collection symbol, max length of 255 characters
        required: false
        deprecated: false
        schema:
          type: string
      - name: mcc_address
        in: query
        description: Filter tokens that are part of this Metaplex Certified Collection address, max length of 48 characters
        required: false
        deprecated: false
        schema:
          type: string
      - name: offset
        in: query
        description: The number of items to skip, default 0, min 0
        required: false
        deprecated: false
        schema:
          type: integer
      - name: limit
        in: query
        description: The numbers of items to return, default 100, min 1, max 500
        required: false
        deprecated: false
        schema:
          type: integer
      - name: min_price
        in: query
        description: Filter listings that are less than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: max_price
        in: query
        description: Filter listings that are more than this price
        required: false
        deprecated: false
        schema:
          type: number
      - name: attributes
        in: query
        description: 'Represents a filtering mechanism where the elements within each inner array are logically ORed, and
          the resulting arrays are ANDed together at the top level. Each inner array consists of objects with two properties:
          traitType (a string) and value (a string). For example: [[{"traitType":"trait1", "value":"value1"},{"traitType":"trait1",
          "value":"value2"}]] would return tokens that have "value1" OR "value2" for "trait1".'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/SwaggerNftAttributeSchema'
      - name: listStatus
        in: query
        description: Determines what type of tokens to return, default both
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/ListStatus'
      - name: sort
        in: query
        description: The field to sort the tokens, default 'updatedAt'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/ListingSortOptions'
      - name: sort_direction
        in: query
        description: The direction returned elements should be sorted in, default 'desc'
        required: false
        deprecated: false
        schema:
          $ref: '#/components/schemas/SortDirQuery'
      tags:
      - wallets