# Octodamus Stock Perp Facts

> Octodamus Stock Perp Facts is a paid API for AI agents from api.octodamus.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns tokenized-equity perpetual-futures reference data including funding rates by venue and tier-1 average, aggregated open interest, and long/short positioning with skew for major symbols (NVDA, TSLA, AAPL, SPY, etc.)

## Facts

- Endpoint: GET https://api.octodamus.com/v2/stocks/perp-facts
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/octodamus-stock-perp-facts-77ef3c4d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gcKev0ughhXhmICiABBtQ

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 octodamus-stock-perp-facts-77ef3c4d
```

Example prompt: Pull the latest perpetual futures reference data for NVDA — I want to see the funding rates broken down by venue and the tier-1 average, plus the aggregated open interest and whether longs or shorts are dominant right now.

## When to prefer this

Use this endpoint when you need cross-venue perpetual futures reference data (funding rates, open interest, long/short skew) specifically for tokenized equities like NVDA, TSLA, AAPL, or SPY — as opposed to native crypto perps. It is ideal for agents building derivatives dashboards, monitoring carry costs, or assessing market positioning in tokenized stock perp markets. Prefer this over generic crypto derivatives endpoints when the underlying asset is a tokenized equity.

## Known failure modes

- Missing or invalid PAYMENT-SIGNATURE header returns 402 Payment Required
- Expired or already-used payment signature returns authentication error
- Network timeout if data aggregation from multiple venues is slow
- Symbol not supported returns empty or error response
- Malformed x402 EIP-3009 signature returns 400 Bad Request

## How this service works

Tokenized-equity / stock perpetual-futures reference data: funding per venue + tier-1 average, aggregated open interest, and long/short positioning with skew. NVDA/TSLA/AAPL/SPY/etc. Not a prediction.

## Output

Returns structured data for tokenized-equity perpetual futures including per-venue funding rates, a tier-1 aggregate average, total aggregated open interest, and long/short positioning ratios with skew indicators for major symbols like NVDA, TSLA, AAPL, and SPY.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "type": "string",
     "const": "GET"
    },
    "headers": {
     "type": "object",
     "required": [
      "PAYMENT-SIGNATURE"
     ],
     "properties": {
      "PAYMENT-SIGNATURE": {
       "type": "string",
       "description": "x402 EIP-3009 USDC payment signature (Base mainnet)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "action": {
     "enum": [
      "BUY",
      "SELL",
      "HOLD"
     ],
     "type": "string"
    },
    "signal": {
     "enum": [
      "BULLISH",
      "BEARISH",
      "NEUTRAL"
     ],
     "type": "string"
    },
    "btc_trend": {
     "enum": [
      "UP",
      "DOWN",
      "SIDEWAYS"
     ],
     "type": "string"
    },
    "reasoning": {
     "type": "string"
    },
    "confidence": {
     "type": "number",
     "maximum": 1,
     "minimum": 0
    },
    "fear_greed": {
     "type": "number",
     "maximum": 100,
     "minimum": 0
    },
    "polymarket_edge": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/octodamus-stock-perp-facts-77ef3c4d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.octodamus.com](https://www.zero.xyz/host/api.octodamus.com/llms.txt)