# TokenGuard Long/Short Ratio API

> TokenGuard Long/Short Ratio API is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Retrieves the long/short ratio for crypto assets, indicating market sentiment and trader positioning on derivatives markets

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/long_short
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-long-short-ratio-api-7ab8dbdc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9UuHmilvSdBJnq2eIZnYb

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 tokenguard-long-short-ratio-api-7ab8dbdc -d '<json body>'
```

Example prompt: What's the current long/short ratio for Bitcoin on crypto derivatives markets right now — I want to know if traders are mostly positioned long or short?

## When to prefer this

Use this endpoint when you need real-time or recent derivatives market sentiment data in the form of long/short ratios — particularly for crypto assets traded on major exchanges with futures markets. Prefer this over general price APIs when trader positioning or speculative sentiment (not just price) is the key signal needed, such as for contrarian analysis, sentiment-driven trading strategies, or risk assessment of crowded trades.

## Known failure modes

- Token or trading pair not found — returns empty or error JSON
- Exchange data unavailable for the requested asset — limited coverage for smaller tokens
- Stale data if on-chain or exchange feed is delayed
- Payment failure via x402 micropayment protocol — call not executed
- Invalid request body format — 400-level error
- Rate limiting or quota exceeded for the micropayment tier

## How this service works

long short data for AI agents.

## Output

Returns a JSON object containing the long/short ratio for the requested asset, including the ratio value, percentage of long positions, percentage of short positions, and potentially timestamp or exchange-level breakdown indicating market participant sentiment in derivatives markets.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-long-short-ratio-api-7ab8dbdc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)