# AgentFeed Long/Short Ratio — USDT Perp Crowding Gauge

> AgentFeed Long/Short Ratio — USDT Perp Crowding Gauge is a paid API for AI agents from x402.ochinimus.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-01).

Returns the current retail long/short account percentage ratio for any USDT perpetual from Bybit, with 1h and 24h historical trend data to gauge crowd positioning.

## Facts

- Endpoint: GET https://x402.ochinimus.app/api/long-short?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfeed-long-short-ratio-usdt-perp-crowding-gauge-0a8dafc7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qMJNpf9QiNEQ3U6AJTe29

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-long-short-ratio-usdt-perp-crowding-gauge-0a8dafc7
```

Example prompt: What's the current long/short ratio for SOLUSDT on Bybit perps — how crowded is the long side, and has it changed much in the last hour and 24 hours?

## When to prefer this

Use this endpoint when you need real-time retail crowd positioning for a USDT perpetual — specifically Bybit's long/short account ratio with trend comparison. Prefer this over funding rate endpoints when you want to know how lopsided retail accounts are (crowding gauge), not just the cost of carry. Best for sentiment analysis, contrarian signals, or pre-trade positioning checks on any USDT perp Bybit supports.

## Known failure modes

- Missing or invalid 'symbol' query parameter returns an error — symbol must be a valid USDT perp e.g. SOLUSDT
- Symbol not tracked by Bybit v5 public API returns no data or empty response
- Payment failure (x402 protocol) if USDC balance is insufficient — returns 402
- Bybit API downtime or rate limiting may cause stale or missing data
- Symbol format errors (e.g. SOL-USDT instead of SOLUSDT) may return null results

## How this service works

Long/short ratio for ANY USDT perp: the retail long and short account percentages from Bybit with 1h and 24h trend. Use when you need to answer: How crowded is retail on this perp? The crowding gauge.

## Output

Returns a JSON object with the symbol, timestamp, period, data source (bybit_v5_public), current long_pct and short_pct (retail account percentages), plus long_pct_1h_ago and long_pct_24h_ago for trend context. Also includes a 'paid' boolean and tool name.

## 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": {
        "ts": {
         "type": "number"
        },
        "period": {
         "type": "string"
        },
        "source": {
         "type": "string"
        },
        "symbol": {
         "type": "string"
        },
        "long_pct": {
         "type": "number"
        },
        "short_pct": {
         "type": "number"
        },
        "long_pct_1h_ago": {
         "type": "number"
        },
        "long_pct_24h_ago": {
         "type": "number"
        }
       }
      },
      "paid": {
       "type": "boolean"
      },
      "tool": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "ts": 1790352000000,
   "period": "1h",
   "source": "bybit_v5_public",
   "symbol": "SOLUSDT",
   "long_pct": 68.86,
   "short_pct": 31.14,
   "long_pct_1h_ago": 68.74,
   "long_pct_24h_ago": 70.08
  },
  "paid": true,
  "tool": "get_long_short"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfeed-long-short-ratio-usdt-perp-crowding-gauge-0a8dafc7/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)