---
title: "Register a seller re-call watch"
method: POST
path: "/v1/intel/watch"
tags: ["Discovery & Ops"]
---

# Register a seller re-call watch

`POST /v1/intel/watch`

## Request

- Base URL: `https://intel.twzrd.xyz`
- URL: `https://intel.twzrd.xyz/v1/intel/watch`
- Auth: none required

Register a re-call watch on a seller wallet: TWZRD re-checks the seller when recheck_after_unix elapses and POSTs event twzrd.watch.recheck_due to your webhook when the score/decision materially changes. webhook_url optional (omit for poll-only); public HTTPS only. Max 25 active watches per payer_wallet. twzrd-watch/v1 control proof required (signature + timestamp).

## Query parameters

- `payer_wallet` string, required
- `signature` string, required
- `timestamp` string, required

## Request body

- object: Watch registration: payer + seller wallets, optional webhook, plus the twzrd-watch/v1 control proof (signature + timestamp).
  - `payer_wallet` string, required: Your agent wallet (the watcher), base58.
  - `seller_wallet` string, required: The seller/merchant wallet to watch, base58.
  - `webhook_url` string: Optional public HTTPS URL to POST when intel materially changes. Omit for poll-only.
  - `signature` string, required: base58 ed25519 signature by payer_wallet over the twzrd-watch/v1 message for action=register (see GET /v1/intel/watch self-description).
  - `timestamp` string, required: Unix seconds used in the signed message, within 300s of now.

## Response `200`

OK (JSON).

## Changes

- **2026-10-16** `0556da0b704e`: 4 breaking
  - added the new required `query` request parameter `signature`
  - added the new required `query` request parameter `timestamp`
  - added the new required request property `signature`
  - added the new required request property `timestamp`
- **2026-09-01** `e233ad9a9406`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twzrd/apis/twzrd-agent-reputation-rails/changes/v1/intel/watch/post.md)

---

[API](https://skmtc.dev/twzrd/apis/twzrd-agent-reputation-rails.md) - [All operations](https://skmtc.dev/twzrd/apis/twzrd-agent-reputation-rails/llms.txt) - [OpenAPI document](https://skmtc.dev/twzrd/apis/twzrd-agent-reputation-rails/revisions/beddd4662a76?raw)