Cancel Orders COID

Cancel orders by client order ID. Requires proxy signature, see proxy signing.

DELETE /v1/trade/orders-coid

Cancel Orders COID

cURL

curl --request DELETE \
  --url https://api.perpetuals.polymarket.com/v1/trade/orders-coid \
  --header 'Content-Type: application/json' \
  --data '
{
  "op": {
    "type": "cancelOrdersCOID",
    "args": [
      "550e8400e29b41d4a716446655440000"
    ]
  },
  "sig": "0x1234567890...",
  "salt": 1234567890,
  "ts": 1767225600000,
  "exp": 1767225600000
}
'

import requests

url = "https://api.perpetuals.polymarket.com/v1/trade/orders-coid"

payload = {
    "op": {
        "type": "cancelOrdersCOID",
        "args": ["550e8400e29b41d4a716446655440000"]
    },
    "sig": "0x1234567890...",
    "salt": 1234567890,
    "ts": 1767225600000,
    "exp": 1767225600000
}
headers = {"Content-Type": "application/json"}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    op: {type: 'cancelOrdersCOID', args: ['550e8400e29b41d4a716446655440000']},
    sig: '0x1234567890...',
    salt: 1234567890,
    ts: 1767225600000,
    exp: 1767225600000
  })
};

fetch('https://api.perpetuals.polymarket.com/v1/trade/orders-coid', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.perpetuals.polymarket.com/v1/trade/orders-coid",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'op' => [
        'type' => 'cancelOrdersCOID',
        'args' => [
                '550e8400e29b41d4a716446655440000'
        ]
    ],
    'sig' => '0x1234567890...',
    'salt' => 1234567890,
    'ts' => 1767225600000,
    'exp' => 1767225600000
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.perpetuals.polymarket.com/v1/trade/orders-coid"

	payload := strings.NewReader("{\n  \"op\": {\n    \"type\": \"cancelOrdersCOID\",\n    \"args\": [\n      \"550e8400e29b41d4a716446655440000\"\n    ]\n  },\n  \"sig\": \"0x1234567890...\",\n  \"salt\": 1234567890,\n  \"ts\": 1767225600000,\n  \"exp\": 1767225600000\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.perpetuals.polymarket.com/v1/trade/orders-coid")
  .header("Content-Type", "application/json")
  .body("{\n  \"op\": {\n    \"type\": \"cancelOrdersCOID\",\n    \"args\": [\n      \"550e8400e29b41d4a716446655440000\"\n    ]\n  },\n  \"sig\": \"0x1234567890...\",\n  \"salt\": 1234567890,\n  \"ts\": 1767225600000,\n  \"exp\": 1767225600000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.perpetuals.polymarket.com/v1/trade/orders-coid")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"op\": {\n    \"type\": \"cancelOrdersCOID\",\n    \"args\": [\n      \"550e8400e29b41d4a716446655440000\"\n    ]\n  },\n  \"sig\": \"0x1234567890...\",\n  \"salt\": 1234567890,\n  \"ts\": 1767225600000,\n  \"exp\": 1767225600000\n}"

response = http.request(request)
puts response.read_body

200

[
  {
    "status": "ok",
    "oid": 1234567890,
    "coid": "550e8400e29b41d4a716446655440000"
  }
]

{
  "status": "err",
  "error": "insufficient_margin"
}

{
  "status": "err",
  "error": "insufficient_margin"
}

{
  "status": "err",
  "error": "insufficient_margin"
}

Request Weight: 1 + floor(n / 20) Action Weight: 0

Body

application/json

Cancel by coid request.

op · object · required

Show child attributes

sig · string · required

Signature in hex format

Example:

"0x1234567890..."

salt · integer · required

Salt

Example:

1234567890

ts · integer · required

Request timestamp. Unix milliseconds for most operations; Unix seconds for withdrawals (must match the on-chain EIP-712 struct verified against block.timestamp).

Example:

1767225600000

exp · integer

Command expiry timestamp in Unix milliseconds. If provided, it must be in the future and within the gateway's default command timeout. It can shorten request validity but cannot extend it. This is not an order auto-cancel time.

Example:

1767225600000

Response

200

application/json

Cancel response.

Option 1

Option 2

status · enum<string> · required

Available options: ok

oid · integer · required

Order ID

Example:

1234567890

coid · string

Echoed only when the request carried a client_order_id.

Required string length: 32

Pattern: ^[0-9a-f]{32}$

Example:

"550e8400e29b41d4a716446655440000"