---
title: "Sweep buy items from a collection"
method: POST
path: "/api/v2/listings/sweep"
tags: ["Listing Endpoints"]
---

# Sweep buy items from a collection

`POST /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.

## Request body

- SweepCollectionRequest — Request to sweep buy items from a collection
  - `collection_slug` string, required — The slug of the collection to sweep
  - `payment` CrossChainPaymentToken, required — Payment token to use for a cross-chain transaction
    - `chain` string, required — Chain of the payment token (e.g. 'base', 'ethereum')
    - `token_address` string, required — Contract address of the payment token (use 0x0000000000000000000000000000000000000000 for native token)
  - `max_items` integer, required — Maximum number of items to buy (1-50)
  - `max_price_per_item` string, required — Maximum price per item in the payment token's units
  - `buyer` string, required — Address of the buyer
  - `recipient` string — Optional recipient address for the purchased items

## Response `200`

Sweep fulfillment data retrieved successfully

## Other responses

- `400` — The request is invalid. Possible reasons: collection not found, invalid chain, max_items exceeds limit, or no listings available.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal server error. Please open a support ticket so OpenSea can investigate.

---

[API](https://skmtc.net/opensea/apis/opensea-api.md) · [All operations](https://skmtc.net/opensea/apis/opensea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opensea/opensea-api/versions/acee8835f2ae/schema)