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

Body Params

chain

string

required

Chain Name

hash

string

Order Hash

exchange

string

required

Order exchange

maker

string

required

The order maker's wallet address

taker

string

required

The order taker's wallet address

side

int32

required

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

saleKind

int32

required

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

paymentToken

string

required

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

quantity

string

required

The asset quantity of order.

basePrice

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.

extra

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.

listingTime

string

required

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

expirationTime

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

nonce

string

required

nonce

hashNonce

string

required

Hash Nonce

signatureType

int32

required

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

int32

required

string

required

string

required

oracleSignature

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

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.element.market/openapi/v1/orders/post \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '{"chain":"eth"}'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Bad Request

429Too Many Requests

500Internal Server Error