> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet Activity

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

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

```json theme={null}
{
  "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

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


## OpenAPI

````yaml GET /v2/onchain/wallets/{address}/activity
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v2/onchain/wallets/{address}/activity:
    get:
      tags:
        - Onchain
      summary: Wallet activity (onchain)
      description: Splits, merges, and neg-risk conversions for a wallet.
      operationId: onchain_wallet_activity
      parameters:
        - name: address
          in: path
          required: true
          schema:
            type: string
          description: Wallet address
        - name: limit
          in: query
          schema:
            type: integer
            default: 100
          description: Max results (max 1000)
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
          description: Skip first N results
      responses:
        '200':
          description: Activity events
        '401':
          description: Unauthorized
      security:
        - apiKey: []
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````