POST /getBidOrBuyTx

Bid on an auction or buy an item

POST https://api.mallow.art/v1/getBidOrBuyTx

Generates a base64 encoded VersionedTransaction to bid on an auction or buy an item from the marketplace. The transaction must be signed and sent by the buyer.

Request Body

Name	Type	Description
buyer*	string	The buyer's wallet address
mint*	string	The mint address of the artwork to purchase
price	number	The price to use for the bid if the NFT is listed on auction, or price to use for a SYOP edition purchase. Otherwise ignored. NOTE: price does not include decimals, use lamports for SOL listings and full token amount for tokens (e.g. 5000000000 for 5 SOL / 6000000 for 6 USDC)
receiver	string	Receiver of the NFT when buying an item. Defaults to buyer. Ignored for auction listings.
transactionPriorityFeeLamports	string	Priority fee in lamports to spend on the transaction. Defaults to 100000.

200 Transaction successfully generated

{
    "result": "AQAAAAAAAAAAA...AAAHL2xa1PfAJQ1dwAAAAA="
}

401 Permission denied

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

400: Bad Request

{
    "error": { 
        "message": "Missing buyer" 
    }
}

404: Not Found

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

Edition sales with an allow-list are not yet supported by this endpoint. Check the listingMetadata.whitelistConfig field in the /artworks/:mintAccount response to see if a listing is for an allow-list.