User Marketplace Activity & History

Getting user activity and history
Function: getUserBids
Description: Returns all existing user bids
Inputs:
Condition Inputs:
  • [Required] userAddress
    • Type: String
    • Description: Wallet to look up bids
Response:
GetUserBidsQuery
Example:
hsClient.getUserBids(
{
condition: {
userAddress: "Bnxf8Kz5TG6YUeyw9pTFPGMaazNswsoEvqgUVL7ekG9C"
}
}
)
Reference Implementation:
Function: getUserListings
Description: Returns all existing user listings
Inputs:
Condition Inputs:
  • [Required] userAddress
    • Type: String
    • Description: Wallet to look up bids
Response:
GetUserListingsQuery
Example:
hsClient.getUserListings(
{
condition: {
userAddress: "Bnxf8Kz5TG6YUeyw9pTFPGMaazNswsoEvqgUVL7ekG9C"
}
}
)
Reference Implementation:
Function: getUserHistory
Description: Returns all user activity
Inputs:
Condition Inputs:
  • [Required] userAddress
    • Type: String
    • Description: Wallet to look up bids
  • 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.
Pagination Input:
  • [Optional] paginationInfo
    • Type: PaginationConfig
    • Description: Pagination Params
    • Example:
    • {
      page_number: 1,
      page_size: 40
      }
Response:
GetUserHistoryQuery
Example:
hsClient.getUserHistory(
{
condition: {
userAddress: "Bnxf8Kz5TG6YUeyw9pTFPGMaazNswsoEvqgUVL7ekG9C"
}
}
)
Reference Implementation: