Create listing

Builds a fixed-price listing of asset by seller at price, in currencyMint (SOL when omitted). seller must own the asset.

editionsLimit, buyerSetsPrice and startTime apply only to master editions. If the response includes setupTx, send and confirm it before tx.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Lists an artwork at a fixed price.

seller*string

Wallet listing the artwork (base58). Must own it, and the asset must not be frozen.

asset*string

Mint address of the artwork to list (base58).

price*integer

Listing price in the currency's base units (lamports for SOL).

Formatuint64

Range1 <= value

currencyMint?string

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

Default"So11111111111111111111111111111111111111112"

buyerSetsPrice?boolean

Let buyers pay any amount at or above price, rather than exactly price. Master editions only — true is rejected on 1/1s.

startTime?integer

Unix timestamp in seconds when the listing becomes active. Active immediately when omitted. Master editions only — a value above 0 is rejected on 1/1s, which are always active from the moment the listing transaction confirms.

Formatint64

endTime?integer

Unix timestamp in seconds when the listing expires. Never expires when omitted.

Formatint64

enablePrimarySplit?boolean

Split the primary-sale proceeds among the on-chain creators by their shares. Omitted or false pays the seller instead, with royalties still going to the creators.

editionsLimit?integer

For master editions, how many prints this listing offers (0–65535). May not exceed the remaining mintable supply (maxSupply − supply). Rejected on 1/1s.

Formatuint32

memo?string

Free-form note written on-chain alongside the listing.

groupId?string

mallow group id that ties several listings together as one drop.

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/fixed-price/create" \  -H "Content-Type: application/json" \  -d '{    "seller": "string",    "asset": "string",    "price": 1  }'

{  "result": {    "tx": "string",    "setupTx": "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`