> For the complete documentation index, see [llms.txt](https://docs.pearprotocol.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pearprotocol.io/api-integration/api-specification/watchlist.md).

# Watchlist

## GET /watchlist

> Get the authenticated user watchlist baskets

```json
{"openapi":"3.0.0","info":{"title":"Pear Protocol Trading API","version":"1.0.0"},"servers":[{"url":"https://hl-v2.pearprotocol.io","description":"Production (Mainnet)"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"WatchlistResponseDto":{"type":"object","properties":{"items":{"description":"List of watchlist baskets","type":"array","items":{"$ref":"#/components/schemas/WatchlistBasketDto"}}},"required":["items"]},"WatchlistBasketDto":{"type":"object","properties":{"id":{"type":"string","description":"Basket ID"},"longAssets":{"description":"Long assets in the basket","type":"array","items":{"$ref":"#/components/schemas/WatchlistAssetDto"}},"shortAssets":{"description":"Short assets in the basket","type":"array","items":{"$ref":"#/components/schemas/WatchlistAssetDto"}}},"required":["id","longAssets","shortAssets"]},"WatchlistAssetDto":{"type":"object","properties":{"asset":{"type":"string"},"weight":{"type":"number"}},"required":["asset","weight"]}}},"paths":{"/watchlist":{"get":{"operationId":"WatchlistController_getWatchlist","parameters":[],"responses":{"200":{"description":"Current list of baskets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchlistResponseDto"}}}}},"summary":"Get the authenticated user watchlist baskets","tags":["Watchlist"]}}}}
```

## POST /watchlist

> Toggle a basket (pair) in the user watchlist: if exact pair exists, remove it; otherwise, add it. Order and casing are preserved.

```json
{"openapi":"3.0.0","info":{"title":"Pear Protocol Trading API","version":"1.0.0"},"servers":[{"url":"https://hl-v2.pearprotocol.io","description":"Production (Mainnet)"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"ToggleWatchlistDto":{"type":"object","properties":{"longAssets":{"description":"Long assets for the basket (order preserved)","type":"array","items":{"$ref":"#/components/schemas/WatchlistAssetDto"}},"shortAssets":{"description":"Short assets for the basket (order preserved)","type":"array","items":{"$ref":"#/components/schemas/WatchlistAssetDto"}}},"required":["longAssets","shortAssets"]},"WatchlistAssetDto":{"type":"object","properties":{"asset":{"type":"string"},"weight":{"type":"number"}},"required":["asset","weight"]},"WatchlistResponseDto":{"type":"object","properties":{"items":{"description":"List of watchlist baskets","type":"array","items":{"$ref":"#/components/schemas/WatchlistBasketDto"}}},"required":["items"]},"WatchlistBasketDto":{"type":"object","properties":{"id":{"type":"string","description":"Basket ID"},"longAssets":{"description":"Long assets in the basket","type":"array","items":{"$ref":"#/components/schemas/WatchlistAssetDto"}},"shortAssets":{"description":"Short assets in the basket","type":"array","items":{"$ref":"#/components/schemas/WatchlistAssetDto"}}},"required":["id","longAssets","shortAssets"]}}},"paths":{"/watchlist":{"post":{"operationId":"WatchlistController_toggle","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToggleWatchlistDto"}}}},"responses":{"200":{"description":"Updated list of baskets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchlistResponseDto"}}}}},"summary":"Toggle a basket (pair) in the user watchlist: if exact pair exists, remove it; otherwise, add it. Order and casing are preserved.","tags":["Watchlist"]}}}}
```