Marketplace API

Cancel orders#

Use this API to cancel orders.

Request address#

POST https://www.okx.com/api/v5/mktplace/nft/markets/cancel-listing

Request param#

ParameterTypeRequiredDescription
chainStringYesChain name refer to Supported blockchains for details
walletAddressStringYesWallet address for creating the listing.
orderIdsList<String>YesList of orderId to cancel.

Request example#

shell
curl -X POST "https://www.okx.com/api/v5/mktplace/nft/markets/cancel-listing" \
-H "Content-Type: application/json" \
-H 'OK-ACCESS-KEY: XXX' \
-H 'OK-ACCESS-TIMESTAMP: XXX' \
-H 'OK-ACCESS-PASSPHRASE: XXX' \
-H 'OK-ACCESS-SIGN: XXX' \
-d '{
      "chain": "polygon",
      "walletAddress": "0xb0295f8ed896413eecc1032b9f97ecc8608c55ad",
      "orderIds": ["3401683780"]
  }'

Response example#

200
{
  "code": 0,
  "data": {
  "errors": [],
  "steps": [
    {
      "action": "CancelOrders",
      "items": [
        {
          "chain": 137,
          "contractAddress": "0x00000000000000adc04c56bf30ac9d3c0aaf14dc",
          "description": "",
          "input": "0xfd9f1e100000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000003f272ad1ce36553bd42b924a85610b7a8cb934530000000000000000000000002de95b9afd737b0814e5e6013593a9437c5532d500000000000000000000000000000000000000000000000000000000000001600000000000000000000000000000000000000000000000000000000000000220000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000658bc374000000000000000000000000000000000000000000000000000000006594fdf3000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000030c67a1f49e41a370000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000200000000000000000000000056423a158caceee70e85222d25675d14d67f474b00000000000000000000000000000000000000000000000000000000000005470000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000b1a2bc2ec5000000000000000000000000000000000000000000000000000000b1a2bc2ec5000000000000000000000000000003f272ad1ce36553bd42b924a85610b7a8cb93453",
          "kind": "transaction",
          "orderIds": [
          "3401683780"
          ],
          "platform": {
            "icon": "https://static.coinall.ltd/cdn/nft/2ffcd699-3e14-4ac3-b6fc-e8e5369ab2fd.png",
            "name": "OKX",
            "source": 4
          },
          "platforms": [
            {
              "icon": "https://static.coinall.ltd/cdn/nft/2ffcd699-3e14-4ac3-b6fc-e8e5369ab2fd.png",
              "name": "OKX",
              "source": 4
            }
          ],
          "status": "incomplete",
          "totalPrice": "0",
          "totalUsdPrice": "0",
          "value": "0"
        }
      ]
    }
  ]
},
  "msg": ""
}