> ## Documentation Index > Fetch the complete documentation index at: https://docs.cdp.coinbase.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Block Trades > Retrieves all block trades where user owns the reporting firm/entity. ## OpenAPI ````yaml /api-reference/derivatives-api/rest-api/cde-spec.json get /rest/block-trade openapi: 3.0.3 info: title: Derivatives Public REST API version: 0.1.0 description: Public REST API for Coinbase Derivatives Exchange Public REST Gateway servers: - url: https://api.exchange.fairx.net variables: {} security: - auth_api_key: [] - auth_timestamp: [] - auth_passphrase: [] - auth_signature: [] paths: /rest/block-trade: get: tags: - Block Trades summary: Get Block Trades description: Retrieves all block trades where user owns the reporting firm/entity. operationId: getBlockTrades parameters: [] responses: '200': description: Successfully retrieved block trades content: application/json: schema: type: array items: $ref: '#/components/schemas/BlockTradeResponse' '403': description: Forbidden - insufficient permissions deprecated: false security: [] components: schemas: BlockTradeResponse: type: object additionalProperties: false properties: trade_id: type: integer format: int64 example: 12345 buyer_trader: type: string example: buyerTrader1 seller_trader: type: string example: sellerTrader1 reporting_trader: type: string example: reportingTrader1 buyer_itm_code: type: string example: itmCode1 buyer_ncp_code: type: string example: ncpCode1 buyer_fcm_code: type: string example: fcmCode1 buyer_firm_code: type: string example: firmCode1 seller_itm_code: type: string example: itmCode2 seller_ncp_code: type: string example: ncpCode2 seller_fcm_code: type: string example: fcmCode2 seller_firm_code: type: string example: firmCode2 reporting_firm_code: type: string example: firmCode1 buyer_entity: type: string example: buyerEntity1 seller_entity: type: string example: sellerEntity1 buyer_entity_uuid: type: string example: 123e4567-e89b-12d3-a456-426614174000 seller_entity_uuid: type: string example: abcdef12-3456-7890-abcd-ef1234567890 buyer_account: type: string example: buyerAccount1 seller_account: type: string example: sellerAccount1 reporting_entity: type: string example: reportingEntity1 reporting_entity_uuid: type: string example: f81d4fae-7dec-11d0-a765-00a0c91e6bf6 broker_code: type: string example: brokerCode1 executing_trader: type: string example: execTrader1 symbol: type: string example: BIPZ30 buyer_client_order_id: type: string example: clientOrderBuy1 seller_client_order_id: type: string example: clientOrderSell1 transact_timestamp: type: string example: '2025-01-13T14:30:00Z' sending_timestamp: type: string example: '2025-01-13T14:29:59Z' trading_session_date: type: string format: date example: '2025-01-13' handling_inst: allOf: - $ref: '#/components/schemas/CustOrderHandlingInst' example: ELECTRONIC quantity: type: integer format: int32 example: 100 price: type: string example: 45000.5 event_type: allOf: - $ref: '#/components/schemas/SimpleOrderEventType' example: FILLED buyer_fill_id: type: integer format: int64 example: 98765 seller_fill_id: type: integer format: int64 example: 98766 buyer_cust_order_capacity: allOf: - $ref: '#/components/schemas/CustOrderCapacity' example: CTI4 seller_cust_order_capacity: allOf: - $ref: '#/components/schemas/CustOrderCapacity' example: CTI4 buyer_participant_type: type: string example: customer seller_participant_type: type: string example: customer reported_by_broker: type: boolean example: false placed_by_admin: type: boolean example: false reject_reason: $ref: '#/components/schemas/BlockTradeRejectReason' reject_details: type: string status: allOf: - $ref: '#/components/schemas/FillStatus' example: ACTIVE last_updated_trading_session_date: type: string format: date example: '2025-01-13' last_updated_timestamp: type: string example: '2025-01-13T14:30:05Z' clearing_timestamp: type: string example: '2025-01-13T14:31:00Z' is_tas_order: type: boolean description: Indicates whether this is a Trade at Settlement (TAS) order example: true tick_differential: type: integer format: int64 nullable: true description: >- The price differential in ticks for TAS orders. Only present when is_tas_order is true. example: 5 price_differential: type: string nullable: true description: >- The price differential as a decimal value for TAS orders. This represents the actual price impact of the tick differential. Only present when is_tas_order is true. example: '2.50' effective_price: type: string description: >- The effective price of the block trade. For TAS orders, this is calculated from the settlement price plus the price differential. example: '45003.00' CustOrderHandlingInst: type: string enum: - DESK - ELECTRONIC - VENDOR_PROVIDED - SPONSORED_ACCESS - PREMIUM_ALGO_TRADING - OTHER - PHONE - DESK_PIT SimpleOrderEventType: type: string enum: - SUBMITTED - REJECTED - CANCELED - REPLACED - FILLED - STOP_TRIGGERED - FILL_CANCELED - FILL_AMENDED - UNKNOWN CustOrderCapacity: type: string enum: - CTI1 - CTI2 - CTI3 - CTI4 BlockTradeRejectReason: type: string enum: - ERROR - UNKNOWN_INSTRUMENT - UNKNOWN_ACCOUNT - UNKNOWN_TRADER - CL_ORD_ID_IN_USE - QTY_TOO_SMALL - QTY_TOO_LARGE - INVALID_FIELD_VALUE - NOT_ALLOWED_BY_TRADING_STATE - POSITION_LIMIT - PRICE_BAND_OUT_OF_RANGE - PRICE_LIMIT - TRADER_NOT_PERMITTED - POSITION_LIMIT_NOT_SET - UNKNOWN_FIRM - POSITION_DAILY_LIMIT - FIRM_NOT_ALLOW_TRADE_PRODUCT - TAS_INVALID_DIFFERENTIAL - TAS_INVALID_TRADE_TIME - TAS_NO_UNDERLYING_MAPPING - TAS_SETTLEMENT_NOT_AVAILABLE - TAS_TRADE_AFTER_SETTLEMENT FillStatus: type: string enum: - ACTIVE - CANCELED securitySchemes: auth_api_key: in: header name: CB-ACCESS-KEY description: The key string of the API key for the request type: apiKey auth_timestamp: in: header name: CB-ACCESS-TIMESTAMP description: The timestamp of when the request is being made (in epoch seconds) type: apiKey auth_passphrase: in: header name: CB-ACCESS-PASSPHRASE description: The passphrase affiliated with the API Key type: apiKey auth_signature: in: header name: CB-ACCESS-SIGN description: >- An HMAC SHA-256 signature using the API Key secret on the string TIMESTAMP, METHOD, REQUEST_PATH, BODY type: apiKey ````