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

# Trades

> Recent executions (price, quantity, side, time). Add `after`/`before` for archived history deeper than the exchange serves.

## Live filters

Narrow the live tape server-side (Polymarket offers none of this): `side` (`long` / `short`), `min_qty`, `max_qty`, and `min_notional` — e.g. only trades over \$25k. Unknown values return a `400`.

## Historical windows

Add `after` and/or `before` (Unix seconds or milliseconds) to query historical trades. History covers every execution from July 9, 2026 onward and keeps growing. The same `side`, `min_notional`, and `min_qty` filters apply to the archive too — so "all BTC taker-buys over \$50k last week, by time" is one call.

Windowed responses add a `more` flag for pagination.

| Parameter | Description                        |
| --------- | ---------------------------------- |
| `limit`   | Max rows (default 100, up to 1000) |
| `after`   | Only trades after this time        |
| `before`  | Only trades before this time       |

Trades are **newest first** in both live and windowed responses.

`side` is the taker's direction: `long` means the taker bought, `short` means the taker sold. Trades carry no account attribution — for position-level tracking use [wallet portfolios](/perps/wallets/portfolio).


## OpenAPI

````yaml GET /v3/perps/trades/{instrument}
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v3/perps/trades/{instrument}:
    get:
      tags:
        - Perps
      summary: Trades
      description: >-
        Recent executions (price, quantity, side, time). Add `after`/`before`
        for archived history deeper than the exchange serves.
      operationId: perps_trades
      parameters:
        - name: instrument
          in: path
          required: true
          description: Instrument id (e.g. `6`), symbol (`BTC-USD`), or bare asset (`btc`).
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Max rows to return.
          schema:
            type: integer
        - name: after
          in: query
          required: false
          description: Only rows after this time (Unix seconds or ms).
          schema:
            type: string
        - name: before
          in: query
          required: false
          description: Only rows before this time (Unix seconds or ms).
          schema:
            type: string
        - name: side
          in: query
          required: false
          description: 'Filter: long | short'
          schema:
            type: string
        - name: min_qty
          in: query
          required: false
          description: Minimum quantity
          schema:
            type: number
        - name: max_qty
          in: query
          required: false
          description: Maximum quantity
          schema:
            type: number
        - name: min_notional
          in: query
          required: false
          description: Minimum notional (price x qty), USD
          schema:
            type: number
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                data:
                  - instrument_id: 6
                    price: '64112'
                    quantity: '0.00248'
                    side: long
                    symbol: BTC-USD
                    timestamp: 1783739244501
                    trade_id: 5350393841404889
                  - instrument_id: 6
                    price: '64112'
                    quantity: '0.0026'
                    side: long
                    symbol: BTC-USD
                    timestamp: 1783739244501
                    trade_id: 1918549746534175
                instrument_id: 6
                symbol: BTC-USD
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````