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

# Get Block Trade Proposals

`GET /communications/block-trade-proposals`

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

---

[API](https://skmtc.net/kalshi/apis/kalshi-trade-api-manual-endpoints.md) · [All operations](https://skmtc.net/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kalshi/kalshi-trade-api-manual-endpoints/revisions/6aec27d55fba/schema)