Sell Tokens

post

https://api.reservoir.tools/execute/sell/v7

Use this API to accept bids. We recommend using the SDK over this API as the SDK will iterate through the steps and return callbacks. Please mark excludeEOA as true to exclude Blur orders.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

items

array of objects

required

length ≥ 1

List of items to sell.

items*

token

string

required

Token to sell.

quantity

integer

Defaults to 1

Quantity of tokens to sell.

orderId

string

Optional order id to sell into.

rawOrder

object

Optional raw order to sell into.

exactOrderSource

array of strings

length ≤ 2

exactOrderSource

exclusions

array of objects

Items to exclude

exclusions

taker

string

required

Address of wallet filling.

source

string

Filling source used for attribution.

feesOnTop

array of strings

List of fees (formatted as feeRecipient:feeAmount) to be taken when filling. The currency used for any fees on top is always the wrapped native currency of the chain. Example: 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00:1000000000000000

feesOnTop

onlyPath

boolean

Defaults to false

If true, only the filling path will be returned.

normalizeRoyalties

boolean

Defaults to false

Charge any missing royalties.

excludeEOA

boolean

Defaults to false

Exclude orders that can only be filled by EOAs, to support filling with smart contracts.

allowInactiveOrderIds

boolean

Defaults to false

If true, inactive orders will not be skipped over (only relevant when filling via a specific order id).

partial

boolean

Defaults to false

If true, any off-chain or on-chain errors will be skipped.

forceRouter

boolean

Defaults to true

If true, filling will be forced to use the common 'approval + transfer' method instead of the approval-less 'on-received hook' method

swapProvider

string

enum

Defaults to uniswap

Choose a specific swapping provider when receiving in a different currency (defaults to uniswap)

Allowed:

forwarderChannel

string

If passed, all fills will be executed through the trusted trusted forwarder (where possible)

currency

string

Currency to be received when selling.

maxFeePerGas

string

Optional custom gas settings. Includes base fee & priority fee in this limit.

maxPriorityFeePerGas

string

Optional custom gas settings.

x2y2ApiKey

string

Optional X2Y2 API key used for filling.

openseaApiKey

string

Optional OpenSea API key used for filling. You don't need to pass your own key, but if you don't, you are more likely to be rate-limited.

blurAuth

string

Optional Blur auth used for filling

200Successful