# Perpetual Basis (Mark-vs-Oracle Premium) Lookup

> Perpetual Basis (Mark-vs-Oracle Premium) Lookup is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Returns the perpetual basis in basis points for a crypto asset — the mark-minus-oracle premium on Hyperliquid — plus a naive annualized carry proxy as a leverage-cost and froth signal.

## Facts

- Endpoint: GET https://api.agentstools.dev/derivs/basis
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/perpetual-basis-mark-vs-oracle-premium-lookup-44a950b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N8uuTz3GgjNzxEWgEJOeB

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 perpetual-basis-mark-vs-oracle-premium-lookup-44a950b9
```

Example prompt: What's the current perpetual basis for BTC on Hyperliquid — how far is the mark price from the oracle in basis points, and what does that imply for annualized carry?

## When to prefer this

Choose this endpoint when you specifically need the mark-vs-oracle premium (basis) on Hyperliquid perpetuals, particularly when assessing leverage froth, cost of carry, or funding arbitrage signals. Prefer this over general funding rate endpoints when you want basis points expressed relative to the oracle price with an annualized proxy, rather than a raw funding rate.

## Known failure modes

- Missing or invalid 'symbol' query parameter — returns 400 with validation error
- Symbol not supported by Hyperliquid (e.g. obscure altcoin) — returns 404 or empty result
- Hyperliquid mark price feed temporarily unavailable — upstream timeout or 503
- Payment not made or x402 header missing — returns 402 Payment Required
- Malformed ticker that cannot be normalized server-side — returns 400

## How this service works

Perpetual basis for an asset: the mark-versus-oracle premium on venues that publish a native mark price (Hyperliquid), in basis points, with a naive annualized carry proxy. Shows how far the perpetual trades from the underlying oracle — a froth and leverage-cost signal.

## Output

Returns the mark-minus-oracle spread in basis points for the requested asset's perpetual contract, along with the raw mark price, oracle price, and a naive annualized carry proxy — useful for gauging leverage froth and cost of carry.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Base asset ticker (BTC, ETH, SOL). A quote suffix such as BTC-USD or BTC-PERP is accepted and normalized server-side."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/perpetual-basis-mark-vs-oracle-premium-lookup-44a950b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)