# 4SEC Futures Long/Short Ratio API

> 4SEC Futures Long/Short Ratio API is a paid API for AI agents from api.foursec.xyz, paid per call via x402, $0.02/call, status down (last checked 2026-09-15).

Returns real-time long/short ratio signals and top trader positioning data for a given crypto futures symbol, aggregated across multiple DEXes.

## Facts

- Endpoint: GET https://api.foursec.xyz/futures/long-short/%7Bsymbol%7D
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/4sec-futures-long-short-ratio-api-bfc7d91a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DCmP3JvPlcbBWh3OhHEx5

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 4sec-futures-long-short-ratio-api-bfc7d91a
```

Example prompt: What's the current long/short ratio signal and top trader positioning for BTCUSDT futures right now?

## When to prefer this

Choose this endpoint when you need real-time, multi-DEX aggregated long/short sentiment and top-trader positioning for crypto futures symbols. It is particularly useful for trading agents that need a directional signal before entering or exiting positions, or for monitoring smart money positioning. Prefer this over single-exchange or order-book-only data sources when you want aggregated DEX-level insights paid per-request via crypto microtransactions.

## Known failure modes

- Invalid or unsupported symbol returns an error or empty result
- Payment failure via x402 protocol if USDC balance is insufficient
- Symbol path parameter missing or malformed resulting in 404
- Rate limiting or API unavailability during high-traffic periods
- Stale data if DEX aggregation sources experience delays

## How this service works

Real-time multi-DEX aggregated crypto market data. Pay per request with USDC on Base via x402 protocol.

## Output

Returns a JSON object containing a signal string (e.g. 'long' or 'short'), the queried symbol, a timestamp, and a top_traders object with positioning breakdown data aggregated across multiple DEXes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "signal": {
   "type": "string"
  },
  "symbol": {
   "type": "string"
  },
  "timestamp": {
   "type": "string",
   "format": "date-time"
  },
  "top_traders": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/4sec-futures-long-short-ratio-api-bfc7d91a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.foursec.xyz](https://www.zero.xyz/host/api.foursec.xyz/llms.txt)