GET /v1/settlements/wallet/:addr

Returns settlements involving a specific wallet address. Useful for tracking whale activity or monitoring your own trades.

Path Parameters

Parameter	Type	Description
`addr`	string	Ethereum wallet address (0x…)

Query Parameters

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

Request

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

Response

{
  "wallet": "0xabcdef...",
  "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.