Create a single order

Submit an order (ask or bid) into our off-chain order book.

Notes: We recommend you to check our comprehensive explanation on the order data, and guides to create an order object and generate a signature.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request payload for creating an order

number
enum
required

There are 2 quote types: Ask (1) or Bid (0)

Allowed:
string
required

User's current bid / ask nonce

string
required

Subset nonce used to group an arbitrary number of orders under the same nonce

string
required

Nonce for this specific order

number
enum
required

Id of strategy that order's using. We support 2 strategies as of now; Standard (0) and Collection (1) strategy

Allowed:
number
enum
required

Collection type id: ERC-721 (0), ERC-1155 (1)

Allowed:
string
required
length between 42 and 42

Collection contract address

string
required
length between 42 and 42

Currency address. Use zero address to represent ETH. For Ask, only ETH is allowed. For Bid, only WETH is allowed.

string
required
length between 42 and 42

Signer address

number
required

Timestamp in second of the time when the order starts to be valid There are few limits:

  • startTime cannot be 5 minutes older than the current time
  • startTime cannot be 180 days after the current time
number
required

Timestamp in second of the time when the order becomes invalid limits:

  • endTIme cannot be 180 days after the current time
string
required

String representation of the minimum price to be received after the trade, wei-based.

itemIds
array of strings
required

List of item IDs We currently allow only 1 item IDs at max. In case of collections strategy, this can be an empty array.

itemIds*
amounts
array of strings
required

List of amount for each item ID for ERC721, it should be 1 for ERC1155, it should be less than 100

amounts*
string
required

Additional parameters for complex orders. They should be encoded and in hexstring format. When not using additional parameters, this should be "0x".

string
required

65-length ECDSA signature in Ethereum. It should start with 0x.

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json