GET /artworks/:mintAccount

Artwork info by mint account

GET https://api.mallow.art/v1/artworks/:mintAccount

Returns artwork info by its mint account.

Path Parameters

Name	Type	Description
mintAccount*	string	Artwork's mint account

200 Artwork info found

{
    "result": {
        "item": {
            "mintAccount": "5Y44wPAX3yJButY74AfRKt8sFbZTXGZwxDmp9Uqfbyjd",
            "attributes": [
                {
                    "value": "Guuniverse",
                    "trait_type": "Universe"
                },
                {
                    "value": "Guu",
                    "trait_type": "Species"
                },
                {
                    "value": "LucaTheDesigner",
                    "trait_type": "Collab Artist"
                },
                {
                    "value": "Scientist",
                    "trait_type": "Job Type"
                }
            ],
            "description": "Dr. Guulileo Guunstein, also known as Dr. Guu, is a mastermind of boundless ingenuity. His origins trace back to the unique realm known as the Guuniverse. Despite the \"Dr.\" title, Guulileo reigns as a revered professor in the intricate field of Biology, with his intellect devoted to unraveling the various lifeforms roaming the Web3 space.\n\nJourneying alongside him is Deniguu, a pint-sized companion with an extraordinary gift – the ability to replicate the chemical elements of whatever she consumes. Her unique ability stands as a vital tool in Dr. Guu's relentless pursuit of knowledge.\n\nAdorned with mystical Nenju beads, an heirloom granted by a benevolent monk, and the bio earring gifted by Lucha, Dr. Guu exists in an ethereal threshold, bridging the realms of science and the extraordinary.\n\n\"Magnificent! Absolutely marvelous!\"\n\nHe tilts his glasses while reviewing specimens, a mix of amazement and curiosity filling his eyes.",
            "imageUrl": "https://shdw-drive.genesysgo.net/2iHNWQtfUsth1F7dy6Mtjr9dHmYPZN7TZS4W2GcEwNTE/94ab618a2ed72f7e42a3d1a0728b55bf.png",
            "isImmutable": false,
            "listingType": "buy-now", // "auction", "raffle", "unlisted"
            "metadataUrl": "https://shdw-drive.genesysgo.net/2iHNWQtfUsth1F7dy6Mtjr9dHmYPZN7TZS4W2GcEwNTE/ecd5372f11084aeee4bd8d6f377a61ca.json",
            "name": "[003] Tiiiny \"Dr.Guu\" Rover",
            "owner": "Dyi3AeQcDKPhXLdsF2Avihh1ty43REGuCRGKvU8QEAAd",
            "royalties": {
                "feeBPS": 1500,
                "shares": [
                    {
                        "address": "DsSqaaKvuzkexQophftgPJqZqVi3Ki7VQcpGSwnXe9WZ",
                        "share": 100,
                        "verified": true
                    }
                ]
            },
            "tags": [
                "animation",
                "digital-art",
                "pfp",
                "tiny-art",
                "tiny",
                "minimalist",
                "original-character",
                "tiiinyverse",
                "cute",
                "animated",
                "collab",
                "drawing"
            ],
            "videoUrl": "https://shdw-drive.genesysgo.net/2iHNWQtfUsth1F7dy6Mtjr9dHmYPZN7TZS4W2GcEwNTE/8e8ac3b818969a07c2f9415c512c56c3.mp4",
            "editionAccount": "4n4jNyMi9vmNLBC7p4hC3D1uRM3B6voju9Kz6cyCcUam",
            "maxSupply": 0, // 0 = 1/1, > 0 = limited edition, null = open edition
            "supply": 0,
            "lastSale": {
                "price": 17700000000,
                "date": "2023-08-18T21:15:03.000Z",
                "txId": "36CY8tuw2qTtw12zz5SB8y3MvjsWdGsuNaDZhC86KVUBDTpoJUvKM4ANsRm1R79VD5NProXTHAKao3KjeNHQ5vfn",
                "usdPrice": 376.51,
                "currencyMint": "So11111111111111111111111111111111111111112"
            },
            "buyNowMetadata": {
                "date": "2024-01-20T18:44:27.000Z",
                "amount": 20000000000,
                "currencyMint": "So11111111111111111111111111111111111111112",
                "listingAccount": "7SWB1aRhQBnqSrbuXQEZ8FybNEAY3ZHGbSdLzZGHW7uQ",
                "startsAt": "2024-01-20T18:44:27.000Z",
                "buyerSetsPrice": false,
                "editionsLimit": 0
            },
            "creator": "DsSqaaKvuzkexQophftgPJqZqVi3Ki7VQcpGSwnXe9WZ",
            "listingMetadata": {
                "isLive": false,
                "listedAt": "2024-01-22T19:19:23.000Z",
                // Optional fields
                "endsAt": "2024-01-30T19:19:23.000Z",
                "whitelistConfig": {
                    "collectionsOrCreators": [
                        "5bLLG5gQLU2htdScXdyXYTFp8t1XqXTEiQbinj5ys5FF"
                    ],
                    "duration": 172800,
                    "endsAt": "2024-01-26T17:11:00.000Z"
                },
                "rewardsDescription": "after sell out, there are 2 prizes you can win by holding an edition in your wallet.\ni. a 308 satin 11x14 white bordered premium fine art print\nii. a 1/1 from my long form photography collection ‘moments past’\nthe more editions you hold the higher your chances"
            },
            // If listed on auction
            "auctionMetadata": AuctionMetadata,
            // If listed on raffle
            "raffleMetadata": {
                "wlCreators": [],
                "entrants": [
                    "6KjW9hT3YNqH3VMr7VvwfhLjorNRJREMBYfafsaYtKCu"
                ],
                "creator": "3aLqEkFQCMqnThGeXJg87XmJFThGuGWmK6Q1PhciqxTK",
                "entrantsAccount": "6dzkWokQa4XViXTGRXRX2huoAUX6rKC3REMz6uPyh85C",
                "raffleAccount": "DsfWd5AFQJYgdP7YUqoUUHiF54yNsyoESAJMgotuvorD",
                "countByEntrant": {
                    "6KjW9hT3YNqH3VMr7VvwfhLjorNRJREMBYfafsaYtKCu": 1
                },
                "currencyMint": "So11111111111111111111111111111111111111112",
                "endsAt": "2024-01-24T14:59:04.000Z",
                "isExpired": false,
                "price": 69000000,
                "sold": 1,
                "supply": 50,
                "ticketLimit": 0,
            },
            // On edition prints only
            "editionNumber": 14, 
            "masterEditionMint": "9qRqESq6cDaa8qfW15bQqRcPALYRJcdbgyBbc1YqsGJo",
        },
        "collection": {
            "description": "Tiiiny Rovers are a bunch of tiny misfits from the \"Tiiinyverse\". These characters embark on thrilling adventures, venturing into the vast and enthralling realms of web3.\n\nWith the spirited Tiiiny Denise by their side, they are looking forward to forging new friendships, uncover unexplored landscapes, and eagerly soak up mind-blowing tales that ignite their imaginations. ✨",
            "imageUrl": "https://arweave.net/tTbu52x7hCUFAx3882KBYuFHrqBuiHAjd3raUne0zLE",
            "name": "Tiiiny Rovers",
            "bannerUrl": "https://arweave.net/Og5dAuV4YJOzpollDON0m0A57_-KlzZG6hEUy78dPfQ",
            "mintAccount": "HcQ7J1W2RzzNCANmYAhLNGi2uU7pDgrH7WxQtgvEVpVG"
        },
        "url": "https://mallow.art/artwork/5Y44wPAX3yJButY74AfRKt8sFbZTXGZwxDmp9Uqfbyjd",
        "estimatedFees": {
            "mallow": 0,
            "metaplex": 10000000,
            "rent": 12809440,
            "tx": 5000,
            "txPriority": 100000
        },
    }
}

