mallow docs

Bid or buy

POST
/v1/getBidOrBuyTx

Generates a base64-encoded VersionedTransaction for bidding on an auction or buying from the marketplace. The transaction must be signed and sent by the buyer.

Warn bidders: a Core asset or collection with a Permanent* delegate plugin can be auctioned. If the delegate burns, moves or freezes the asset before settlement, the sale can't complete and the refund goes through support@mallow.art. After settlement, the bid can't be refunded.

Warn buyers: a Core asset or collection with a Permanent* delegate plugin can be listed. If the delegate burns, moves or freezes the asset after the purchase, it can't be refunded.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Whether this bids or buys is decided by how the artwork is listed — auctions get a bid, fixed-price listings get a purchase.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/getBidOrBuyTx" \  -H "Content-Type: application/json" \  -d '{    "buyer": "string",    "mint": "string"  }'
{  "result": {    "tx": "string"  }}