API Reference
SDKMarketplace

Place order

post
https://api.element.market/openapi/v1/orders/post

This endpoint is used to create listing or offers on the Element contract.It is recommended to use the Element SDK to signature order parameters and place order.
Make Listings
Make Offers

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

Chain Name

string

Order Hash

string
required

Order exchange

string
required

The order maker's wallet address

string
required

The order taker's wallet address

int32
required

Side of the order. 0 for buy orders and 1 for sell orders.

int32
required

Kind of sell order. 0 for standard order, 3 for bulk listings.

string
required

The address of the smart contract of the payment token that is accepted or offered by the order. Native token is 0x0000000000000000000000000000000000000000.

string
required

The asset quantity of order.

string
required

The base price is the total price of the order, minus the fees. For example: totalPrice = unitPrice * quantity. fees = totalPrice * (feeBps / 10000). basePrice = totalPrice - fees.

string
required

The lowest selling price for Dutch auctions or the reserve price for British auctions, differentiated by saleKine (price increase/decrease percentage), default is 0.

string
required

Listing Time, default value is the current time minus 60 seconds.

string
required

Expiration Time, must be less than the current time plus 7,890,048 seconds (3 months).

metadata
object
required

Metadata Info.

fees
array of objects
required

Fees list

fees*
properties
array of objects

Optional. Only the combined offer can be used

properties
string
required

nonce

string
required

Hash Nonce

int32
required

Signature Type. 0 = EIP712 1 = PRESIGNED 2 = EIP712_BULK 3 = EIP712_1271 4 = EIP712_BULK_1271

int32
required
string
required
string
required
int32
required

When the order is matched in the smart contract, it will verify the off-chain oracle signature: 1-Verify (currently, only this type is accepted by Element), 0-Do not verify.

Responses

Updated about 1 year ago

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

Updated about 1 year ago