Insert order

Insert order

curl --request POST \
  --url https://api.prod.polymarketexchange.com/v1/trading/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "orderQty": "<string>",
  "symbol": "<string>",
  "price": "<string>",
  "clordId": "<string>",
  "account": "<string>",
  "stopPrice": "<string>",
  "minQty": "<string>",
  "selfMatchPreventionId": "<string>",
  "quote": "<string>",
  "allOrNone": true,
  "sessionId": "<string>",
  "user": "<string>",
  "clientAccountId": "<string>",
  "clientParticipantId": "<string>",
  "participateDontInitiate": true,
  "cashOrderQty": "<string>",
  "strictLimit": true,
  "goodTillTime": "2023-11-07T05:31:56Z",
  "bestLimit": true,
  "immediatelyExecutableLimit": true,
  "ignorePriceValidityChecks": true
}
'

import requests

url = "https://api.prod.polymarketexchange.com/v1/trading/orders"

payload = {
    "orderQty": "<string>",
    "symbol": "<string>",
    "price": "<string>",
    "clordId": "<string>",
    "account": "<string>",
    "stopPrice": "<string>",
    "minQty": "<string>",
    "selfMatchPreventionId": "<string>",
    "quote": "<string>",
    "allOrNone": True,
    "sessionId": "<string>",
    "user": "<string>",
    "clientAccountId": "<string>",
    "clientParticipantId": "<string>",
    "participateDontInitiate": True,
    "cashOrderQty": "<string>",
    "strictLimit": True,
    "goodTillTime": "2023-11-07T05:31:56Z",
    "bestLimit": True,
    "immediatelyExecutableLimit": True,
    "ignorePriceValidityChecks": True
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    orderQty: '<string>',
    symbol: '<string>',
    price: '<string>',
    clordId: '<string>',
    account: '<string>',
    stopPrice: '<string>',
    minQty: '<string>',
    selfMatchPreventionId: '<string>',
    quote: '<string>',
    allOrNone: true,
    sessionId: '<string>',
    user: '<string>',
    clientAccountId: '<string>',
    clientParticipantId: '<string>',
    participateDontInitiate: true,
    cashOrderQty: '<string>',
    strictLimit: true,
    goodTillTime: '2023-11-07T05:31:56Z',
    bestLimit: true,
    immediatelyExecutableLimit: true,
    ignorePriceValidityChecks: true
  })
};

fetch('https://api.prod.polymarketexchange.com/v1/trading/orders', 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.prod.polymarketexchange.com/v1/trading/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'orderQty' => '<string>',
    'symbol' => '<string>',
    'price' => '<string>',
    'clordId' => '<string>',
    'account' => '<string>',
    'stopPrice' => '<string>',
    'minQty' => '<string>',
    'selfMatchPreventionId' => '<string>',
    'quote' => '<string>',
    'allOrNone' => true,
    'sessionId' => '<string>',
    'user' => '<string>',
    'clientAccountId' => '<string>',
    'clientParticipantId' => '<string>',
    'participateDontInitiate' => true,
    'cashOrderQty' => '<string>',
    'strictLimit' => true,
    'goodTillTime' => '2023-11-07T05:31:56Z',
    'bestLimit' => true,
    'immediatelyExecutableLimit' => true,
    'ignorePriceValidityChecks' => true
  ]),
  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.prod.polymarketexchange.com/v1/trading/orders"

	payload := strings.NewReader("{\n  \"orderQty\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"price\": \"<string>\",\n  \"clordId\": \"<string>\",\n  \"account\": \"<string>\",\n  \"stopPrice\": \"<string>\",\n  \"minQty\": \"<string>\",\n  \"selfMatchPreventionId\": \"<string>\",\n  \"quote\": \"<string>\",\n  \"allOrNone\": true,\n  \"sessionId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"clientAccountId\": \"<string>\",\n  \"clientParticipantId\": \"<string>\",\n  \"participateDontInitiate\": true,\n  \"cashOrderQty\": \"<string>\",\n  \"strictLimit\": true,\n  \"goodTillTime\": \"2023-11-07T05:31:56Z\",\n  \"bestLimit\": true,\n  \"immediatelyExecutableLimit\": true,\n  \"ignorePriceValidityChecks\": true\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.prod.polymarketexchange.com/v1/trading/orders")
  .header("Content-Type", "application/json")
  .body("{\n  \"orderQty\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"price\": \"<string>\",\n  \"clordId\": \"<string>\",\n  \"account\": \"<string>\",\n  \"stopPrice\": \"<string>\",\n  \"minQty\": \"<string>\",\n  \"selfMatchPreventionId\": \"<string>\",\n  \"quote\": \"<string>\",\n  \"allOrNone\": true,\n  \"sessionId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"clientAccountId\": \"<string>\",\n  \"clientParticipantId\": \"<string>\",\n  \"participateDontInitiate\": true,\n  \"cashOrderQty\": \"<string>\",\n  \"strictLimit\": true,\n  \"goodTillTime\": \"2023-11-07T05:31:56Z\",\n  \"bestLimit\": true,\n  \"immediatelyExecutableLimit\": true,\n  \"ignorePriceValidityChecks\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.prod.polymarketexchange.com/v1/trading/orders")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"orderQty\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"price\": \"<string>\",\n  \"clordId\": \"<string>\",\n  \"account\": \"<string>\",\n  \"stopPrice\": \"<string>\",\n  \"minQty\": \"<string>\",\n  \"selfMatchPreventionId\": \"<string>\",\n  \"quote\": \"<string>\",\n  \"allOrNone\": true,\n  \"sessionId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"clientAccountId\": \"<string>\",\n  \"clientParticipantId\": \"<string>\",\n  \"participateDontInitiate\": true,\n  \"cashOrderQty\": \"<string>\",\n  \"strictLimit\": true,\n  \"goodTillTime\": \"2023-11-07T05:31:56Z\",\n  \"bestLimit\": true,\n  \"immediatelyExecutableLimit\": true,\n  \"ignorePriceValidityChecks\": true\n}"

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

