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

# Clear a Watchlist

> Remove every wallet of a watchlist at once; the list stays. Free.

`POST /v1/wallet/watchlist/{id}/clear` · **Free**

Removes every wallet of a watchlist at once, whatever its size. The list and its id stay, and so do its stream subscriptions: they follow the wallets you add next. Free.

```bash cURL theme={null}
curl -X POST 'https://api.serialized.xyz/v1/wallet/watchlist/app-holders/clear' \
  -H 'Authorization: YOUR_API_KEY'
```

```json Response theme={null}
{
  "data": {
    "id": "app-holders",
    "version": 4183,
    "wallets": 0,
    "removed": 2
  }
}
```


## OpenAPI

````yaml openapi.json POST /v1/wallet/watchlist/{id}/clear
openapi: 3.1.0
info:
  title: Serialized Data API
  description: >-
    On-chain data for trading apps - tokens, candles, token filters. Built on
    our own indexers. 18 EVM chains + Solana, live.
  version: 0.1.0
servers:
  - url: https://demo.serialized.xyz
    description: 'Demo: no key needed, read endpoints, rate-limited per IP'
  - url: https://api.serialized.xyz
    description: 'Production: your API key in the Authorization header'
security:
  - apiKey: []
  - {}
paths:
  /v1/wallet/watchlist/{id}/clear:
    post:
      summary: Clear a Watchlist
      description: >-
        Removes every wallet of a watchlist at once, whatever its size. The list
        and its id stay, and so do its stream subscriptions: they follow the
        wallets you add next. Free.
      operationId: watchlist-clear
      parameters:
        - schema:
            type: string
            x-default: app-holders
          in: path
          name: id
          required: true
          description: 'The watchlist id: yours, or the `wl_…` id we generated.'
          example: app-holders
      requestBody:
        required: true
        content:
          application/json:
            schema:
              additionalProperties: false
              type: object
              properties: {}
      responses:
        '200':
          description: Standard `{ data, meta }` envelope.
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header
      description: Your raw API key (not needed on the demo server).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.