> ## Documentation Index > Fetch the complete documentation index at: https://docs.kalshi.com/llms.txt > Use this file to discover all available pages before exploring further. # Set Cross Exit Trigger > Endpoint for setting a stop-loss / take-profit bracket or a trailing stop on a non-isolated margin position. A position holds one trailing stop and up to 20 brackets, so long as their counts fit the position. Requires an open position unless `anchor_order_id` is supplied, and fires reduce-only orders. ## OpenAPI ````yaml /perps_openapi.yaml put /margin/cross/positions/{ticker}/exit_trigger openapi: 3.0.0 info: title: Kalshi Trade API Manual Endpoints version: 0.0.1 description: >- Manually defined OpenAPI spec for endpoints being migrated to spec-first approach servers: - url: https://external-api.kalshi.com/trade-api/v2 description: Production perps REST API server - url: https://external-api.demo.kalshi.co/trade-api/v2 description: Demo perps REST API server security: [] tags: - name: account description: Account information endpoints - name: fcm description: FCM member specific endpoints - name: exchange description: Exchange status and information endpoints - name: market description: Market data endpoints - name: orders description: Order management endpoints - name: order-groups description: Order group management endpoints - name: portfolio description: Portfolio and balance information endpoints - name: risk description: Margin risk metrics, parameters, and limits - name: funding description: Funding rates and payment history - name: fees description: Margin fee schedule - name: exit-triggers description: Stop-loss, take-profit, and trailing-stop triggers on margin positions paths: /margin/cross/positions/{ticker}/exit_trigger: put: tags: - exit-triggers summary: Set Cross Exit Trigger description: >- Endpoint for setting a stop-loss / take-profit bracket or a trailing stop on a non-isolated margin position. A position holds one trailing stop and up to 20 brackets, so long as their counts fit the position. Requires an open position unless `anchor_order_id` is supplied, and fires reduce-only orders. operationId: SetCrossMarginExitTrigger parameters: - $ref: '#/components/parameters/ExitTriggerTickerPath' - $ref: '#/components/parameters/SubaccountQueryDefaultPrimary' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SetCrossExitTriggerRequest' responses: '200': description: Exit trigger set successfully content: application/json: schema: $ref: '#/components/schemas/ExitTrigger' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '403': $ref: '#/components/responses/ForbiddenError' '404': $ref: '#/components/responses/NotFoundError' '409': $ref: '#/components/responses/ConflictError' '429': $ref: '#/components/responses/RateLimitError' '500': $ref: '#/components/responses/InternalServerError' security: - kalshiAccessKey: [] kalshiAccessSignature: [] kalshiAccessTimestamp: [] components: parameters: ExitTriggerTickerPath: name: ticker in: path required: true description: Ticker of the market whose position the trigger protects. schema: type: string SubaccountQueryDefaultPrimary: name: subaccount in: query required: false description: Subaccount number (0 for primary, 1-63 for subaccounts). Defaults to 0. schema: type: integer minimum: 0 default: 0 schemas: SetCrossExitTriggerRequest: type: object description: >- 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. properties: count: $ref: '#/components/schemas/FixedPointCount' description: >- Contracts this trigger closes when it fires. Omit it to cover the whole position, which then requires that no partial or anchored trigger already covers part of it. If supplied, it must be a whole number of contracts. anchor_order_id: type: string description: >- Ties the trigger to an order: its size follows that order's cumulative fill, and it stays pending until the order first fills. Bracket only; mutually exclusive with `count`. If the order cannot currently be validated, the request returns `409` with error code `anchor_order_unavailable` before writing anything, so retrying is safe. client_trigger_id: type: string maxLength: 64 x-oapi-codegen-extra-tags: validate: omitempty,max=64 description: >- Your own identifier, required on a `count` or `anchor_order_id` create because those append a trigger rather than replace one; rejected on every other write. Replaying a key returns the trigger the first request made, in whatever state it has since reached. Keys are single-use per account and belong to the position they created on: reusing one returns the original even once it is `canceled`, and presenting it for another subaccount or ticker returns `409` with error code `idempotency_key_already_used`. kind: allOf: - $ref: '#/components/schemas/ExitTriggerKind' default: bracket description: Which trigger family this write targets. Defaults to `bracket`. stop_loss_price: $ref: '#/components/schemas/FixedPointDollars' description: Mark price at which the stop-loss leg fires. Bracket only. take_profit_price: $ref: '#/components/schemas/FixedPointDollars' description: Mark price at which the take-profit leg fires. Bracket only. trail_amount: $ref: '#/components/schemas/FixedPointDollars' description: >- Absolute trailing distance in dollars. Trailing only; mutually exclusive with `trail_bps`. trail_bps: type: integer minimum: 1 maximum: 9999 description: >- Trailing distance in basis points of the tracked watermark (not the entry price). Trailing only; mutually exclusive with `trail_amount`. ExitTrigger: type: object required: - id - ticker - kind - status - count - filled_count - created_time - updated_time properties: id: type: string description: Unique identifier for this trigger. ticker: type: string description: Market the protected position is on. kind: $ref: '#/components/schemas/ExitTriggerKind' status: $ref: '#/components/schemas/ExitTriggerStatus' status_reason: $ref: '#/components/schemas/ExitTriggerReason' triggered_leg: $ref: '#/components/schemas/ExitTriggerLeg' description: Leg that fired the last time the trigger fired. triggered_order_id: type: string description: >- 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: type: string description: >- 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: type: string description: The idempotency key the create supplied, for appending creates. stop_loss_price: $ref: '#/components/schemas/FixedPointDollars' description: Stop-loss leg price. Bracket triggers only. take_profit_price: $ref: '#/components/schemas/FixedPointDollars' description: Take-profit leg price. Bracket triggers only. trail_amount: $ref: '#/components/schemas/FixedPointDollars' description: Absolute trailing distance. Trailing triggers only. trail_bps: type: integer description: >- Trailing distance in basis points of the watermark. Trailing triggers only. watermark_price: $ref: '#/components/schemas/FixedPointDollars' description: >- Most favorable liquidation mark seen since creation — the peak for long positions, the trough for short. Trailing triggers only. effective_stop_price: $ref: '#/components/schemas/FixedPointDollars' description: >- Level whose breach fires the stop: watermark minus the trail for longs, plus for shorts. Trailing triggers only. count: $ref: '#/components/schemas/FixedPointCount' description: >- Contracts this trigger closes when it fires. `0` means the whole position. filled_count: $ref: '#/components/schemas/FixedPointCount' description: Contracts closed so far across fire attempts. created_time: type: string format: date-time updated_time: type: string format: date-time FixedPointCount: type: string description: >- Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0-2 decimal places (e.g., "10", "10.0", "10.00"); responses always emit 2 decimals. Fractional contract values (e.g., "2.50") are supported; the minimum granularity is 0.01 contracts. example: '10.00' ExitTriggerKind: type: string description: >- Trigger family. `bracket` is a stop-loss / take-profit pair; `trailing` is a trailing stop whose stop level ratchets with the liquidation mark. enum: - bracket - trailing FixedPointDollars: type: string description: >- Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure. example: '0.5600' ExitTriggerStatus: type: string description: >- `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. enum: - pending_on_entry - active - filled - failed - canceled - unknown ExitTriggerReason: type: string description: Why the trigger reached its terminal status. enum: - user_canceled - position_closed - entry_not_filled - order_rejected - position_flipped ExitTriggerLeg: type: string description: Which leg of a bracket fired. Present only once a leg has fired. enum: - stop_loss - take_profit ErrorResponse: type: object properties: code: type: string description: Error code message: type: string description: Human-readable error message details: type: string description: Additional details about the error, if available responses: BadRequestError: description: Bad request - invalid input content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' UnauthorizedError: description: Unauthorized - authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ForbiddenError: description: Forbidden - insufficient permissions content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFoundError: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ConflictError: description: Conflict - resource already exists or cannot be modified content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' RateLimitError: description: >- Rate limit exceeded. The default cost is 10 tokens per request. Use GET /trade-api/v2/account/endpoint_costs to list non-default endpoint costs. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: kalshiAccessKey: type: apiKey in: header name: KALSHI-ACCESS-KEY description: Your API key ID kalshiAccessSignature: type: apiKey in: header name: KALSHI-ACCESS-SIGNATURE description: RSA-PSS signature of the request kalshiAccessTimestamp: type: apiKey in: header name: KALSHI-ACCESS-TIMESTAMP description: Request timestamp in milliseconds ````