This guide covers what fees are required to be in an order, Listing or Offer, created by the OpenSea API. It will give instructions on how to retrieve the current fees and also where the fees must be included in the order.

Retrieving the Current Fees

An order may need to include applicable marketplace fees. In addition, an order may include creator fees which are variably set by the authorized editors on the collection. Not all NFTs or collections have the same associated fees, so it's helpful to use our Collections API to determine what the fees are before you create an offer or listing.

The API includes an endpoint to retrieve the details of a single collection. This collection gives a lot of detailed information, but for this purpose, the important field is fees.

Example Request
https://api.opensea.io/api/v2/collections/doodles-official

Example Response

{
    "name": "Doodles Original Collection",
    ...
    "fees": [
    {
      "fee": 2.5,
      "recipient": "0x0000a26b00c1f0df003000390027140000faa719",
      "required": true
    },
    {
      "fee": 5,
      "recipient": "0xd1f124cc900624e1ff2d923180b3924147364380",
      "required": false
    }
  ],

The response gives the fee value in basis points. In this example, OpenSea fees are 250 basis points, 2.5%, and the creator fees are 500 basis points, 5%. Orders posted to OpenSea must include any applicable fees on the collection.

Where to set fees?

The fees need to be included in the consideration array for an order, whether it is a listing or offer. The below example is a listing for 7 ETH. In the consideration array, there are 2 values. The first is the amount of ether, denominated in wei, which will be sent to the seller. The second item in the consideration array is the 0.175 ether which will be sent to OpenSea for the marketplace fee.

 {
      "order_hash": "0x",
      "chain": "ethereum",
      "type": "basic",
      "price": {
        "current": {
          "currency": "ETH",
          "decimals": 18,
          "value": "7000000000000000000"
        }
      },
      "protocol_data": {
        "parameters": {
          "offerer": "0x9df9e6c3ec19383069fcaec78b5cd74a90a60e03",
          "offer": [
            {
              "itemType": 2,
              "token": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
              "identifierOrCriteria": "9719",
              "startAmount": "1",
              "endAmount": "1"
            }
          ],
          "consideration": [
            {
              "itemType": 0,
              "token": "0x0000000000000000000000000000000000000000",
              "identifierOrCriteria": "0",
              "startAmount": "6825000000000000000",
              "endAmount": "6825000000000000000",
              "recipient": "0x9Df9e6C3Ec19383069FCaEc78B5Cd74a90A60E03"
            },
            {
              "itemType": 0,
              "token": "0x0000000000000000000000000000000000000000",
              "identifierOrCriteria": "0",
              "startAmount": "175000000000000000",
              "endAmount": "175000000000000000",
              "recipient": "0xd1F124cc900624e1ff2d923180b3924147364380"
            }
          ],
				  ...,
        },
		...
    }
}