GET /v1/settlements/recent

Returns the most recent decoded settlement transactions. These include both pending (mempool) and confirmed (on-chain) settlements.

Parameters

Parameter	Type	Default	Description
`count`	integer	100	Number of settlements to return. Max 1000.

Request

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

Response

{
  "count": 5,
  "settlements": [
    {
      "tx_hash": "0x1a2b3c4d...",
      "status": "Pending",
      "detected_at": 1709136043000,
      "confirmed_at": null,
      "block_number": null,
      "taker_wallet": "0xabcdef...",
      "taker_token": "21742633...",
      "taker_side": "BUY",
      "taker_price": 0.72,
      "taker_size": 500.00,
      "trades": [
        {
          "maker_wallet": "0x999888...",
          "maker_order_id": "0xorder...",
          "matched_amount": 500.00,
          "price": 0.72
        }
      ]
    },
    {
      "tx_hash": "0x5e6f7a8b...",
      "status": "Confirmed",
      "detected_at": 1709136038000,
      "confirmed_at": 1709136040000,
      "block_number": 54321000,
      "taker_wallet": "0x112233...",
      "taker_token": "98765432...",
      "taker_side": "SELL",
      "taker_price": 0.45,
      "taker_size": 1200.00,
      "trades": [...]
    }
  ]
}

Response Fields

Field	Type	Description
`tx_hash`	string	Polygon transaction hash
`status`	string	`"Pending"` (mempool) or `"Confirmed"` (on-chain)
`detected_at`	integer	When the TX was first seen (Unix ms)
`confirmed_at`	integer \| null	When the TX was confirmed (null if pending)
`block_number`	integer \| null	Block number (null if pending)
`taker_wallet`	string	Taker’s wallet address
`taker_token`	string	Polymarket token ID being traded
`taker_side`	string	`"BUY"` or `"SELL"`
`taker_price`	number	Execution price
`taker_size`	number	Trade size in USD
`trades`	object[]	Individual maker fills within this settlement