Skip to main content
POST
/
user-management
/
v1
/
watchlists
Create a new watchlist
curl --request POST \
  --url https://api.messari.io/user-management/v1/watchlists \
  --header 'Content-Type: */*' \
  --header 'X-Messari-API-Key: <api-key>' \
  --data '
{
  "assetIds": [
    "<string>"
  ],
  "title": "<string>"
}
'
{
  "error": null,
  "data": {
    "id": "BA3FDA7B",
    "title": "DeFi Blue Chips",
    "assetIds": [
      "1e31218a-e44e-4285-820c-8282ee222035",
      "21c795f5-1bfd-40c3-858e-e9d7e820c6d0"
    ],
    "createdAt": "2026-03-27T14:11:02.490075Z",
    "updatedAt": "2026-03-27T14:11:02.490075Z"
  }
}

​
Overview

Creates a new watchlist for the authenticated user. A watchlist groups assets together for tracking and monitoring. You must provide a title and a list of asset IDs (UUIDs).
Asset IDs must be Messari UUIDs (e.g., 1e31218a-e44e-4285-820c-8282ee222035 for Bitcoin). Slugs and symbols are not accepted. Use the Asset API to look up asset UUIDs.

Authorizations

​
X-Messari-API-Key
string
header
required

Body

*/*
​
assetIds
string[]
required
​
title
string
required

Response

Default response

​
data
object
required
​
error
string