> ## 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.

# List your Watchlists

> Your watchlists, with your usage and caps. Free.

`GET /v1/wallet/watchlist` · **Free**

Your watchlists, by id, with their version, wallet count and dates. `meta.usage` gives the wallets and watchlists you use and your caps. Free.

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

```json Response theme={null}
{
  "data": [
    {
      "id": "app-holders",
      "version": 4182,
      "wallets": 3,
      "createdAt": 1792540800000,
      "updatedAt": 1792541400000,
      "lastUsedAt": 1792541400000
    }
  ],
  "meta": {
    "hasMore": false,
    "usage": {
      "wallets": 3,
      "maxWallets": 1000,
      "watchlists": 1,
      "maxWatchlists": 1000
    }
  }
}
```


## OpenAPI

````yaml openapi.json GET /v1/wallet/watchlist
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:
    get:
      summary: List your Watchlists
      description: >-
        Your watchlists, by id, with their version, wallet count and dates.
        `meta.usage` gives the wallets and watchlists you use and your caps.
        Free.
      operationId: watchlist-list
      parameters:
        - schema:
            minimum: 1
            maximum: 1000
            default: 100
            type: integer
            x-default: 100
          in: query
          name: limit
          required: false
          description: Watchlists per page, 1 to 1000. Default 100.
          example: 100
        - schema:
            type: string
          in: query
          name: cursor
          required: false
          description: '`meta.nextCursor` of the previous page.'
      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.