API Endpoints
OpenSea

Sweep buy items from a collection

post
https://api.opensea.io/api/v2/listings/sweep

Buy up to N items from a collection using any payment token, including cross-chain. If a requested item becomes unavailable, the system can automatically substitute it with the next cheapest listing from the same collection (enabled by default). Returns an ordered list of transactions to execute.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request to sweep buy items from a collection

string
required

The slug of the collection to sweep

payment
object
required

The token to pay with

int32
required

Maximum number of items to buy (1-50)

string
required

Maximum price per item in the payment token's units

string
required

Address of the buyer

string

Optional recipient address for the purchased items

Responses

400

The request is invalid. Possible reasons: collection not found, invalid chain, max_items exceeds limit, or no listings available.

500

Internal server error. Please open a support ticket so OpenSea can investigate.

Updated 8 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*

Updated 8 days ago