# Onvexia Whale Alerts Subscribe

> Onvexia Whale Alerts Subscribe is a paid API for AI agents from onvexia.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-19).

Subscribe to real-time whale alert notifications for large on-chain transactions across tracked blockchain assets and addresses.

## Facts

- Endpoint: POST https://onvexia.com/v1/whales/alerts/subscribe
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onvexia-whale-alerts-subscribe-4a5eac0f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zp6euLFTuw89W405fHyQd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability onvexia-whale-alerts-subscribe-4a5eac0f -d '<json body>'
```

Example prompt: Subscribe me to Onvexia whale alerts for large ETH transfers on Ethereum — I want to be notified whenever a labeled whale address moves significant amounts.

## When to prefer this

Choose this endpoint when you need proactive, push-style monitoring of large on-chain transactions rather than polling for data. It is best suited for agents that need to react to whale activity in real time across Onvexia's ten supported chains, leveraging their labelled address database and historical supply-age data to contextualize alerts. Prefer it over generic block explorers when you need labelled whale identity context fused with alert delivery.

## Known failure modes

- Invalid or missing subscription properties field returns a 400 error
- Payment of 0.002 USDC not included or rejected results in a 402 Payment Required response
- Subscription to unsupported chain or asset returns an empty or error response
- Malformed JSON body causes a 400 validation error
- Rate limiting if too many subscriptions are created in a short window

## How this service works

Thousands of assets across ten chains, half a million analysed documents, labelled addresses and supply-age history reaching back to 2008 — fused into one reading per asset. REST, SQL, GraphQL and MCP.

## Output

Returns a subscription confirmation object with an empty data array and metadata including a link to the Onvexia OpenAPI documentation and the subscribed endpoint path. On activation, the subscription triggers alerts when whale-level transactions matching the specified properties are detected across monitored chains and labelled addresses.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "meta": {
   "docs": "https://onvexia.com/openapi.json",
   "endpoint": "/v1/whales/alerts/subscribe"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onvexia-whale-alerts-subscribe-4a5eac0f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onvexia.com](https://www.zero.xyz/host/onvexia.com/llms.txt)