OPopensea
Offer Endpoints

Get offer creation actions

Changed on

Returns the blockchain actions needed to offer on an NFT, the offer-side counterpart of the listing actions endpoint. On EVM chains these are payment approvals followed by a Seaport order to sign, which the signature endpoints then accept. On Solana the actions instead carry an unsigned bid transaction to sign and submit onchain; there is no order to post back to OpenSea afterwards.

post/api/v2/offers/actions

Request

Request body

addressstring required

Maker (buyer) wallet address

end_timestring nullable

Offer end time in ISO 8601 format. Defaults to 30 days from start.

quantityinteger required

Quantity to offer on (use 1 for ERC-721)

start_timestring nullable

Offer start time in ISO 8601 format. Defaults to now.

use_creator_feeboolean nullable

Whether to include optional creator fees. Defaults to false.

Example request

{
  "address": "0x...",
  "end_time": "2026-06-01T00:00:00Z",
  "item": {
    "chain": "ethereum",
    "contract": "0x...",
    "token_id": "1234"
  },
  "price": {
    "amount": "5.0",
    "currency": "0x0000000000000000000000000000000000000000"
  },
  "quantity": 1,
  "start_time": "2026-05-01T00:00:00Z"
}

Response

Offer creation actions retrieved successfully

Changes