{
  "orderId": "<string>"
}

POST

trading

orders

Insert order

curl --request POST \
  --url https://api.prod.polymarketexchange.com/v1/trading/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "orderQty": "<string>",
  "symbol": "<string>",
  "price": "<string>",
  "clordId": "<string>",
  "account": "<string>",
  "stopPrice": "<string>",
  "minQty": "<string>",
  "selfMatchPreventionId": "<string>",
  "quote": "<string>",
  "allOrNone": true,
  "sessionId": "<string>",
  "user": "<string>",
  "clientAccountId": "<string>",
  "clientParticipantId": "<string>",
  "participateDontInitiate": true,
  "cashOrderQty": "<string>",
  "strictLimit": true,
  "goodTillTime": "2023-11-07T05:31:56Z",
  "bestLimit": true,
  "immediatelyExecutableLimit": true,
  "ignorePriceValidityChecks": true
}
'

import requests

url = "https://api.prod.polymarketexchange.com/v1/trading/orders"

payload = {
    "orderQty": "<string>",
    "symbol": "<string>",
    "price": "<string>",
    "clordId": "<string>",
    "account": "<string>",
    "stopPrice": "<string>",
    "minQty": "<string>",
    "selfMatchPreventionId": "<string>",
    "quote": "<string>",
    "allOrNone": True,
    "sessionId": "<string>",
    "user": "<string>",
    "clientAccountId": "<string>",
    "clientParticipantId": "<string>",
    "participateDontInitiate": True,
    "cashOrderQty": "<string>",
    "strictLimit": True,
    "goodTillTime": "2023-11-07T05:31:56Z",
    "bestLimit": True,
    "immediatelyExecutableLimit": True,
    "ignorePriceValidityChecks": True
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    orderQty: '<string>',
    symbol: '<string>',
    price: '<string>',
    clordId: '<string>',
    account: '<string>',
    stopPrice: '<string>',
    minQty: '<string>',
    selfMatchPreventionId: '<string>',
    quote: '<string>',
    allOrNone: true,
    sessionId: '<string>',
    user: '<string>',
    clientAccountId: '<string>',
    clientParticipantId: '<string>',
    participateDontInitiate: true,
    cashOrderQty: '<string>',
    strictLimit: true,
    goodTillTime: '2023-11-07T05:31:56Z',
    bestLimit: true,
    immediatelyExecutableLimit: true,
    ignorePriceValidityChecks: true
  })
};

