Make offer

Builds an offer (bid) from buyer on asset at price, denominated in currencyMint — SOL when omitted. Funds are escrowed on-chain when the transaction confirms.

price must be a positive integer in the currency's base units. Offers are only supported on 1/1s and edition prints; other supply types are rejected with a 400, as are pNFT, cNFT and Objkt assets.

If buyer already has an open offer on asset, this updates the existing offer instead of creating a second one — the on-chain program rejects duplicates. endTime is a Unix timestamp after which the offer lapses, and oneOfOneOnly restricts the offer to 1/1s.

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.

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

Total priority fee to target for this transaction, in lamports. The builder derives the compute-unit price from it and the transaction's compute budget. Omit to let mallow pick a fee from current network conditions.

Formatuint64

blockhash?string

Recent blockhash to stamp onto the transaction, base58. Omit to let mallow supply one — mallow's is cached for up to 10 seconds, so two identical requests inside that window compile the same transaction, with the same signature once signed. Supply your own to control the expiry window, or when otherwise-identical requests must produce distinct transactions. Rejected with a 400 if it is not valid base58; a blockhash the cluster has already aged out builds fine and fails at send time.

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

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`