---
title: "Batch place order"
method: POST
path: "/openapi/v1/orders/postBatch"
tags: ["Orders"]
---

# Batch place order

`POST /openapi/v1/orders/postBatch`

This endpoint is used to batch create listings on the Element contract.It is recommended to use the Element SDK to signature order parameters and place listings order.<br><a href='https://element.readme.io/reference/sdk#making-listings'>Make Batch Listings</a>

## Request body

- PostOrderBatchReq — Batch place order
  - `exchange` string, required — Order exchange
  - `maker` string, required — The order maker's wallet address
  - `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
  - `listingTime` integer, required — Listing Time, default value is the current time minus 60 seconds.
  - `expirationTime` integer, required — Expiration Time, must be less than the current time plus 7,890,048 seconds (3 months).
  - `startNonce` integer, required — Start Nonce
  - `hashNonce` string, required — Hash Nonce
  - `v` integer, required
  - `r` string, required
  - `s` string, required
  - `chain` 'eth' | 'bsc' | 'polygon' | 'avalanche' | 'arbitrum' | 'zksync' | 'linea' | 'starknet' | 'opbnb' | 'base' | 'scroll' | 'manta_pacific' | 'optimism' | 'mantle' | 'zkfair' | 'blast' | 'merlin' | 'mode' | 'cyber' | 'bob' | 'lightlink' | 'zeta' | 'nibiru' | 'abstract' | 'bitlayer' | 'mantra' | 'monad' | 'ink', required — Chain Name
  - `hash` string, required — Order Hash
  - `platformFeeRecipient` string, required — Platform fee address
  - `oracleSignature` integer, 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.
  - `basicCollections` BatchPostCollection[], required
    - `nftAddress` string, required — Asset contract address
    - `platformFee` integer, required — Platform fee Ten thousand points ratio, 200 equals 2%
    - `royaltyFeeRecipient` string, required — Royalty address
    - `royaltyFee` integer, required — Royalty fee Ten thousand points ratio, 200 equals 2%
    - `items` BatchPostCollectionItem[]
      - `erc20TokenAmount` string — nft price
      - `nftId` string — Token id
  - `collections` BatchPostCollection[], required
    - `nftAddress` string, required — Asset contract address
    - `platformFee` integer, required — Platform fee Ten thousand points ratio, 200 equals 2%
    - `royaltyFeeRecipient` string, required — Royalty address
    - `royaltyFee` integer, required — Royalty fee Ten thousand points ratio, 200 equals 2%
    - `items` BatchPostCollectionItem[]
      - `erc20TokenAmount` string — nft price
      - `nftId` string — Token id

## Response `200`

OK

- ApiResponsePostOrderBatchResultList
  - `code` integer — Error Code
  - `msg` string — Error Message
  - `data` PostOrderBatchResultList — Return data, Generic
    - `successList` PostOrderBatchResultItem[] — Success post list
      - `assetContract` string — Asset contract address
      - `assetTokenId` string — Asset token id
      - `errorDetail` string — Error detail message
      - `orderId` string — Order Id
    - `failList` PostOrderBatchResultItem[] — Fail post list
      - `assetContract` string — Asset contract address
      - `assetTokenId` string — Asset token id
      - `errorDetail` string — Error detail message
      - `orderId` string — Order Id
  - `message` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/element/apis/element-open-api.md) · [All operations](https://skmtc.net/element/apis/element-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/element/element-open-api/versions/fa83ac7feb23/schema)