---
title: "Address watchlists"
method: GET
path: "/v1/watchlists/addresses"
---

# Address watchlists

`GET /v1/watchlists/addresses`

## Request

- Base URL: `https://api.onvexia.com`
- URL: `https://api.onvexia.com/v1/watchlists/addresses`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `Authorization`
  - API key in header `X-PAYMENT`

Watch an on-chain address; be told when it moves value. Every response carries the coverage bound. We index LARGE transfers only, so an empty feed means we observed nothing matching, NOT that the address was inactive.

## Response `200`

OK

## Other responses

- `402`: Payment required (x402): no account needed, pay per call
- `404`: Not found, or metric registered but not yet served (the body names it)

---

[API](https://skmtc.dev/onvexia/apis/onvexia-crypto-sentiment-whale-tracking-onchain-analytics-ap.md) · [All operations](https://skmtc.dev/onvexia/apis/onvexia-crypto-sentiment-whale-tracking-onchain-analytics-ap/llms.txt) · [OpenAPI document](https://skmtc.dev/onvexia/apis/onvexia-crypto-sentiment-whale-tracking-onchain-analytics-ap/revisions/7619665fc084?raw)