# Octodamus Crypto Derivatives Facts

> Octodamus Crypto Derivatives 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-13).

Returns deterministic, cross-venue crypto derivatives data including funding rates, aggregated open interest, and global long/short ratios with skew for BTC, ETH, and SOL.

## Facts

- Endpoint: GET https://api.octodamus.com/v2/derivatives/facts
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/octodamus-crypto-derivatives-facts-0cf007c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2qOKDR9-l1IUT1n6Nx0Es

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-crypto-derivatives-facts-0cf007c0
```

Example prompt: Pull the current cross-venue derivatives facts for BTC — funding rate (8h and annualized), aggregated open interest, and the global long/short skew from Octodamus.

## When to prefer this

Use this endpoint when you need raw, deterministic, cross-venue derivatives market facts (funding rates, OI, long/short) for BTC, ETH, or SOL without interpretation or prediction. Prefer this over signal endpoints when you want objective data to feed your own analysis or decision logic, or when you need per-exchange funding rate breakdowns in a single call.

## Known failure modes

- Missing or invalid PAYMENT-SIGNATURE header returns 402 Payment Required
- Expired or already-used payment signature returns 402
- Network timeout if upstream exchange data is temporarily unavailable
- Unsupported asset symbol returns 400 Bad Request
- Malformed request returns 400

## How this service works

Deterministic cross-venue crypto derivatives facts: funding rate (8h + annualized + per-exchange), aggregated open interest, and global long/short with skew. BTC/ETH/SOL. Not a prediction.

## Output

Returns current funding rate (8h + annualized + broken out per exchange), aggregated open interest across venues, and global long/short ratio with skew for BTC, ETH, or SOL. Data is deterministic and factual — no signals or predictions included.

## 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-crypto-derivatives-facts-0cf007c0/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)