# x402stock HIP-3 Synthetic Perpetual Market Data

> x402stock HIP-3 Synthetic Perpetual Market Data is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns real-time synthetic perpetual (HIP-3) market data for a given asset on a specified Hyperliquid builder DEX, including mid price, mark price, funding rate, open interest, and daily volume.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/hip3/%7Bdex%7D/%7Bmarket%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-hip-3-synthetic-perpetual-market-data-8e09d6ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o0aiextNOnLCn-awFAtEa

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 x402stock-hip-3-synthetic-perpetual-market-data-8e09d6ca
```

Example prompt: What's the current mark price, funding rate, and open interest for the NVDA synthetic perpetual on the xyz Hyperliquid builder DEX right now?

## When to prefer this

Use this endpoint when you need real-time synthetic perpetual (HIP-3) market data — including funding rates, open interest, and oracle-based pricing — for stocks, ETFs, or crypto assets traded on Hyperliquid builder DEXes. Prefer it over traditional stock quote APIs when you specifically need DEX perp metrics like funding rate, mark vs oracle price divergence, or max leverage for on-chain trading decisions. Not suitable for official exchange close prices or spot prices.

## Known failure modes

- Unknown DEX or market symbol returns an error or empty result
- Market temporarily unavailable if the underlying Hyperliquid DEX is down
- Stale or delayed data if oracle feed is lagging
- Payment failure if USDC balance is insufficient or x402 payment not accepted
- Invalid path parameters result in a 400 or 404 response

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing real-time HIP-3 synthetic perpetual market data for the specified DEX and market, including: symbol, mid price, mark price, oracle price, premium, max leverage, open interest, day volume in USD and base units, previous day price, hourly funding rate, and funding APR percent — plus metadata such as venue, standard, market type, and a disclaimer clarifying this is a synthetic oracle-priced perpetual and not an official exchange close or spot price.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "dex": "xyz",
  "data": {
   "market": "NVDA",
   "symbol": "xyz:NVDA",
   "premium": 0.0000270869,
   "mid_price": 203.06,
   "mark_price": 203.05,
   "max_leverage": 20,
   "oracle_price": 203.05,
   "open_interest": 715206.396,
   "day_volume_usd": 30603861.95,
   "prev_day_price": 204.04,
   "day_volume_base": 149279.86,
   "funding_apr_percent": 5.475,
   "funding_rate_hourly": 0.00000625
  },
  "as_of": "2026-07-20T00:00:00.000Z",
  "venue": "hyperliquid",
  "source": "x402stock",
  "dex_name": "XYZ",
  "standard": "HIP-3",
  "disclaimer": "Synthetic oracle-priced perpetual on a Hyperliquid builder DEX (HIP-3): a 24/7 live proxy for the referenced underlying that carries funding and can diverge from it. NOT the official last trade, exchange close, or spot price of the underlying asset.",
  "market_type": "synthetic_perp"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-hip-3-synthetic-perpetual-market-data-8e09d6ca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)