# Binance Long/Short Ratio

> Binance Long/Short Ratio is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the current Binance long/short account ratio showing the proportion of long vs short positions and their comparative value for crypto market sentiment analysis.

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/crypto-longshort
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/binance-long-short-ratio-3e6f4677
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M38XokTJA_k42VEBMidDr

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 binance-long-short-ratio-3e6f4677
```

Example prompt: Pull the current Binance long/short account ratio for me — I want to see whether long or short positions are dominating and check if we're at an extreme sentiment level that might signal a reversal.

## When to prefer this

Prefer this endpoint when you need a quick, free-key, no-authentication snapshot of Binance long/short account sentiment without setting up a Binance API account. Ideal for agents performing contrarian sentiment analysis, monitoring crowd positioning extremes, or enriching trading signals with derivatives market data. Choose this over direct Binance API integration when you want a pay-per-call micropayment model rather than API key management.

## Known failure modes

- Binance upstream data unavailable causing stale or missing response
- API returns 402 if x402 micropayment of $0.01 USDC is not completed
- No query parameters supported so symbol-specific filtering is not possible
- Network timeout if agentdatum proxy is temporarily unreachable

## How this service works

多空持仓比 — Binance 多空持仓比：多头/空头账户占比与比值。>1 多头主导(追涨)、<1 空头主导(看跌)，情绪极端区反转信号，免费无 key。

## Output

Returns the Binance long/short account ratio data including the proportion of accounts holding long positions, the proportion holding short positions, and the ratio between them. A ratio above 1 indicates long-side dominance (bullish crowd), below 1 indicates short-side dominance (bearish crowd), with extreme readings historically associated with potential trend reversals.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "symbol": "BTCUSDT",
   "timestamp": 1786666200000,
   "long_account": "0.6506",
   "short_account": "0.3494",
   "long_short_ratio": "1.8620"
  },
  "source": "binance_ls",
  "data_type": "区块链衍生品",
  "collected_at": "2026-08-14T00:13:53Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/binance-long-short-ratio-3e6f4677/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)