Sign in

v1

latestOpenAPI 3.0.32026-07-2659172194.6 KB
orders

Create a trait bid

Create a trait bid on NFTs matching specific trait criteria within a collection

post/v1/chains/{chain_name}/orders/trait-bids

Path parameters

chain_namestring required

The name of chain

Example:imtbl-zkevm-testnet

Request body

account_addressstring required
order_hashstring required
end_atstring date-time required

Time after which the Order is considered expired

saltstring required

A random value added to the create Order request

signaturestring required

Digital signature generated by the user for the specific Order

start_atstring date-time required

Time after which Order is considered active

Example request

{
  "account_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  "order_hash": "0x0821933d9391bc9bf11a6010fe84776c84b203abff0c1ad781fb4881409c8770",
  "sell": [
    {
      "type": "ERC20",
      "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.5"
  },
  "salt": "12686911856931635052326433555881236148",
  "buy": [
    {
      "type": "ERC721_COLLECTION",
      "contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
      "amount": "1"
    }
  ],
  "signature": "0x",
  "start_at": "2022-03-09T05:00:50.52Z",
  "trait_criteria": [
    {
      "trait_type": "Background",
      "values": [
        "Blue",
        "Red"
      ]
    }
  ]
}

Response

Created response.

Example response

{
  "result": {
    "account_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
    "sell": [
      {
        "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-9E05C598534A",
    "order_hash": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
    "protocol_data": {
      "order_type": "PARTIAL_RESTRICTED",
      "counter": "1",
      "zone_address": "0x12",
      "seaport_address": "0x12",
      "seaport_version": "1.5"
    },
    "salt": "12686911856931635052326433555881236148",
    "buy": [
      {
        "type": "ERC721_COLLECTION",
        "contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
        "amount": "1"
      }
    ],
    "signature": "0x",
    "start_at": "2022-03-09T05:00:50.52Z",
    "status": {
      "name": "EXPIRED"
    },
    "type": "TRAIT_BID",
    "updated_at": "2022-03-07T07:20:50.52Z"
  }
}