---
title: "Get Order Queue Position"
method: GET
path: "/portfolio/orders/{order_id}/queue_position"
tags: ["orders"]
---

# Get Order Queue Position

`GET /portfolio/orders/{order_id}/queue_position`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/portfolio/orders/{order_id}/queue_position`
- Auth: API key in header `KALSHI-ACCESS-KEY` and API key in header `KALSHI-ACCESS-SIGNATURE` and API key in header `KALSHI-ACCESS-TIMESTAMP`

Endpoint for getting an order's queue position in the order book. This represents the amount of orders that need to be matched before this order receives a partial or full match. Queue position is determined using a price-time priority.

## Path parameters

- `order_id` string, required

## Response `200`

Queue position retrieved successfully

- GetOrderQueuePositionResponse
  - `queue_position_fp` string, required: 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.

## Other responses

- `401`: Unauthorized - authentication required
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-07-31** `a07481be8bf9`: 3 warning
  - removed the optional property `service` from the response with the `401` status
  - removed the optional property `service` from the response with the `404` status
  - removed the optional property `service` from the response with the `500` status
- **2026-04-13** `218c1f661cbd`: 1 breaking, 1 info
  - removed the required property `queue_position` from the response with the `200` status
  - the response property `queue_position_fp` became required for the status `200`
- **2026-02-14** `d4973326079e`: 1 info
  - added the optional property `queue_position_fp` to the response with the `200` status
- **2025-12-02** `02c9ca7d135f`: 2 info
  - api tag `orders` added
  - api tag `portfolio` removed
- **2025-11-06** `6ad7527f54aa`: 5 info
  - the endpoint scheme security `kalshiAccessKey AND kalshiAccessSignature AND kalshiAccessTimestamp` was added to the API
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added the non-success response with the status `500`
  - …1 more

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/portfolio/orders/:order_id/queue_position/get.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)
