Listing Endpoints

Get listing creation actions

Changed on Nov 3, 2026

Returns the blockchain actions (approvals + Seaport order signing payload) needed to list one or more NFTs. This eliminates the need to construct Seaport orders manually.

post/api/v2/listings/actions

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/listings/actions/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

addressstring required

Maker (seller) wallet address

takerstring nullable

Optional taker address for private listings

use_creator_feeboolean nullable

Whether to include creator fees. Defaults to true.

Example request

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

Response

Listing creation actions retrieved successfully

Changes

Nov 3, 20262c7935d84f90 Revision changes
- info
  the request property // became nullable
- info
  the request property // became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history