Tokenized-equity / stock perpetual-futures reference data: funding per venue + tier-1 aver

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x5c6B3a3dAe296d3cef50fef96afC73410959a6Db",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "category": "trading",
    "discoverable": true,
    "info": {
      "input": {
        "headers": {
          "PAYMENT-SIGNATURE": "x402 EIP-3009 USDC payment (Base mainnet)"
        },
        "method": "GET",
        "type": "http"
      },
      "output": {
        "example": {
          "funding": {
            "avg_tier1_pct": 0
          },
          "open_interest": {
            "top_venue_pct": 76.7,
            "total_usd": 277052042.9
          },
          "positioning": {
            "long_pct": 69.6,
            "skew": "LONG_HEAVY"
          },
          "ticker": "NVDA"
        },
        "type": "json"
      }
    },
    "name": "Octodamus Stock-Perp Facts",
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "properties": {
            "headers": {
              "properties": {
                "PAYMENT-SIGNATURE": {
                  "description": "x402 EIP-3009 USDC payment signature (Base mainnet)",
                  "type": "string"
                }
              },
              "required": [
                "PAYMENT-SIGNATURE"
              ],
              "type": "object"
            },
            "method": {
              "const": "GET",
              "type": "string"
            }
          },
          "required": [
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "action": {
              "enum": [
                "BUY",
                "SELL",
                "HOLD"
              ],
              "type": "string"
            },
            "btc_trend": {
              "enum": [
                "UP",
                "DOWN",
                "SIDEWAYS"
              ],
              "type": "string"
            },
            "confidence": {
              "maximum": 1,
              "minimum": 0,
              "type": "number"
            },
            "fear_greed": {
              "maximum": 100,
              "minimum": 0,
              "type": "number"
            },
            "polymarket_edge": {
              "type": "object"
            },
            "reasoning": {
              "type": "string"
            },
            "signal": {
              "enum": [
                "BULLISH",
                "BEARISH",
                "NEUTRAL"
              ],
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    "tags": [
      "stock perps",
      "tokenized equity",
      "funding rate",
      "open interest",
      "positioning",
      "NVDA",
      "TSLA",
      "SPY",
      "AAPL",
      "market data",
      "Base USDC"
    ]
  }
}

curl "https://api.octodamus.com/v2/stocks/perp-facts"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://api.octodamus.com/v2/stocks/perp-facts");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://api.octodamus.com/v2/stocks/perp-facts")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header