Trades

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

GET /v3/perps/trades/{instrument}

Trades

cURL

curl --request GET \
  --url https://api.polynode.dev/v3/perps/trades/{instrument} \
  --header 'x-api-key: <api-key>'

200

{
  "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"
}

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.

Authorizations

x-api-key · string · header · required

Path Parameters

instrument · string · required

Instrument id (e.g. 6), symbol (BTC-USD), or bare asset (btc).

Query Parameters

limit · integer

Max rows to return.

after · string

Only rows after this time (Unix seconds or ms).

before · string

Only rows before this time (Unix seconds or ms).

side · string

Filter: long | short

min_qty · number

Minimum quantity

max_qty · number

Maximum quantity

min_notional · number

Minimum notional (price x qty), USD

Response

200 - application/json

Success