Bid or buy

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.

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.

buyer*string

Wallet bidding or buying (base58). Must sign and send the returned transaction.

Length1 <= length

mint*string

Mint address of the artwork (base58).

Length1 <= length

price?number

Amount to pay or bid, in the listing currency's base units. Required when bidding on an auction; for a fixed-price buy it is optional and the listed price is used when omitted.

receiver?string

Wallet that receives the artwork (base58). Defaults to buyer when omitted.

Length1 <= length

transactionPriorityFeeLamports?string

Priority fee to target, in lamports, as a decimal string. Omit to let mallow pick one from current network conditions.

Response Body

`application/json`

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

{  "result": {    "tx": "string"  }}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`