# TokenGuard Open Interest API

> TokenGuard Open Interest 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).

Returns open interest data for crypto derivatives markets, enabling agents to gauge market positioning and sentiment for specific assets.

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/open_interest
- 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-open-interest-api-91dd74f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fKdd_babtuxB74qCjlOWR

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-open-interest-api-91dd74f1 -d '<json body>'
```

Example prompt: What's the current open interest for Bitcoin perpetual futures right now? I want to see the total notional value and any available breakdown by exchange.

## When to prefer this

Choose this endpoint when you need real-time or near-real-time open interest data for crypto derivatives markets as part of a trading signal, market analysis, or DeFi analytics workflow. Prefer it over generic market data APIs when you specifically need derivatives positioning data (futures/perpetuals open interest) and are already operating within the TokenGuard DeFi intelligence ecosystem. It is well-suited for AI agents making micropayment-based, on-demand data calls via x402 on Base.

## Known failure modes

- Invalid or unsupported token/pair symbol returns an error or empty result
- Exchange or market not covered by TokenGuard returns no data
- Missing required body parameters returns a 400-style error
- Network timeouts on high-latency blockchain data queries
- Payment failure via x402 micropayment protocol blocks the request
- Rate limiting if call volume exceeds allowed throughput

## How this service works

open interest data for AI agents.

## Output

Returns a JSON object containing open interest metrics for the queried cryptocurrency, including total open interest (typically in USD notional), potentially broken down by exchange or contract type, along with any available derivatives market data such as funding rates or contract counts.

## 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-open-interest-api-91dd74f1/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)