# BlockRun Long/Short Ratio History

> BlockRun Long/Short Ratio History is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.0085/call, status unknown (last checked 2026-09-14).

Returns historical long/short ratio data for a given trading pair from exchange perpetual/futures markets

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/surf/exchange/long-short-ratio
- Price: $0.0085/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-long-short-ratio-history-2a9be232
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x3ixX465wfFASSQDiL3Ph

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 blockrun-long-short-ratio-history-2a9be232
```

Example prompt: Can you pull the long/short ratio history for BTCUSDT from BlockRun so I can see how trader positioning has shifted recently?

## When to prefer this

Use this endpoint when you need historical long/short ratio data for crypto perpetual or futures trading pairs to gauge crowd sentiment and positioning over time. Prefer this over generic market data APIs when specifically studying derivatives market sentiment or contrarian trading signals.

## Known failure modes

- Missing required 'pair' query parameter returns an error
- Invalid or unsupported trading pair symbol returns no data or error
- Rate limiting or payment failure results in 402 or 429 response
- Network timeout if exchange data feed is temporarily unavailable

## How this service works

Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.

## Output

A time series of long/short ratio values for the specified trading pair, showing historical positioning sentiment from exchange data — indicating whether more traders are holding long vs short positions over time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pair": {
   "type": "string",
   "description": "Required query param"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-long-short-ratio-history-2a9be232/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)