# QuantOracle Watch Position Monitor

> QuantOracle Watch Position Monitor is a paid API for AI agents from api.quantoracle.dev, paid per call via x402, $5/call, status unknown (last checked 2026-09-14).

Creates a real-time liquidation-risk and funding-rate monitor for a crypto derivatives position, delivering alerts via webhook or polling

## Facts

- Endpoint: POST https://api.quantoracle.dev/v1/watch/position
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quantoracle-watch-position-monitor-0262889d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BivjlQXsq9OoK_dB6O9WB

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 quantoracle-watch-position-monitor-0262889d -d '<json body>'
```

Example prompt: Set up a liquidation risk monitor on QuantOracle for my long BTC position — I entered at $67,000, my notional size is $50,000, and I have $5,000 collateral. Send critical alerts when liquidation distance drops below 7% and warn me at 15%, and post alerts to https://my-alerts.example.com/webhook.

## When to prefer this

Choose this endpoint when you need continuous, real-time liquidation risk monitoring for a specific crypto derivatives position rather than a one-time margin calculation. It is ideal when you want automated push alerts (webhook) or a persistent monitor_id you can poll, particularly for leveraged positions where liquidation distance, funding rate flips, and volatility regime shifts are all relevant. Prefer this over a simple margin calculator when the position is live and ongoing surveillance with configurable thresholds is required.

## Known failure modes

- Missing required fields (asset, direction, entry_price, position_size, collateral) returns 422 validation error
- Non-positive numeric values for price, size, or collateral return validation error
- Invalid or unreachable webhook URL may cause silent alert delivery failures
- Unsupported asset symbol returns error or undefined behavior
- warn_pct must be greater than critical_pct or thresholds will be logically inconsistent
- Payment failure or insufficient USDC balance returns 402 Payment Required
- Rate limiting may occur with rapid successive monitor creation

## How this service works

QuantOracle: /v1/watch/position

## Output

Returns a monitor_id and initial position snapshot including computed liquidation price, current distance-to-liquidation percentage, and confirmed alert threshold configuration. Subsequent alerts (warn, critical, funding flip, vol regime change) are delivered as HMAC-signed POSTs to the provided webhook URL and are always accessible via GET /v1/watch/{monitor_id} with full alert history.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "title": "WatchIn",
     "required": [
      "asset",
      "direction",
      "entry_price",
      "position_size",
      "collateral"
     ],
     "properties": {
      "asset": {
       "type": "string",
       "title": "Asset",
       "description": "Crypto asset symbol, e.g. BTC, ETH, SOL (USD pair)"
      },
      "direction": {
       "enum": [
        "long",
        "short"
       ],
       "type": "string",
       "title": "Direction",
       "description": "Position direction"
      },
      "collateral": {
       "type": "number",
       "title": "Collateral",
       "description": "Collateral backing the position, in USD",
       "exclusiveMinimum": 0
      },
      "thresholds": {
       "anyOf": [
        {
         "type": "object",
         "title": "WatchThresholds",
         "properties": {
          "warn_pct": {
           "type": "number",
           "title": "Warn Pct",
           "default": 15,
           "maximum": 90,
           "description": "Warn when liquidation distance falls below this percent",
           "exclusiveMinimum": 0
          },
          "vol_regime": {
           "type": "boolean",
           "title": "Vol Regime",
           "default": true,
           "description": "Alert when the realized-vol regime changes"
          },
          "critical_pct": {
           "type": "number",
           "title": "Critical Pct",
           "default": 7,
           "maximum": 90,
           "description": "Critical alert below this percent distance to liquidation",
           "exclusiveMinimum": 0
          },
          "funding_flip": {
           "type": "boolean",
           "title": "Funding Flip",
           "default": true,
           "description": "Alert when the funding rate flips sign"
          }
         }
        },
        {
         "type": "null"
        }
       ],
       "description": "Alert thresholds (sensible defaults if omitted)"
      },
      "entry_price": {
       "type": "number",
       "title": "Entry Price",
       "description": "Entry price in USD",
       "exclusiveMinimum": 0
      },
      "webhook_url": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quantoracle-watch-position-monitor-0262889d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.quantoracle.dev](https://www.zero.xyz/host/api.quantoracle.dev/llms.txt)