---
title: "List monitors owned by the caller's wallet"
method: GET
path: "/api/monitors"
tags: ["Monitors"]
---

# List monitors owned by the caller's wallet

`GET /api/monitors`

## Request

- Base URL: `https://twitr.sh`
- URL: `https://twitr.sh/api/monitors`
- Auth: API key in header `SIGN-IN-WITH-X`

Every real-time monitor this wallet has paid for, with prepaid-expiry state. Free — identity via SIWX (CAIP-122). Create/extend monitors via the paid endpoint POST /api/tools/x_monitor.

## Response `200`

Monitors owned by the signing wallet.

- object
  - `wallet` string, required
  - `count` integer, required
  - `monitors` object[], required
    - `monitor_id` string, required
    - `type` 'account' | 'keyword', required
    - `target` string, required: Monitored username or search query.
    - `event_types` string[]
    - `status` 'active' | 'expired' | 'deleted', required
    - `created_at` integer: Unix ms.
    - `expires_at` integer, required: Unix ms — end of the prepaid window. The monitor stops here unless extended.
    - `remaining_seconds` integer
    - `hours_purchased` integer
    - `paid_total_usd` string

## Other responses

- `402`: Identity Required — sign SIWX and retry.

---

[API](https://skmtc.dev/twitr/apis/twitr-sh.md) · [All operations](https://skmtc.dev/twitr/apis/twitr-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/twitr/apis/twitr-sh/revisions/f6390fcee344?raw)