Fulfill an offer

📘
Note
Calling this endpoint does NOT fulfill the offer in question. It provides the data needed for the client to fulfill the listing directly through the protocol contract (on chain).

This endpoint is used to generate fulfillment data for offers. The response contains all of the information needed for clients to fulfill an offer directly on chain.

Is fulfillment of collection and trait offers supported?
Yes! You just need to pass in the NFT you are fulfilling the offer with as consideration. The fulfiller account must own this NFT or the request will not succeed.

Request

Name	Type	Description
offer	Offer	Offer you are planning to fulfill
fulfiller	Fulfiller	Account fulfilling the offer
consideration	Consideration	If the offer you are fulfilling is a criteria offer, the NFT you are using to fulfill the offer with. The `fulfiller` account must own this NFT or the request will not succeed.

Offer Model

Field	Type	Description
hash	string	hash of the offer
chain	string	name of the chain
protocol_address	string	address of the exchange contract used to place the offer

Fulfiller Model

Field	Type	Description
address	string	wallet address of the intended fulfiller

Consideration Model

Field	Type	Description
asset_contract_address	string	The contract address of the NFT you are fulfilling with
token_id	string	The

Sample Payload

{
    "offer": {
        "hash": "0x35de6f4f16bd28271f3625a90bf3cd1e7dcd8d5b0bb16d5edb3b98d5fdbfb8ae",
        "chain": "goerli",
        "protocol_address": "0x00000000006c3852cbEf3e08E8dF289169EdE581"
    },
    "fulfiller": {
        "address": "0xD77F375A33b1109e82f3C46A30537F1E019708eB"
    },
    "consideration": {
        "asset_contract_address": "0x1a92f7381b9f03921564a437210bb9396471050c",
        "token_id": "6162"
    }
}

Supported Protocols:

Seaport 1.4 (0x00000000006c3852cbEf3e08E8dF289169EdE581)

Response

Name	Type	Description	Description
protocol	string	name of the protocol contract
fulfillment_data	object	data needed to fulfill the listing on chain	--

Fulfillment Data Model

Name	Type	Description
transaction	object	specifies the name of the fulfillment method and the call data
orders	array of object	array of Seaport orders

Transaction Data Model

Name	Type	Description
function	string	the protocol contract method used for listing fulfillment
chain	int	numeric chain identifier
to	str	address of the protocol contract used for fulfillment
value	int	wei value of the transaction
input_data	dict	decoded call data

Sample Response

{
  "protocol": "seaport",
  "fulfillment_data": {
    "transaction": {
      "function": "fulfillBasicOrder((address,uint256,uint256,address,address,address,uint256,uint256,uint8,uint256,uint256,bytes32,uint256,bytes32,bytes32,uint256,(uint256,address)[],bytes))",
      "chain": 1,
      "to": "0x00000000006c3852cbef3e08e8df289169ede581",
      "value": 0,
      "input_data": {
        "parameters": {
          "considerationToken": "0xd78b76fcc33cd416da9d3d42f72649a23d7ac647",
          "considerationIdentifier": 3171,
          "considerationAmount": 1,
          "offerer": "0x13e5f9702139053f8393590ed668bee6061b5d47",
          "zone": "0x004c00500000ad104d7dbd00e3ae0a5c00560c00",
          "offerToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "offerIdentifier": 0,
          "offerAmount": 281699999999999950,
          "basicOrderType": 18,
          "startTime": 1670823187,
          "endTime": 1670837588,
          "zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
          "salt": 24446860302761739304752683030156737591518664810215442929817804398026903354364,
          "offererConduitKey": "0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000",
          "fulfillerConduitKey": "0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000",
          "totalOriginalAdditionalRecipients": 2,
          "additionalRecipients": [
            {
              "amount": 7042499999999998,
              "recipient": "0x0000a26b00c1f0df003000390027140000faa719"
            },
            {
              "amount": 21127499999999996,
              "recipient": "0x48c15a1c597c972a85f1a15bddbb07f93785579a"
            }
          ],
          "signature": "0x7337f22d90210f85cf7791cf55096727f415bc3d8993b33e85127580827be34a31e53cf753c001559016b141c110644117bc637f3c2189a9d7886d6f309118621c"
        }
      }
    },
    "orders": [
      {
        "parameters": {
          "offerer": "0x13e5f9702139053f8393590ed668bee6061b5d47",
          "offer": [
            {
              "itemType": 1,
              "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
              "identifierOrCriteria": "0",
              "startAmount": "281699999999999950",
              "endAmount": "281699999999999950"
            }
          ],
          "consideration": [
            {
              "itemType": 2,
              "token": "0xD78b76Fcc33cd416dA9d3D42f72649a23D7AC647",
              "identifierOrCriteria": "3171",
              "startAmount": "1",
              "endAmount": "1",
              "recipient": "0x13e5f9702139053F8393590Ed668Bee6061b5d47"
            },
            {
              "itemType": 1,
              "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
              "identifierOrCriteria": "0",
              "startAmount": "7042499999999998",
              "endAmount": "7042499999999998",
              "recipient": "0x0000a26b00c1F0DF003000390027140000fAa719"
            },
            {
              "itemType": 1,
              "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
              "identifierOrCriteria": "0",
              "startAmount": "21127499999999996",
              "endAmount": "21127499999999996",
              "recipient": "0x48c15A1C597C972a85f1A15BDdBb07F93785579A"
            }
          ],
          "startTime": "1670823187",
          "endTime": "1670837588",
          "orderType": 2,
          "zone": "0x004C00500000aD104D7DBd00e3ae0A5C00560C00",
          "zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
          "salt": "0x360c6ebe0000000000000000000000000000000000000000f1c65891c65d7bfc",
          "conduitKey": "0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000",
          "totalOriginalConsiderationItems": 3,
          "counter": 0
        },
        "signature": "0x7337f22d90210f85cf7791cf55096727f415bc3d8993b33e85127580827be34a31e53cf753c001559016b141c110644117bc637f3c2189a9d7886d6f309118621c"
      }
    ]
  }
}