GET /v1/settlements/token/:id

GET /v1/settlements/token/:id

Returns settlements for a specific Polymarket token ID. Useful for monitoring activity on a particular market.

Path Parameters

Parameter	Type	Description
id	string	Polymarket CLOB token identifier

Query Parameters

Parameter	Type	Default	Description
count	integer	100	Max results. Max 1000.

Request

curl -s "https://polynode.dev/v1/settlements/token/21742633...?count=10" \
  -H "x-api-key: pn_live_YOUR_KEY"

Response

{
  "token_id": "21742633...",
  "count": 10,
  "settlements": [
    {
      "tx_hash": "0x1a2b3c4d...",
      "status": "Confirmed",
      "detected_at": 1709136043000,
      "taker_wallet": "0xabcdef...",
      "taker_token": "21742633...",
      "taker_side": "BUY",
      "taker_price": 0.72,
      "taker_size": 500.00,
      "trades": [...]
    }
  ]
}

Same settlement fields as recent settlements.