# xStock Tokenized Equity Tracker — On-Chain vs Underlying Price

> xStock Tokenized Equity Tracker — On-Chain vs Underlying Price is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.02/call, status unknown (last checked 2026-09-09).

Returns on-chain Raydium CLMM pool price, scaled xStock per-share price, live underlying equity quote, and premium/discount percent for a single tokenized equity on Solana.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/xstocks/{ticker}
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-09
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-xstock-tokenized-equity-tracker-on-chain-vs-3fb58f02
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FteuqluKyHLFB1hTo39Cb

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 agents-x402stock-xyz-xstock-tokenized-equity-tracker-on-chain-vs-3fb58f02
```

Example prompt: What's the current xStock on-chain price for AAPL on Solana, and is it trading at a premium or discount to the real Apple share price right now?

## When to prefer this

Use this endpoint when you need a real-time comparison of a Solana tokenized equity's on-chain price (via Raydium CLMM) against its underlying US stock quote, including the premium/discount spread. Prefer this over generic crypto price endpoints when the asset is specifically an xStock Token-2022 token on Solana. Also prefer when you need pool-level data (liquidity, tick, mint address) for a tokenized equity rather than just a spot price.

## Known failure modes

- Unknown ticker: endpoint may return empty or error if the symbol is not tracked — use /xstocks to list valid symbols
- Underlying price unavailable: sections.underlying = 'unavailable' when the live equity quote cannot be fetched (e.g. market closed or data outage), premium_percent and underlying_price_usd will be null
- On-chain data unavailable: pool data may be stale or null if the Solana RPC or Raydium indexer is degraded
- Payment failure: x402 USDC micropayment of $0.02 not fulfilled results in 402 response
- Invalid ticker format: passing lowercase or non-existent ticker returns an error

## How this service works

Use to track one tokenized equity by xStock symbol (AAPLx) or underlying ticker (AAPL): the on-chain Raydium CLMM pool price from the public Solana ledger, the per-share price after its Token-2022 scaled-UI multiplier, the underlying's live quote, and the premium/discount percent. List every tracked symbol via /xstocks. From x402stock, a market & economic data API (x402, USDC).

## Output

Returns a JSON object with the xStock symbol, underlying ticker, Raydium CLMM pool address, mint address, current xstock_price_usd (after Token-2022 scaled-UI multiplier), raw pool price, on-chain liquidity, current tick, live underlying_price_usd, underlying_change_percent, underlying_market_status, premium_percent (positive = xStock is expensive, negative = discount), whether the US market is open, data timestamp, and status flags for on-chain and underlying data availability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "venue",
  "protocol",
  "program",
  "note",
  "us_market_open",
  "sections",
  "item"
 ],
 "properties": {
  "item": {
   "type": "object",
   "required": [
    "symbol",
    "underlying",
    "pool",
    "mint",
    "xstock_price_usd",
    "pool_price_raw_unit",
    "multiplier",
    "liquidity",
    "tick_current",
    "underlying_price_usd",
    "underlying_change_percent",
    "underlying_market_status",
    "premium_percent"
   ],
   "properties": {
    "mint": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "pool": {
     "type": "string"
    },
    "symbol": {
     "type": "string"
    },
    "liquidity": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "multiplier": {
     "type": "number"
    },
    "underlying": {
     "type": "string"
    },
    "tick_current": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "premium_percent": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "xstock_price_usd": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "pool_price_raw_unit": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "underlying_price_usd": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "underlying_market_status": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "underlying_change_percent": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    }
   },
   "additionalProperties": false
  },
  "note": {
   "type": "string"
  },
  "as_of": {
   "type": "string"
  },
  "venue": {
   "type": "string",
   "const": "solana"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "program": {
   "type": "string"
  },
  "protocol": {
   "type": "string",
   "const": "raydium-clmm"
  },
  "sections": {
   "type": "object",
   "required": [
    "onchain",
    "underlying"
   ],
   "properties": {
    "onchain": {
     "type": "string",
     "const": "ok"
    },
    "underlying": {
     "enum": [
      "ok",
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-xstock-tokenized-equity-tracker-on-chain-vs-3fb58f02/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)