# x402stock Basis Endpoint — Perp vs Equity Basis for a Ticker

> x402stock Basis Endpoint — Perp vs Equity Basis for a Ticker is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-13).

Returns the basis (price dislocation) between a perpetual futures contract and the corresponding US-listed equity or ETF for a given ticker symbol

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/basis/%7Bticker%7D?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-basis-endpoint-perp-vs-equity-basis-for-a-ticker-ac86dc90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0jcMLATMtlM-oYPOsNFxJ

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-basis-endpoint-perp-vs-equity-basis-for-a-ticker-ac86dc90
```

Example prompt: What's the current basis between NVDA's on-chain perpetual futures on Hyperliquid and the US-listed equity price — show me the basis percent, direction, and annualized funding rate?

## When to prefer this

Use this endpoint when you need to quantify the real-time price dislocation between a Hyperliquid on-chain equity perpetual and the corresponding US-listed stock or ETF. It is uniquely suited for basis trading analysis, overnight gap prediction when US markets are closed, and funding rate cost assessment. Prefer it over generic quote endpoints when the specific question involves perp-vs-spot spread, not just price lookup.

## Known failure modes

- Ticker not found or not supported — row may be absent or excluded_reason populated
- Symbol collision between macro perp and unrelated US ticker — comparable flag set to false
- Price difference exceeds 25% threshold — treated as symbol collision, not a dislocation
- Perp or equity data source temporarily unavailable — sections.perps or sections.equities set to error state
- Invalid ticker path parameter — may return empty rows or error 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, per ticker: the perp mark price, perp oracle price, equity price, equity previous close, basis in absolute dollars and percent, basis vs previous close percent, direction (premium or discount), annualized funding APR, perp open interest, perp day volume in USD, a comparable flag indicating whether the pair is valid, an excluded reason if not, and metadata including the as-of timestamp, US market open status, venue map, and a human-readable reading of the widest dislocation.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": null,
  "rows": [
   {
    "ticker": "NVDA",
    "direction": "premium",
    "perp_mark": 182.95,
    "comparable": true,
    "perp_oracle": 182.88,
    "perp_symbol": "xyz:NVDA",
    "equity_as_of": "2026-07-30T20:00:00.000Z",
    "equity_price": 181.42,
    "basis_percent": 0.84,
    "basis_absolute": 1.53,
    "excluded_reason": null,
    "equity_prev_close": 180.11,
    "perp_open_interest": 41230.5,
    "perp_day_volume_usd": 9128441.22,
    "equity_change_percent": 0.73,
    "perp_funding_apr_percent": 11.42,
    "basis_vs_prev_close_percent": 1.58
   }
  ],
  "as_of": "2026-07-30T23:40:00.000Z",
  "count": 1,
  "method": "Legs are joined by ticker symbol. Macro perps (commodities, FX, indices) are excluded because their symbols collide with unrelated US tickers, and any remaining pair differing by more than 25% is treated as a symbol collision rather than a dislocation — see `comparable` and `excluded_reason` per row.",
  "source": "x402stock",
  "reading": "US market closed — the 24/7 perp is the live opinion of where these reopen. Widest vs last print: NVDA at 0.84%.",
  "sections": {
   "perps": "ok",
   "equities": "ok"
  },
  "venue_map": {
   "perp": "hyperliquid:xyz",
   "equity": "us_listed"
  },
  "us_market_open": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-basis-endpoint-perp-vs-equity-basis-for-a-ticker-ac86dc90/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)