Comment on page

Project Marketplace Activity & History

Getting activity / history for a project
Function: getProjectHistory
Inputs:
Condition Inputs:
  • [Required] projects
    • Type: ProjectIdWithAttributes[]
    • Description: Projects to query against
    • Note: Supports attribute filtering for only a single collection
    • Example:
    • [
      {
      project_id: "degenape",
      }
      ]
      [
      {
      project_id: "degenape",
      attributes: [{name: "Clothing", type: "CATEGORY", values: ["Maid's Uniform"]}]
      }
      ]
  • [Optional] actionTypes
    • Type: MarketplaceActionEnums[]
    • Description: Action types that we want to filter for
    • Allowed Values:
      • MarketPlaceActionEnum.Bid | "BID"
        MarketPlaceActionEnum.Delisting | "DELISTING"
        MarketPlaceActionEnum.Listing | "LISTING"
        MarketPlaceActionEnum.Transaction | "TRANSACTION"
        MarketPlaceActionEnum.Updatelisting | "UPDATELISTING"
        MarketPlaceActionEnum.Updatebid | "UPDATEBID"
        MarketPlaceActionEnum.Cancelbid | "CANCELBID"
  • [DEPRECATED] nonMpaActionTypes
    • We no longer show mints in this endpoint for performance reasons. There is a new endpoint to get mint activity. We have plans down the road to merge the 2 but until then we please use the non marketplace actions endpoint for mints.
Response:
GetProjectHistoryQuery
Example:
Getting all degeniverse collections
import { HyperspaceClient } from "hyperspace-js";
const hsClient = new HyperspaceClient(API_KEY);
hsClient.getProjectHistory({
condition: {
projects: [
{project_id: "degenape"},
{project_id: "degenerateapekindergarten"},
{project_id: "degentrashpandas"}
],
}
}
)
Getting sales activity only
hsClient.getProjectHistory({
condition: {
projects: [
{project_id: "degenape"},
{project_id: "degenerateapekindergarten"},
{project_id: "degentrashpandas"}
],
actionTypes: [MarketPlaceActionEnum.Transaction]
}
}
)
Getting 1 attribute SMB activity
hsClient.getProjectHistory({
condition: {
projects: [
{project_id: "smb", attributes: [{name: "Attributes Count", type: "NUMERIC", values: ["1"]}]},
],
}
}
)
Reference Implementation