Create Listings

post

https://api.reservoir.tools/execute/list/v5

Generate listings and submit them to multiple marketplaces.

Notes:

Please use the /cross-posting-orders/v1 to check the status on cross posted bids.
We recommend using Reservoir SDK as it abstracts the process of iterating through steps, and returning callbacks that can be used to update your UI.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

maker

string

required

Address of wallet making the order. Example: 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00

source

string

Domain of your app that is creating the order, e.g. myapp.xyz. This is used for filtering, and to attribute the "order source" of sales in on-chain analytics, to help your app get discovered. Lean more here

blurAuth

string

Advanced use case to pass personal blurAuthToken; the API will generate one if left empty.

params

array of objects

length ≥ 1

params

token

string

required

The token the user is listing. Example: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:123

quantity

number

Quantity of tokens user is listing. Only compatible with ERC1155 tokens. Example: 5

weiPrice

string

required

Amount seller is willing to sell for in the smallest denomination for the specific currency. Example: 1000000000000000000

endWeiPrice

string

Amount seller is willing to sell for Dutch auction in the largest denomination for the specific currency. Example: 2000000000000000000

orderKind

string

enum

Defaults to seaport-v1.5

Exchange protocol used to create order. Example: seaport-v1.5

options

object

Additional options.

orderbook

string

enum

Defaults to reservoir

Orderbook where order is placed. Example: Reservoir

Allowed:

orderbookApiKey

string

Optional API key for the target orderbook

automatedRoyalties

boolean

Defaults to true

If true, royalty amounts and recipients will be set automatically.

royaltyBps

number

Set a maximum amount of royalties to pay, rather than the full amount. Only relevant when using automated royalties. 1 BPS = 0.01% Note: OpenSea does not support values below 50 bps.

fees

array of strings

Deprecated, use marketplaceFees and/or customRoyalties

fees

marketplaceFees

array of strings

List of marketplace fees (formatted as feeRecipient:feeBps) to be bundled within the order. 1 BPS = 0.01% Example: 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00:100

marketplaceFees

marketplaceFlatFees

array of strings

List of marketplace flat fees (formatted as feeRecipient:weiAmount) to be bundled within the order.

marketplaceFlatFees

customRoyalties

array of strings

List of custom royalties (formatted as feeRecipient:feeBps) to be bundled within the order. 1 BPS = 0.01% Example: 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00:100

customRoyalties

listingTime

string

Unix timestamp (seconds) indicating when listing will be listed. Example: 1656080318

expirationTime

string

Unix timestamp (seconds) indicating when listing will expire. Example: 1656080318

salt

string

Optional. Random string to make the order unique

nonce

string

Optional. Set a custom nonce

currency

string

Defaults to 0x0000000000000000000000000000000000000000

taker

string

Address of wallet taking the private order. Example: 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00

200Successful