Set Isolated Exit Trigger

curl --request PUT \
  --url https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger \
  --header 'Content-Type: application/json' \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>' \
  --data '
{
  "kind": "bracket",
  "stop_loss_price": "0.5600",
  "take_profit_price": "0.5600",
  "trail_amount": "0.5600",
  "trail_bps": 5000
}
'

import requests

url = "https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger"

payload = {
    "kind": "bracket",
    "stop_loss_price": "0.5600",
    "take_profit_price": "0.5600",
    "trail_amount": "0.5600",
    "trail_bps": 5000
}
headers = {
    "KALSHI-ACCESS-KEY": "<api-key>",
    "KALSHI-ACCESS-SIGNATURE": "<api-key>",
    "KALSHI-ACCESS-TIMESTAMP": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'KALSHI-ACCESS-KEY': '<api-key>',
    'KALSHI-ACCESS-SIGNATURE': '<api-key>',
    'KALSHI-ACCESS-TIMESTAMP': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    kind: 'bracket',
    stop_loss_price: '0.5600',
    take_profit_price: '0.5600',
    trail_amount: '0.5600',
    trail_bps: 5000
  })
};

fetch('https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger', 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://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'kind' => 'bracket',
    'stop_loss_price' => '0.5600',
    'take_profit_price' => '0.5600',
    'trail_amount' => '0.5600',
    'trail_bps' => 5000
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "KALSHI-ACCESS-KEY: <api-key>",
    "KALSHI-ACCESS-SIGNATURE: <api-key>",
    "KALSHI-ACCESS-TIMESTAMP: <api-key>"
  ],
]);

$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://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger"

	payload := strings.NewReader("{\n  \"kind\": \"bracket\",\n  \"stop_loss_price\": \"0.5600\",\n  \"take_profit_price\": \"0.5600\",\n  \"trail_amount\": \"0.5600\",\n  \"trail_bps\": 5000\n}")

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

	req.Header.Add("KALSHI-ACCESS-KEY", "<api-key>")
	req.Header.Add("KALSHI-ACCESS-SIGNATURE", "<api-key>")
	req.Header.Add("KALSHI-ACCESS-TIMESTAMP", "<api-key>")
	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.put("https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger")
  .header("KALSHI-ACCESS-KEY", "<api-key>")
  .header("KALSHI-ACCESS-SIGNATURE", "<api-key>")
  .header("KALSHI-ACCESS-TIMESTAMP", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"kind\": \"bracket\",\n  \"stop_loss_price\": \"0.5600\",\n  \"take_profit_price\": \"0.5600\",\n  \"trail_amount\": \"0.5600\",\n  \"trail_bps\": 5000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger")

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

request = Net::HTTP::Put.new(url)
request["KALSHI-ACCESS-KEY"] = '<api-key>'
request["KALSHI-ACCESS-SIGNATURE"] = '<api-key>'
request["KALSHI-ACCESS-TIMESTAMP"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"kind\": \"bracket\",\n  \"stop_loss_price\": \"0.5600\",\n  \"take_profit_price\": \"0.5600\",\n  \"trail_amount\": \"0.5600\",\n  \"trail_bps\": 5000\n}"

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

{
  "id": "<string>",
  "ticker": "<string>",
  "count": "10.00",
  "filled_count": "10.00",
  "created_time": "2023-11-07T05:31:56Z",
  "updated_time": "2023-11-07T05:31:56Z",
  "triggered_order_id": "<string>",
  "anchor_order_id": "<string>",
  "client_trigger_id": "<string>",
  "stop_loss_price": "0.5600",
  "take_profit_price": "0.5600",
  "trail_amount": "0.5600",
  "trail_bps": 123,
  "watermark_price": "0.5600",
  "effective_stop_price": "0.5600"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

PUT

margin

isolated

positions

{ticker}

exit_trigger

Set Isolated Exit Trigger

curl --request PUT \
  --url https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger \
  --header 'Content-Type: application/json' \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>' \
  --data '
{
  "kind": "bracket",
  "stop_loss_price": "0.5600",
  "take_profit_price": "0.5600",
  "trail_amount": "0.5600",
  "trail_bps": 5000
}
'

import requests

url = "https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger"

payload = {
    "kind": "bracket",
    "stop_loss_price": "0.5600",
    "take_profit_price": "0.5600",
    "trail_amount": "0.5600",
    "trail_bps": 5000
}
headers = {
    "KALSHI-ACCESS-KEY": "<api-key>",
    "KALSHI-ACCESS-SIGNATURE": "<api-key>",
    "KALSHI-ACCESS-TIMESTAMP": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'KALSHI-ACCESS-KEY': '<api-key>',
    'KALSHI-ACCESS-SIGNATURE': '<api-key>',
    'KALSHI-ACCESS-TIMESTAMP': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    kind: 'bracket',
    stop_loss_price: '0.5600',
    take_profit_price: '0.5600',
    trail_amount: '0.5600',
    trail_bps: 5000
  })
};

fetch('https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger', 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://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'kind' => 'bracket',
    'stop_loss_price' => '0.5600',
    'take_profit_price' => '0.5600',
    'trail_amount' => '0.5600',
    'trail_bps' => 5000
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "KALSHI-ACCESS-KEY: <api-key>",
    "KALSHI-ACCESS-SIGNATURE: <api-key>",
    "KALSHI-ACCESS-TIMESTAMP: <api-key>"
  ],
]);

