POST /scheduledBids/getBidTx

Schedule a bid on an auction

POST https://api.mallow.art/v1/scheduledBids/getBidTx

Generates a base64 encoded VersionedTransaction to schedule a bid on an auction. The transaction must be signed and sent by the bidder.

A bidder can only have one active scheduled bid per artwork mint at a time. Bids are scheduled to be placed 30 minutes before the end of the auction. The highest valid bid at the scheduled time will be placed and all other bids are automatically cancelled and returned to the bidder.

NOTE: The service charges a 0.00005 SOL fee to cover automated transaction costs.

Request Body

Name	Type	Description
bidder*	string	The bidder's wallet address
mint*	string	The mint address of the artwork to bid on
amount*	number	The bid amount to use for the bid 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
bidMint*	string	The bidding currency mint. Use So11111111111111111111111111111111111111112 for auctions in SOL.
blockhash	String	(Optional) Recent blockhash to use for the transaction

200 Transaction successfully generated

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

401 Permission denied

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

400: Bad Request Bad request

{
    "error": { 
        "message": "Missing required fields" 
    }
}

404: Not Found

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