Create listing

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

seller must own the asset and the asset must not be frozen. endTime is a Unix timestamp after which the listing expires, and memo is written on-chain alongside the listing.

editionsLimit, buyerSetsPrice and startTime are master-edition-only and are rejected on a 1/1. editionsLimit caps how many prints the listing offers: 0–65535, and for limited editions no more than the remaining mintable supply (maxSupply − supply). buyerSetsPrice lets buyers pay any amount at or above price. startTime is a Unix timestamp deferring when the listing goes live. A 1/1 is always active from the moment its transaction confirms and always sells at exactly price — sending buyerSetsPrice: false or startTime: 0 on one is fine.

The response may include a setupTx alongside tx that tx depends on — sign and confirm setupTx first, then broadcast 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.

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

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/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

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`