---
title: "GET /v2/me/watchlist"
method: GET
path: "/v2/me/watchlist"
tags: ["Watchlist"]
---

# GET /v2/me/watchlist

`GET /v2/me/watchlist`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/me/watchlist`
- Auth: HTTP bearer

Lists the authenticated user's private watchlist in newest-first order. Entries contain stable identities only; mutable market metadata comes from the market APIs.

## Query parameters

- `kind` 'all' | 'token'
- `limit` integer
- `cursor` string

## Response `200`

Private watchlist page

- WatchlistPage
  - `items` WatchlistEntry[], required
    - `created_at_ms` string, required
    - `target` WatchlistTarget, required
      - `address` string, required
      - `chain_id` 'solana:mainnet-beta' | 'eip155:1' | 'eip155:56' | 'eip155:143' | 'eip155:4663' | 'eip155:5042' | 'eip155:8453' | 'eip155:42161', required
      - `kind` 'token', required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Stable machine-readable private watchlist problem
- `401`: Stable machine-readable private watchlist problem
- `404`: Stable machine-readable private watchlist problem
- `408`: Stable machine-readable private watchlist problem
- `413`: Stable machine-readable private watchlist problem
- `429`: Per-user watchlist request budget exhausted
- `503`: Stable machine-readable private watchlist problem

---

[API](https://skmtc.dev/arbital/apis/arbital-api.md) - [All operations](https://skmtc.dev/arbital/apis/arbital-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arbital/apis/arbital-api/revisions/bb0185edf43a?raw)