fetch('https://api.prod.polymarketexchange.com/v1/trading/orders', 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.prod.polymarketexchange.com/v1/trading/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'orderQty' => '<string>',
    'symbol' => '<string>',
    'price' => '<string>',
    'clordId' => '<string>',
    'account' => '<string>',
    'stopPrice' => '<string>',
    'minQty' => '<string>',
    'selfMatchPreventionId' => '<string>',
    'quote' => '<string>',
    'allOrNone' => true,
    'sessionId' => '<string>',
    'user' => '<string>',
    'clientAccountId' => '<string>',
    'clientParticipantId' => '<string>',
    'participateDontInitiate' => true,
    'cashOrderQty' => '<string>',
    'strictLimit' => true,
    'goodTillTime' => '2023-11-07T05:31:56Z',
    'bestLimit' => true,
    'immediatelyExecutableLimit' => true,
    'ignorePriceValidityChecks' => true
  ]),
  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.prod.polymarketexchange.com/v1/trading/orders"

	payload := strings.NewReader("{\n  \"orderQty\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"price\": \"<string>\",\n  \"clordId\": \"<string>\",\n  \"account\": \"<string>\",\n  \"stopPrice\": \"<string>\",\n  \"minQty\": \"<string>\",\n  \"selfMatchPreventionId\": \"<string>\",\n  \"quote\": \"<string>\",\n  \"allOrNone\": true,\n  \"sessionId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"clientAccountId\": \"<string>\",\n  \"clientParticipantId\": \"<string>\",\n  \"participateDontInitiate\": true,\n  \"cashOrderQty\": \"<string>\",\n  \"strictLimit\": true,\n  \"goodTillTime\": \"2023-11-07T05:31:56Z\",\n  \"bestLimit\": true,\n  \"immediatelyExecutableLimit\": true,\n  \"ignorePriceValidityChecks\": true\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.prod.polymarketexchange.com/v1/trading/orders")
  .header("Content-Type", "application/json")
  .body("{\n  \"orderQty\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"price\": \"<string>\",\n  \"clordId\": \"<string>\",\n  \"account\": \"<string>\",\n  \"stopPrice\": \"<string>\",\n  \"minQty\": \"<string>\",\n  \"selfMatchPreventionId\": \"<string>\",\n  \"quote\": \"<string>\",\n  \"allOrNone\": true,\n  \"sessionId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"clientAccountId\": \"<string>\",\n  \"clientParticipantId\": \"<string>\",\n  \"participateDontInitiate\": true,\n  \"cashOrderQty\": \"<string>\",\n  \"strictLimit\": true,\n  \"goodTillTime\": \"2023-11-07T05:31:56Z\",\n  \"bestLimit\": true,\n  \"immediatelyExecutableLimit\": true,\n  \"ignorePriceValidityChecks\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.prod.polymarketexchange.com/v1/trading/orders")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"orderQty\": \"<string>\",\n  \"symbol\": \"<string>\",\n  \"price\": \"<string>\",\n  \"clordId\": \"<string>\",\n  \"account\": \"<string>\",\n  \"stopPrice\": \"<string>\",\n  \"minQty\": \"<string>\",\n  \"selfMatchPreventionId\": \"<string>\",\n  \"quote\": \"<string>\",\n  \"allOrNone\": true,\n  \"sessionId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"clientAccountId\": \"<string>\",\n  \"clientParticipantId\": \"<string>\",\n  \"participateDontInitiate\": true,\n  \"cashOrderQty\": \"<string>\",\n  \"strictLimit\": true,\n  \"goodTillTime\": \"2023-11-07T05:31:56Z\",\n  \"bestLimit\": true,\n  \"immediatelyExecutableLimit\": true,\n  \"ignorePriceValidityChecks\": true\n}"

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

{
  "orderId": "<string>"
}

Body

application/json

type

enum<string>

OrderType indicates the type of an order.

Available options:

ORDER_TYPE_MARKET_TO_LIMIT,

ORDER_TYPE_LIMIT,

ORDER_TYPE_STOP,

ORDER_TYPE_STOP_LIMIT

side

enum<string>

Side indicates the side of an Order.

Available options:

SIDE_BUY,

SIDE_SELL

orderQty

string<int64>

symbol

string

price

string<int64>

timeInForce

enum<string>

TimeInForce specifies how long the order remains in effect.

Available options:

TIME_IN_FORCE_DAY,

TIME_IN_FORCE_GOOD_TILL_CANCEL,

TIME_IN_FORCE_IMMEDIATE_OR_CANCEL,

TIME_IN_FORCE_GOOD_TILL_TIME,

TIME_IN_FORCE_FILL_OR_KILL

clordId

string

account

string

stopPrice

string<int64>

minQty

string<int64>

selfMatchPreventionId

string

quote

string

allOrNone

boolean

sessionId

string

user

string

clientAccountId

string

clientParticipantId

string

participateDontInitiate

boolean

cashOrderQty

string<int64>

strictLimit

boolean

Set if this particular order must be filled at the exact limit price.

goodTillTime

string<date-time>

bestLimit

boolean

A flag for best limit pricing. Sets the limit order's price to the top of the book on the same side as the order.

immediatelyExecutableLimit

boolean

A flag for immediately executable limit pricing. Sets the price to the top of the book on the opposing side, so it can immediately match.

selfMatchPreventionInstruction

enum<string>

SelfMatchPreventionInstruction is the methodology used to handle self match prevention.

Available options:

SELF_MATCH_PREVENTION_INSTRUCTION_REJECT_AGGRESSOR,

SELF_MATCH_PREVENTION_INSTRUCTION_CANCEL_RESTING,

SELF_MATCH_PREVENTION_INSTRUCTION_REMOVE_BOTH

orderCapacity

enum<string>

OrderCapacity designates the capacity of the party placing an order.

Available options:

ORDER_CAPACITY_AGENCY,

ORDER_CAPACITY_PRINCIPAL,

ORDER_CAPACITY_PROPRIETARY,

ORDER_CAPACITY_INDIVIDUAL,

ORDER_CAPACITY_RISKLESS_PRINCIPAL,

ORDER_CAPACITY_AGENT_FOR_OTHER_MEMBER

ignorePriceValidityChecks

boolean

manualOrderIndicator

enum<string>

ManualOrderIndicator designates the manual or automated nature of an order.

Available options:

MANUAL_ORDER_INDICATOR_MANUAL,

MANUAL_ORDER_INDICATOR_AUTOMATED

Response

200 - application/json

A successful response.

orderId

string

Trading API Overview

Cancel order

⌘I

Overview

Health

Trading

Combos

RFQs

Report

Positions

Funding

Order Book

Reference Data

Accounts

Payments

Incentives

Body

Response