---
title: "Get Block Trade Proposals"
method: GET
path: "/communications/block-trade-proposals"
tags: ["communications"]
---

# Get Block Trade Proposals

`GET /communications/block-trade-proposals`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/communications/block-trade-proposals`
- 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 block trade proposals visible to the authenticated user.

## Query parameters

- `cursor` string
- `market_ticker` string
- `limit` integer
- `status` string

## Response `200`

Block trade proposals retrieved successfully

- GetBlockTradeProposalsResponse
  - `block_trade_proposals` BlockTradeProposal[], required: List of block trade proposals
    - `id` string, required: Unique identifier for the block trade proposal
    - `proposer_user_id` string, required: User ID of the proposal creator
    - `buyer_user_id` string, required: User ID of the buyer. Empty when the authenticated user is not the buyer.
    - `buyer_subtrader_id` string: Subtrader ID of the buyer. Empty when the authenticated user is not the buyer.
    - `seller_user_id` string, required: User ID of the seller. Empty when the authenticated user is not the seller.
    - `seller_subtrader_id` string: Subtrader ID of the seller. Empty when the authenticated user is not the seller.
    - `market_ticker` string, required: The ticker of the market for this block trade
    - `price_centi_cents` integer, required: Price in centi-cents
    - `centicount` integer, required: Number of contracts in centicounts
    - `maker_side` 'yes' | 'no', required: The maker side of the trade
    - `expiration_ts` string, date-time, required: Expiration time of the proposal
    - `status` string, required: Current status of the proposal
    - `created_ts` string, date-time, required: Timestamp when the proposal was created
    - `updated_ts` string, date-time, required: Timestamp when the proposal was last updated
    - `buyer_accepted` boolean, required: Whether the buyer has accepted the proposal
    - `seller_accepted` boolean, required: Whether the seller has accepted the proposal
    - `buyer_accepted_ts` string, date-time: Timestamp when the buyer accepted
    - `seller_accepted_ts` string, date-time: Timestamp when the seller accepted
    - `executed_ts` string, date-time: Timestamp when the proposal was executed
    - `buyer_order_id` string: Order ID for the buyer after the proposal is executed
    - `seller_order_id` string: Order ID for the seller after the proposal is executed
  - `cursor` string: Cursor for pagination to get the next page of results

## Other responses

- `400`: Bad request - invalid input
- `401`: Unauthorized - authentication required
- `500`: Internal server error

## Changes

- **2026-07-31** `a07481be8bf9`: 3 warning
  - removed the optional property `service` from the response with the `400` status
  - removed the optional property `service` from the response with the `401` status
  - removed the optional property `service` from the response with the `500` status
- **2026-06-17** `5dacc8874900`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/communications/block-trade-proposals/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)