401 Permission denied

{
    "error": { 
        "message": "Invalid API Key" 
    }
}

400: Bad Request Bad request

{
    "error": { 
        "message": "Missing mint account" 
    }
}

404: Not Found Artwork has not been indexed on mallow

{
    "error": { 
        "message": "Artwork not found" 
    }
}

Name	Type	Description
page*	number	Page to fetch. Starts at 0.
sort*	string	Sort by recently-listed or ending-soon

200 Listed artwork results

{
    "result": [{
        "url": "https://mallow.art/artwork/5Y44wPAX3yJButY74AfRKt8sFbZTXGZwxDmp9Uqfbyjd",
        "mintAccount": "5Y44wPAX3yJButY74AfRKt8sFbZTXGZwxDmp9Uqfbyjd",
        "description": "Dr. Guulileo Guunstein, also known as Dr. Guu, is a mastermind of boundless ingenuity. His origins trace back to the unique realm known as the Guuniverse. Despite the \"Dr.\" title, Guulileo reigns as a revered professor in the intricate field of Biology, with his intellect devoted to unraveling the various lifeforms roaming the Web3 space.\n\nJourneying alongside him is Deniguu, a pint-sized companion with an extraordinary gift – the ability to replicate the chemical elements of whatever she consumes. Her unique ability stands as a vital tool in Dr. Guu's relentless pursuit of knowledge.\n\nAdorned with mystical Nenju beads, an heirloom granted by a benevolent monk, and the bio earring gifted by Lucha, Dr. Guu exists in an ethereal threshold, bridging the realms of science and the extraordinary.\n\n\"Magnificent! Absolutely marvelous!\"\n\nHe tilts his glasses while reviewing specimens, a mix of amazement and curiosity filling his eyes.",
        "imageUrl": "https://shdw-drive.genesysgo.net/2iHNWQtfUsth1F7dy6Mtjr9dHmYPZN7TZS4W2GcEwNTE/94ab618a2ed72f7e42a3d1a0728b55bf.png",
        "isImmutable": false,
        "listingType": "auction",
        "metadataUrl": "https://shdw-drive.genesysgo.net/2iHNWQtfUsth1F7dy6Mtjr9dHmYPZN7TZS4W2GcEwNTE/ecd5372f11084aeee4bd8d6f377a61ca.json",
        "name": "[003] Tiiiny \"Dr.Guu\" Rover",
        "creator": "DsSqaaKvuzkexQophftgPJqZqVi3Ki7VQcpGSwnXe9WZ",
        "owner": "Dyi3AeQcDKPhXLdsF2Avihh1ty43REGuCRGKvU8QEAAd",
        "videoUrl": "https://shdw-drive.genesysgo.net/2iHNWQtfUsth1F7dy6Mtjr9dHmYPZN7TZS4W2GcEwNTE/8e8ac3b818969a07c2f9415c512c56c3.mp4",
        "editionAccount": "4n4jNyMi9vmNLBC7p4hC3D1uRM3B6voju9Kz6cyCcUam",
        "supply": 0,
        "maxSupply": 0,
        "currentUsdPrice": 2004.20,
        "listingMetadata": {
            "isLive": true,
            "listedAt": "2024-01-22T19:19:23.000Z",
            "endsAt": "2024-01-30T19:19:23.000Z",
            // Optional creator-specified rewards
            "rewardsDescription": "after sell out, there are 2 prizes you can win by holding an edition in your wallet.\ni. a 308 satin 11x14 white bordered premium fine art print\nii. a 1/1 from my long form photography collection ‘moments past’\nthe more editions you hold the higher your chances"
        },
        "auctionMetadata": {
            "bidCount": 11,
            "bidders": [
                "FqTytZP8LWAdhXCmoQqAgfbHUTABb8GgAQeeBnSRsYLV",
                "Aq973kPmkk3atDBVKLvicfQmB5b4HEGHpM68iA5Rinnh",
                "7TMkv9qnmd5HP57sKirupoK9PgCknUvvvPzyxS8TezXg",
                "8yx9isdk39bzUcK3BaUe6FQrn1f789otpwr5nCbqk9ah",
                "4bxdEHxovNdkxMbJUHarphAFHD2MmsDWd2GmCvnrWv5q"
            ],
            "startsAt": "2024-01-23T17:54:39.000Z",
            "endsAt": "2024-01-24T00:17:25.000Z",
            "minBidIncrementBps": 500,
            "reservePrice": 690000000,
            "currentBidder": "Aq973kPmkk3atDBVKLvicfQmB5b4HEGHpM68iA5Rinnh",
            "currentBidAmount": 1500000000,
            "bidMint": "So11111111111111111111111111111111111111112",
            "auctionAccount": "7RV5JrHKsrqXRpJd7bJniZp85GRd8i76p6N3iMgYjpcg",
            "burnOnComplete": true, // true for DRiP Ultimates
        },
    }],
    // Total number of listings
    "total": 1,
    // Present when another page is available
    "nextPage": 1
}

401 Permission denied

{
    "error": { 
        "message": "Invalid API Key" 
    }
}

400: Bad Request Bad request

{
    "error": { 
        "message": "Missing search params" 
    }
}