# AgentFeed Perp Market Data

> AgentFeed Perp Market Data is a paid API for AI agents from x402.ochinimus.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Returns comprehensive perpetual futures data for a single symbol including cross-venue funding rates, open interest with change metrics, long/short ratios, and 24h liquidation data with biggest print.

## Facts

- Endpoint: GET https://x402.ochinimus.app/api/perp?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfeed-perp-market-data-6a8be100
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Je4KS-AXvUHxc3uXua3BR

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 agentfeed-perp-market-data-6a8be100
```

Example prompt: Pull up the full perp market data for SOLUSDT — I need funding rates across Bybit, OKX, and Hyperliquid, the current open interest with 1h and 24h changes, the long/short ratio, and today's liquidation breakdown including the biggest single print.

## When to prefer this

Choose this endpoint when you need a comprehensive, single-call perp market snapshot for one symbol that aggregates funding rates across Bybit, OKX, and Hyperliquid simultaneously, rather than making separate calls per venue. Ideal when an agent needs to evaluate funding rate arbitrage opportunities, assess market sentiment via long/short ratios, or understand liquidation pressure — all in one atomic request. Prefer sibling endpoints if you only need long/short ratio alone, liquidation tape alone, or a spot price without derivatives data.

## Known failure modes

- Invalid symbol returns error or empty data — use standard USDT perp format like SOLUSDT or BTCUSDT
- Tape data may be stale if tape_age_sec is high, indicating delayed liquidation feed
- Partial flag set to true when one or more venues are temporarily unavailable, resulting in incomplete funding rate coverage
- Payment failure (HTTP 402) if USDC balance is insufficient for the $0.001 per call fee
- Rate limiting or timeout if upstream venue APIs are unresponsive

## How this service works

Perp market data for one USDT perp in a single call: cross-venue funding (Bybit, OKX, Hyperliquid), open interest with 1h/24h change, long/short ratio, and 24h liquidations with long/short split and biggest print from our own tape. Use when you need to answer: What is this perp doing right now, in one call?

## Output

Returns a JSON object with the queried symbol, cross-venue funding rates (Bybit, OKX, Hyperliquid), open interest with 1h and 24h percentage changes, long/short account ratio, 24h liquidation totals split by long and short side, the largest single liquidation print from the proprietary tape, and tape age in seconds indicating data freshness. Also includes a partial flag if some venue data was unavailable.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "source": {
         "type": "string"
        },
        "symbol": {
         "type": "string"
        },
        "funding": {
         "type": "object"
        },
        "partial": {},
        "tape_age_sec": {
         "type": "number"
        },
        "open_interest": {
         "type": "object"
        },
        "liquidations_24h": {
         "type": "object"
        }
       }
      },
      "paid": {
       "type": "boolean"
      },
      "tool": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "source": "bybit+okx+hyperliquid venues, liquidations from our own tape",
   "symbol": "SOLUSDT",
   "funding": {
    "venues": {
     "okx": {
      "mark_price": 118.19,
      "funding_rate_8h": 0.0000384889726373,
      "funding_rate_raw": 0.0000384889726373,
      "next_funding_time": 1790611200000,
      "funding_interval_hours": 8
     },
     "bybit": {
      "mark_price": 118.209,
      "funding_rate_8h": 0.00008784,
      "funding_rate_raw": 0.00008784,
      "next_funding_time": 1790611200000,
      "funding_interval_hours": 8
     },
     "hyperliquid": {
      "mark_price": 118.31,
      "funding_rate_1h": 0.0000125,
      "funding_rate_raw": 0.0000125,
      "funding_rate_8h_equiv": 0.0001,
      "funding_interval_hours": 1
     }
    },
    "crowding": "longs_pay_everywhere",
    "spread_8h": 0.00006151
   },
   "partial": null,
   "long_short": {
    "source": "bybit_v5_public",
    "long_pct": 68.82,
    "short_pct": 31.18,
    "long_pct_1h_ago": 68.79,
    "long_pct_24h_ago": 67.29
   },
   "tape_age_sec": 4,
   "open_interest": {
    "okx": {
     "oi_usd": 360200963,
     "oi_base": 3046096.940000001
    },
    "bybit": {
     "oi_usd": 822567812,
     "oi_base": 6961018.5,
     "change_1h_pct": 0.36,
     "change_24h_pct": -4.74
    },
    "mark_price": 118.209
   },
   "liquidations_24h": {
    "prints": 1652,
    "venues": 3,
    "longs_usd": 10578854.85,
    "total_usd": 12370870.62,
    "shorts_usd": 1792015.77,
    "dominant_side": "longs",
    "biggest_print_usd": 603093.97
   }
  },
  "paid": true,
  "tool": "get_perp"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfeed-perp-market-data-6a8be100/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ochinimus.app](https://www.zero.xyz/host/x402.ochinimus.app/llms.txt)
