---
title: "Watch tokens and receive webhooks"
method: POST
path: "/monitor"
tags: ["Watch"]
---

# Watch tokens and receive webhooks

`POST /monitor`

## Request

- Base URL: `https://coingraph.ai/api/v1`
- URL: `https://coingraph.ai/api/v1/monitor`
- Auth: none declared

We POST to your webhook when a signal fires, a verdict changes or a new brief is written. Webhooks are signed (X-CoinGraph-Signature, HMAC-SHA256 with your secret).

## Request body

- MonitorRequest
  - `tokens` string[], required
  - `webhook_url` string, uri, required
  - `conditions` object
    - `kinds` string[]
    - `min_severity` integer
    - `verdict_changes` boolean
    - `new_briefs` boolean

## Response `201`

Monitor

- object
  - `object` 'monitor', required
  - `id` string, nullable
  - `as_of` string, date-time, required
  - `data` Monitor, required
  - `sources` Source[], required
    - `provider` string
    - `endpoint` string
    - `as_of` string, date-time, nullable

## Other responses

- `400`: Error

---

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