$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://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger"

	payload := strings.NewReader("{\n  \"kind\": \"bracket\",\n  \"stop_loss_price\": \"0.5600\",\n  \"take_profit_price\": \"0.5600\",\n  \"trail_amount\": \"0.5600\",\n  \"trail_bps\": 5000\n}")

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

	req.Header.Add("KALSHI-ACCESS-KEY", "<api-key>")
	req.Header.Add("KALSHI-ACCESS-SIGNATURE", "<api-key>")
	req.Header.Add("KALSHI-ACCESS-TIMESTAMP", "<api-key>")
	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.put("https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger")
  .header("KALSHI-ACCESS-KEY", "<api-key>")
  .header("KALSHI-ACCESS-SIGNATURE", "<api-key>")
  .header("KALSHI-ACCESS-TIMESTAMP", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"kind\": \"bracket\",\n  \"stop_loss_price\": \"0.5600\",\n  \"take_profit_price\": \"0.5600\",\n  \"trail_amount\": \"0.5600\",\n  \"trail_bps\": 5000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://external-api.kalshi.com/trade-api/v2/margin/isolated/positions/{ticker}/exit_trigger")

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

request = Net::HTTP::Put.new(url)
request["KALSHI-ACCESS-KEY"] = '<api-key>'
request["KALSHI-ACCESS-SIGNATURE"] = '<api-key>'
request["KALSHI-ACCESS-TIMESTAMP"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"kind\": \"bracket\",\n  \"stop_loss_price\": \"0.5600\",\n  \"take_profit_price\": \"0.5600\",\n  \"trail_amount\": \"0.5600\",\n  \"trail_bps\": 5000\n}"

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

{
  "id": "<string>",
  "ticker": "<string>",
  "count": "10.00",
  "filled_count": "10.00",
  "created_time": "2023-11-07T05:31:56Z",
  "updated_time": "2023-11-07T05:31:56Z",
  "triggered_order_id": "<string>",
  "anchor_order_id": "<string>",
  "client_trigger_id": "<string>",
  "stop_loss_price": "0.5600",
  "take_profit_price": "0.5600",
  "trail_amount": "0.5600",
  "trail_bps": 123,
  "watermark_price": "0.5600",
  "effective_stop_price": "0.5600"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "details": "<string>"
}

Authorizations

KALSHI-ACCESS-KEY

string

header

required

Your API key ID

KALSHI-ACCESS-SIGNATURE

string

header

required

RSA-PSS signature of the request

KALSHI-ACCESS-TIMESTAMP

string

header

required

Request timestamp in milliseconds

Path Parameters

ticker

string

required

Ticker of the market whose position the trigger protects.

Body

application/json

For bracket, supply stop_loss_price and/or take_profit_price. For trailing, supply exactly one of trail_amount or trail_bps. Fields belonging to the other kind are rejected, as is a body that sets neither — cancel with DELETE. A leg you omit is cleared.

kind

enum<string>

default:bracket

Which trigger family this write targets. Defaults to bracket.

Available options:

bracket,

trailing

stop_loss_price

string

Mark price at which the stop-loss leg fires. Bracket only.

Example:

"0.5600"

take_profit_price

string

Mark price at which the take-profit leg fires. Bracket only.

Example:

"0.5600"

trail_amount

string

Absolute trailing distance in dollars. Trailing only; mutually exclusive with trail_bps.

Example:

"0.5600"

trail_bps

integer

Trailing distance in basis points of the tracked watermark (not the entry price). Trailing only; mutually exclusive with trail_amount.

Required range: 1 <= x <= 9999

Response

Exit trigger set successfully

string

required

Unique identifier for this trigger.

ticker

string

required

Market the protected position is on.

kind

enum<string>

required

Trigger family. bracket is a stop-loss / take-profit pair; trailing is a trailing stop whose stop level ratchets with the liquidation mark.

Available options:

bracket,

trailing

status

enum<string>

required

pending_on_entry awaits an initial or further fill from the anchor order before arming — an order-anchored trigger returns here after closing its current quantity, so this status can follow active and carries a non-zero filled_count when it does. active is live and evaluated against the mark each tick. filled, failed, and canceled are terminal.

Available options:

pending_on_entry,

active,

filled,

failed,

canceled,

unknown

count

string

required

Contracts this trigger closes when it fires. 0 means the whole position.

Example:

"10.00"

filled_count

string

required

Contracts closed so far across fire attempts.

Example:

"10.00"

created_time

string<date-time>

required

updated_time

string<date-time>

required

status_reason

enum<string>

Why the trigger reached its terminal status.

Available options:

user_canceled,

position_closed,

entry_not_filled,

order_rejected,

position_flipped

triggered_leg

enum<string>

Leg that fired the last time the trigger fired.

Available options:

stop_loss,

take_profit

triggered_order_id

string

Order placed the last time the trigger fired. An order-anchored trigger keeps it after returning to pending_on_entry, so its presence does not mean the trigger is done.

anchor_order_id

string

Order this trigger follows, for order-anchored triggers. Cleared once that order reaches a terminal state, so use client_trigger_id to correlate a trigger with the request that made it.

client_trigger_id

string

The idempotency key the create supplied, for appending creates.

stop_loss_price

string

Stop-loss leg price. Bracket triggers only.

Example:

"0.5600"

take_profit_price

string

Take-profit leg price. Bracket triggers only.

Example:

"0.5600"

trail_amount

string

Absolute trailing distance. Trailing triggers only.

Example:

"0.5600"

trail_bps

integer

Trailing distance in basis points of the watermark. Trailing triggers only.

watermark_price

string

Most favorable liquidation mark seen since creation — the peak for long positions, the trough for short. Trailing triggers only.

Example:

"0.5600"

effective_stop_price

string

Level whose breach fires the stop: watermark minus the trail for longs, plus for shorts. Trailing triggers only.

Example:

"0.5600"

Overview

REST

WebSockets

FIX

Set Isolated Exit Trigger

Authorizations

Path Parameters

Body

Response