Skip to main content
API referenceFeeds

Feed Watch

Last updated

GET
/api/v1/feeds/watch

A personal watchlist feed built entirely from the URL: ?ids=s7,s64 selects subnets by netuid. Registry changes and incidents for the named entities only. There is no server-side subscription — anyone holding the URL sees which entities it tracks, so treat it as unlisted rather than private.

Content-negotiated: send Accept: application/rss+xml, application/atom+xml, or application/feed+json. JSON Feed is the default when nothing matches.

Query Parameters

tag?string

Return only items carrying this tag (e.g. upgrade, incident, subnet). Exact match against the item's tags array.

Lengthlength <= 100
since?string

Inclusive lower bound on item timestamps, as an ISO-8601 date (2026-06-01, a whole UTC day) or date-time with an explicit offset. Malformed values are a 400, never silently ignored. Must not be later than the range's upper bound.

until?string

Inclusive upper bound, same format as since. A bare date covers the whole named UTC day. Must not be earlier than the range's lower bound.

limit?integer

Maximum items to return (1-50). Defaults to 50.

Range1 <= value <= 50
Default50
ids?string

Comma-separated kind-prefixed entities: s<netuid> (subnet), v<hotkey> (validator), a<ss58> (account). Up to 50 per URL (WATCH_MAX_IDS in src/feeds.ts; more is a 413). Validator/account ids are accepted and counted toward that cap but produce no items yet — no change-tracking source exists for them.

Lengthlength <= 2500

Response Body

application/json

curl -X GET "https://example.com/api/v1/feeds/watch"
"string"