Marketplace Snapshot

The core of what we show in our collections page
NOTE: Valuation returned by snapshot is DEPRECATED and should not be used. HYPERSPACE Rank comes from rank_est.
Function: getMarketplaceSnapshot
Inputs:
Condition Inputs:
[Optional] projects
Type: ProjectIdWithAttributes[]
Description: A list of project ids to query for with attributes to filter on
[Optional] name
Type: StringInputArg
Description: Find a token based on display name in a collection. Requires a project to be passed in. Allows for exact match or fuzzy search.
Example:
 StringInputArg {
  value: string
  operation: "EXACT" or "FUZZY"
 }
 
 name: {operation: "EXACT", value: "Degen Trash Panda #14904"}
[Optional] tokenAddresses
Type: array of strings
Description: A list of token addresses to query for
Note: Has a limit of 500 tokens per call
[Optional] excludeTokensWithoutMetadata
Type: boolean
Description: Filters tokens that we do not have metadata or information on
[Optional] includeAttributeInformation
Type: boolean
Description: Includes project level attribute information. The project_attributes field from the projects api.
[Optional] includeProjectFloorPrice
Type: boolean
Description: Include project floor price
[Optional] onlyListings
Type: boolean
Description: Only query for tokens that are listed
[Optional] priceFilter
Type: array
Description: Price to filter by inclusive
Example:
[0, 5]                     // Items listed between 0 and 5 sol
[Optional] rankFilter
Type: array
Description: Rank to filter by inclusive, Rank based on our rarity
Example:
[0, 5]  
Order By
[Optional] orderBy
Type: OrderConfig
Allowed Values:
lowest_listing_block_timestamp      //For sorting by listed time
lowest_listing_price                //For sorting by listed price
rank_est                            //For sorting by our rarity
Pagination Input:
[Optional] paginationInfo
Type: PaginationConfig
Description: Pagination Params
Example:
{
    page_number: 1,
    page_size: 40
}
Response:
GetMarketplaceSnapshotsQuery
lowest_listing_mpa will contain listing information for an nft
market_place_snapshots {
      token_address
      project_id
      name
      rank_est
      supply
      full_img
      meta_data_img
      meta_data_uri
      attributes
      floor_price
      project_name
      project_image
      is_project_verified
      project_attributes {
        name
        counts
        type
        values
      }
      lowest_listing_mpa {
        user_address
        price
        marketplace_program_id
        type
        signature
        amount
        broker_referral_address
        block_timestamp
        broker_referral_fee
        escrow_address
        fee
        marketplace_fee_address
        marketplace_instance_id
        metadata
      }
}
Examples:
Show Recently Listed Degods
hsClient
  .getMarketplaceSnapshot({
    condition: {
      projects: [
        {
          project_id: "degods"
        },
      ],
    },
    orderBy: {
      field_name: "lowest_listing_block_timestamp",
      sort_order: SortOrderEnum.Desc
    }
  })
Show Lowest Listed Deadgods
hsClient
  .getMarketplaceSnapshot({
    condition: {
      projects: [
        {
          project_id: "degods"
          attributes: [{name: "version", type: "CATEGORY", values: ["DeadGod"]}]
        },
      ],
    },
    orderBy: {
      field_name: "lowest_listing_price",
      sort_order: SortOrderEnum.Desc
    }
  })
Get 1 attribute SMBs
hsClient
  .getMarketplaceSnapshot({
    condition: {
      projects: [
        {
          project_id: "smb",
          attributes: [
            { name: "Attributes Count", type: "NUMERIC", values: ["1"] },
          ],
        },
      ],
    },
  })
Reference Implementation:
​
User Non-Marketplace Activity & History
Marketplace Status
Last modified 10mo ago