Make offer

Builds an offer from buyer on asset at price, in currencyMint (SOL when omitted). The funds are held in escrow until the offer is accepted or cancelled.

Offers can be made on 1/1s and edition prints, but not on an asset the buyer already owns. If buyer already has an offer on asset, it is updated instead; an update can't change the currency.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Makes an offer (bid) on an artwork, escrowing the funds on-chain when the transaction confirms. If the buyer already has an open offer on this mint, the offer is updated rather than duplicated.

buyer*string

Wallet making the offer (base58). Signs and escrows the funds.

asset*string

Mint address of the artwork being offered on (base58).

price*integer

Offer amount in the currency's base units (lamports for SOL). Must be a positive integer.

Formatuint64

currencyMint?string

SPL token mint the offer is denominated in (base58). Defaults to SOL when omitted.

Default"So11111111111111111111111111111111111111112"

endTime?integer

Unix timestamp in seconds after which the offer lapses. Omit for an offer that does not expire.

Formatint64

oneOfOneOnly?boolean

Restrict the offer to 1/1 artworks, so it cannot be filled with an edition print.

targetPriorityFeeLamports?integer

Priority fee per transaction, in lamports. By default it is a cap: mallow pays what the network currently needs, up to this amount (50,000 when omitted). Set exactPriorityFee to pay exactly this amount instead. The fee is never less than 15,000 lamports.

Formatuint64

exactPriorityFee?boolean

Pay targetPriorityFeeLamports exactly instead of treating it as a cap. Defaults to false.

blockhash?string

Recent blockhash to build the transaction with (base58). Omit it to let mallow supply one; identical requests a few seconds apart then return the same transaction.

Response Body

`application/json`

curl -X POST "https://example.com/v2/tx/offers/create" \  -H "Content-Type: application/json" \  -d '{    "buyer": "string",    "asset": "string",    "price": 0  }'

{  "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`