# StockWaves xStock Health Check

> StockWaves xStock Health Check is a paid API for AI agents from stockwaves.net, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-10, last successful call 2026-08-25).

Returns health/status data for a specific xStock synthetic asset (e.g. AAPLx, TSLAx) including its Pyth price reference, optionally identified by symbol, Solana SPL mint address, or underlying US ticker

## Facts

- Endpoint: GET https://stockwaves.net/api/xstock/health?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-08-25
- Success rate: 100% of calls made through Zero
- Rating: 4.3 / 5 from 1 review
- Activations on Zero: 1484
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stockwaves-xstock-health-check-77f6d6e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dHTsESXErwphhHHkCQeU0

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 stockwaves-xstock-health-check-77f6d6e5
```

Example prompt: Can you check if AAPLx on StockWaves is healthy and has an active Pyth price feed right now?

## When to prefer this

Use this endpoint when you need to verify that a specific xStock synthetic asset (identified by symbol like AAPLx, by Solana SPL mint address, or by underlying US ticker) is live and has a valid Pyth price reference on the StockWaves platform before executing trades or data queries against it.

## Known failure modes

- Unknown symbol returns 404 or empty result
- Invalid SPL mint address returns error
- Asset not yet listed returns not-found response
- Network or payment failure returns 402 or 5xx
- Pyth feed temporarily unavailable may cause degraded status

## How this service works

Is this tokenized stock safe to buy, and am I overpaying? Pre-trade RWA check for an agent buying an on-chain US stock. BATCH: ?watch=NVDAx,TSLAx,... — up to 25 symbols or addresses in ONE call at one price, each ok/review/avoid + what changed since your last poll. Single: ?symbol= or ?address=. Answers AUTHENTICITY (real issuer token or IMPERSONATOR) plus liquidity, depeg_bps, and basis_bps — the gap to a LIVE quote of the underlying that no oracle sees off-hours.

## Output

Returns health/status information for the specified xStock synthetic asset, including whether it is live, its Pyth oracle reference, and basic asset metadata. May include the asset's underlying US ticker, SPL mint address, and operational state.

## Example request

```json
{
 "symbol": "AAPLx"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "base": {
   "type": "string",
   "description": "Underlying US ticker for the Pyth reference (with ?mint=)"
  },
  "mint": {
   "type": "string",
   "description": "Solana SPL mint address (alternative to symbol)"
  },
  "symbol": {
   "type": "string",
   "description": "xStock symbol, e.g. AAPLx (known: AAPLx, TSLAx, NVDAx, SPYx)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "token",
  "market",
  "signals",
  "decision",
  "disclaimer",
  "underlying",
  "not_checked",
  "recommendation"
 ],
 "properties": {
  "token": {
   "type": "object",
   "required": [
    "name",
    "chain",
    "issuer",
    "symbol",
    "address",
    "trading_halted",
    "issuer_verified"
   ],
   "properties": {
    "name": {
     "type": "string"
    },
    "chain": {
     "type": "string"
    },
    "issuer": {
     "type": "string"
    },
    "symbol": {
     "type": "string"
    },
    "address": {
     "type": "string"
    },
    "trading_halted": {
     "type": "boolean"
    },
    "issuer_verified": {
     "type": "boolean"
    }
   }
  },
  "market": {
   "type": "string"
  },
  "signals": {
   "type": "object",
   "required": [
    "venue",
    "depeg_bps",
    "authenticity",
    "dex_price_usd",
    "liquidity_usd",
    "market_status",
    "onchain_supply",
    "thin_liquidity",
    "freeze_authority",
    "reference_source",
    "reference_age_sec",
    "reference_price_usd"
   ],
   "properties": {
    "venue": {
     "type": "string"
    },
    "depeg_bps": {
     "type": "number"
    },
    "authenticity": {
     "type": "object",
     "required": [
      "note",
      "issuer",
      "verified",
      "red_flags",
      "registry_status",
      "on_issuer_allowlist"
     ],
     "properties": {
      "note": {
       "type": "null"
      },
      "issuer": {
       "type": "string"
      },
      "verified": {
       "type": "boolean"
      },
      "red_flags": {
       "type": "array",
       "items": {
        "type": "unknown"
       }
      },
      "registry_status": {
       "type": "string"
      },
      "on_issuer_allowlist": {
       "type": "boolean"
      }
     }
    },
    "dex_price_usd": {
     "type": "number"
    },
    "liquidity_usd": {
     "type": "number"
    },
    "market_status": {
     "type": "string"
    },
    "onchain_supply": {
     "type": "number"
    },
    "thin_liquidity": {
     "type": "boolean"
    },
    "freeze_authority": {
     "type": "string"
    },
    "reference_source": {
     "type": "string"
    },
    "reference_age_sec": {
     "type": "number"
    },
    "reference_price_usd": {
     "type": "number"
    }
   }
  },
  "decision": {
   "type": "string"
  },
  "disclaimer": {
   "type": "string"
  },
  "underlying": {
   "type": "string"
  },
  "not_checked": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "recommendat
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stockwaves-xstock-health-check-77f6d6e5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stockwaves.net](https://www.zero.xyz/host/stockwaves.net/llms.txt)