Sign in

v1

latestOpenAPI 3.0.32026-07-2659172194.6 KB
orders

Retrieve fulfillment data for orders

Retrieve signed fulfillment data based on the list of order IDs and corresponding fees.

post/v1/chains/{chain_name}/orders/fulfillment-data

Path parameters

chain_namestring required

The name of chain

Example:imtbl-zkevm-testnet

Request body

order_idstring uuid required
taker_addressstring required

Address of the intended account fulfilling the order

token_idstring

Token ID for the ERC721 or ERC1155 token when fulfilling a collection order

Example request

[
  {
    "taker_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
    "fees": [
      {
        "type": "TAKER_ECOSYSTEM",
        "amount": "2250000000000000000",
        "recipient_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92233"
      }
    ],
    "token_id": "123"
  }
]

Response

Successful response

Example response

{
  "result": {
    "fulfillable_orders": [
      {
        "order": {
          "account_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
          "buy": [
            {
              "type": "NATIVE",
              "amount": "9750000000000000000",
              "contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
            }
          ],
          "fees": [],
          "chain": {
            "id": "eip155:11155111",
            "name": "sepolia"
          },
          "created_at": "2022-03-07T07:20:50.52Z",
          "end_at": "2022-03-10T05:00:50.52Z",
          "id": "018792C9-4AD7-8EC4-4038-9E05C598534A",
          "protocol_data": {
            "order_type": "FULL_RESTRICTED",
            "counter": "1",
            "zone_address": "0x12",
            "seaport_address": "0x12",
            "seaport_version": "1.4"
          },
          "salt": "12686911856931635052326433555881236148",
          "sell": [
            {
              "type": "ERC721",
              "contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
              "token_id": "1"
            }
          ],
          "signature": "0x",
          "start_at": "2022-03-09T05:00:50.52Z",
          "status": {
            "name": "ACTIVE"
          },
          "fill_status": {
            "numerator": 1,
            "denominator": 2
          },
          "type": "LISTING",
          "updated_at": "2022-03-07T07:20:50.52Z"
        },
        "token_id": "123"
      }
    ],
    "unfulfillable_orders": [
      {
        "order_id": "7df3e99e-f7b3-459c-bef6-ffb66a18bb59",
        "token_id": "123",
        "reason": "Invalid order status INACTIVE for order 7df3e99e-f7b3-459c-bef6-ffb66a18bb59"
      }
    ]
  }
}