mallow
  • SMORES Token
    • Overview
    • How to earn
    • Economics
    • SMORES Uses
    • FAQ
  • REST API
    • Overview
    • Reference
      • Types
        • Artwork
        • Collection
      • /artworks
        • GET /artworks/:mintAccount
        • GET /artworks/trending
        • POST /artworks/listedBySeller
        • POST /artworks/byCreator
      • /events
        • POST /events/byMint
        • POST /events/bySeller
      • /users
        • GET /users/:address
      • /rewards
        • GET /rewards/unclaimed/:address
      • /getBidOrBuyTx
        • POST /getBidOrBuyTx
      • /scheduledBids
        • POST /scheduledBids/getBidTx
        • POST /scheduledBids/getCancelBidTx
        • GET /scheduledBids/:bidder
  • Actions/Blinks
Powered by GitBook
On this page
  1. REST API
  2. Reference
  3. /events

POST /events/byMint

Get market events for an item

POST https://api.mallow.art/v1/events/byMint

Request Body

Name
Type
Description

page*

number

Page to fetch. Starts at 0.

mintAccount*

string

The mint address of the artwork to get events for

mode*

"current-listing" | "provenance"

"current-listing" will return only events for the current listing. "provenance" will return all historical listings and sales for the item.

{
    "result": [{
        "txId": "3i7KjkA9xEHtUgn3CCLPkdN6BNxL7yR17ffQwvkDBD8uWERb9b7E1GKDbrCvDemgdKU1X4oWi9saM3XXiYzzB1cL",
        "currencyMint": "smoEhMZMweWBnpd1QoU4ZjuVNBxMFchqy4NRMBbtW7V",
        "date": "2024-04-25T14:56:48.000Z",
        "listingType": "auction", // "buy-now", "raffle"
        "mintAccount": "D6s7cu48ypNuZTTwDXcX7huyGCXTVazfRw8kf2imuqAC",
        "price": 100000000,
        "seller": "EyXEqdQ6aKHxawhoBsfaLAqxs8MHDxS7ZnYiC7ipY9vR",
        "source": "mallow",
        "type": "list", // "bid", "sale", "accept-bid", "buy-ticket", "delist", "mint"
        "usdPrice": 8.84,
        "user": {
            "addresses": [
                "EyXEqdQ6aKHxawhoBsfaLAqxs8MHDxS7ZnYiC7ipY9vR"
            ],
            "displayName": "Kaan Tapucu",
            "imageUrl": "https://cdn.mallow.art/images/pfp/EyXEqdQ6aKHxawhoBsfaLAqxs8MHDxS7ZnYiC7ipY9vR/1710072549648",
            "username": "kaantapucu"
        }
    }],
    "nextPage": 1,
    "total": 1
}
{
    "error": { 
        "message": "Invalid API Key" 
    }
}
{
    "error": { 
        "message": "Missing mintAccount" 
    }
}
Previous/eventsNextPOST /events/bySeller

Last updated 1 year ago