Wallet Activity

Onchain activity for a wallet: splits, merges, and multi-outcome conversions.

GET /v2/onchain/wallets/{address}/activity

Wallet activity (onchain)

cURL

curl --request GET \
  --url https://api.polynode.dev/v2/onchain/wallets/{address}/activity

Returns all onchain activity for a wallet including token splits (minting outcome tokens from collateral), merges (burning outcome tokens back to collateral), and neg-risk conversions (multi-outcome market hedging). Each event is enriched with market metadata. This data is not available through Polymarket’s API.

Request

GET /v2/onchain/wallets/{address}/activity?limit=100&offset=0

Parameter	Type	Location	Description
address	string	path	Wallet address (0x-prefixed, 40 hex chars)
limit	integer	query	Max results (default 100, max 1000)
offset	integer	query	Skip first N results for pagination

Response

{
  "wallet": "0x2f5653a3761f65c5a299f9839eadbd4d4d679ffa",
  "source": "onchain",
  "count": 1,
  "offset": 0,
  "splits": 0,
  "merges": 1,
  "conversions": 0,
  "events": [
    {
      "type": "merge",
      "id": "0x583037e505fc38851d81fc129d2eef0cb57a81270d7b5cb9f500dca9a3f898e9_0x5fd",
      "timestamp": 1774715707,
      "condition": "0xe84334d8b082ddf50a6aa659bb19283ac94edfd52a5357fb7547c0371bb18084",
      "amount": 5,
      "market": "Bitcoin Up or Down - March 28, 12:30PM-12:35PM ET",
      "slug": "btc-updown-5m-1774715400",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png"
    }
  ]
}

Field	Type	Description
splits	number	Count of split events in this page
merges	number	Count of merge events in this page
conversions	number	Count of neg-risk conversion events in this page
events[].type	string	"split", "merge", or "neg_risk_conversion"
events[].timestamp	number	Unix timestamp
events[].condition	string	Condition ID
events[].amount	number	USDC amount
events[].market	string	Market question
events[].slug	string	Market slug
events[].image	string	Market image URL
events[].neg_risk_market_id	string	Neg-risk market ID (conversions only)
events[].index_set	string	Index set (conversions only)
events[].question_count	number	Questions in the neg-risk event (conversions only)

Event Types

Split — Collateral deposited and split into outcome tokens. This is how positions are entered via the CTF contract (as opposed to buying on the orderbook).

Merge — Outcome tokens burned back into collateral. The inverse of a split. Often used when exiting a hedged position.

Neg-risk conversion — Converting between outcome tokens in a multi-outcome market (e.g., “Who will win the election?” with 5+ candidates). Used for hedging and arbitrage.

Example

curl "https://api.polynode.dev/v2/onchain/wallets/0x2f5653a3761f65c5a299f9839eadbd4d4d679ffa/activity?limit=50" \
  -H "x-api-key: YOUR_KEY"

Path Parameters

address · string · required

Wallet address

Query Parameters

limit · integer · default: 100

Max results (max 1000)

offset · integer · default: 0

Skip first N results

Response

200

Activity events