Skip to main content
POST
/
v1
/
chains
/
{chain_name}
/
orders
/
listings
Create a listing
curl --request POST \
  --url https://api.sandbox.immutable.com/v1/chains/{chain_name}/orders/listings \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  "order_hash": "0x0821933d9391bc9bf11a6010fe84776c84b203abff0c1ad781fb4881409c8770",
  "buy": [
    {
      "type": "NATIVE",
      "amount": "9750000000000000000",
      "contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
    }
  ],
  "fees": [
    {
      "type": "MAKER_ECOSYSTEM",
      "amount": "2250000000000000000",
      "recipient_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92233"
    }
  ],
  "end_at": "2022-03-10T05:00:50.52Z",
  "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"
}
'
{
  "result": {
    "account_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
    "buy": [
      {
        "type": "ERC20",
        "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-9E05C598534B",
    "order_hash": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
    "protocol_data": {
      "order_type": "FULL_RESTRICTED",
      "counter": "1",
      "zone_address": "0x12",
      "seaport_address": "0x12",
      "seaport_version": "1.5"
    },
    "salt": "12686911856931635052326433555881236148",
    "sell": [
      {
        "type": "ERC721",
        "contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
        "token_id": "1"
      }
    ],
    "signature": "0x",
    "start_at": "2022-03-09T05:00:50.52Z",
    "status": {
      "name": "EXPIRED"
    },
    "type": {
      "name": "LISTING"
    },
    "updated_at": "2022-03-07T07:20:50.52Z"
  }
}

Path Parameters

​
chain_name
string
required

The name of chain

Example:

"imtbl-zkevm-testnet"

Body

application/json
​
account_address
string
required
Example:

"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

​
order_hash
string
required
Example:

"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

​
buy
object[]
required

Buy item for listing should either be NATIVE or ERC20 item

Required array length: 1 element
Example:
[
  {
    "type": "NATIVE",
    "amount": "9750000000000000000",
    "contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
  }
]
​
fees
object[]
required

Buy fees should only include maker marketplace fees and should be no more than two entries as more entires will incur more gas. It is best practice to have this as few as possible.

Maximum array length: 2
Example:
[]
​
end_at
string<date-time>
required

Time after which the Order is considered expired

Example:

"2022-03-09T05:00:50.52Z"

​
protocol_data
object
required
Example:
{
  "order_type": "FULL_RESTRICTED",
  "counter": "92315562",
  "zone_address": "0x12",
  "seaport_address": "0x12",
  "seaport_version": "1.5"
}
​
salt
string
required

A random value added to the create Order request

Example:

"12686911856931635052326433555881236148"

​
sell
object[]
required

Sell item for listing should be an ERC721 item

Required array length: 1 element
Example:
[
  {
    "type": "ERC721",
    "contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
    "token_id": "1"
  }
]
​
signature
string
required

Digital signature generated by the user for the specific Order

Example:

"0x"

​
start_at
string<date-time>
required

Time after which Order is considered active

Example:

"2022-03-09T05:00:50.52Z"

Response

Created response.

​
result
object
required
Example:
{
  "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"
}