> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kalshi Trades

> Get Kalshi Trades

Trades fetches executed Kalshi trades. The AIsa route returns the Kalshi Trade API response shape with top-level `trades` and `cursor` fields.

**Best for:** Inspecting recent trades, filtering by market ticker or timestamp, and optionally including/excluding block trades.

**Endpoint:** `GET /kalshi/trades`

## Example

```curl theme={null}
curl -X GET "https://api.aisa.one/apis/v1/kalshi/trades?limit=5&is_block_trade=false" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

## Response

The response object contains a `trades` array and, when more results are available, a `cursor` string for the next page. Trade objects include fields such as `trade_id`, `ticker`, `count_fp`, `yes_price_dollars`, `no_price_dollars`, `taker_side`, `taker_book_side`, `taker_outcome_side`, `is_block_trade`, and `created_time`.


## OpenAPI

````yaml openapi/kalshi-openapi.json GET /kalshi/trades
openapi: 3.0.3
info:
  title: AIsa API proxy
  description: APIs for prediction markets.
  version: 0.0.1
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /kalshi/trades:
    get:
      summary: Get Kalshi Trades
      description: >-
        Fetches Kalshi trades. AIsa returns the Kalshi Trade API response shape
        with top-level `trades` and `cursor` fields.
      operationId: get_kalshi-trades
      parameters:
        - name: limit
          in: query
          required: false
          description: Number of results per page. Defaults to 100. Maximum value is 1000.
          schema:
            type: integer
            format: int64
            minimum: 0
            maximum: 1000
            default: 100
            example: 100
        - name: cursor
          in: query
          required: false
          description: Pagination cursor from the previous response.
          schema:
            type: string
        - name: ticker
          in: query
          required: false
          description: Filter by Kalshi market ticker.
          schema:
            type: string
            example: KXMVESPORTSMULTIGAMEEXTENDED-S20268A776ACB3C6-43886DEE17A
        - name: min_ts
          in: query
          required: false
          description: Filter trades after this Unix timestamp.
          schema:
            type: integer
            format: int64
        - name: max_ts
          in: query
          required: false
          description: Filter trades before this Unix timestamp.
          schema:
            type: integer
            format: int64
        - name: is_block_trade
          in: query
          required: false
          description: >-
            Filter trades by whether they are block trades. Omit to return all
            trades.
          schema:
            type: boolean
            example: false
      responses:
        '200':
          description: Kalshi trades response with pagination
          content:
            application/json:
              schema:
                type: object
                properties:
                  cursor:
                    type: string
                    description: Cursor for the next page.
                  trades:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                      properties:
                        trade_id:
                          type: string
                        ticker:
                          type: string
                        count_fp:
                          type: string
                        yes_price_dollars:
                          type: string
                        no_price_dollars:
                          type: string
                        taker_side:
                          type: string
                        taker_book_side:
                          type: string
                        taker_outcome_side:
                          type: string
                        created_time:
                          type: string
                        is_block_trade:
                          type: boolean
                required:
                  - trades
        '400':
          description: Bad Request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid parameters
                  message:
                    type: string
                    example: Invalid time range or parameters
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: AISA API Key
      description: Your AIsa API key as a Bearer token.

````