# Greeneris Derivatives Snapshot

> Greeneris Derivatives Snapshot is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches a real-time snapshot of crypto derivatives market data (mark price, index, funding rate, open interest) for up to 10 specified assets from Binance

## Facts

- Endpoint: GET https://data.greeneris.io/v1/derivs/snapshot
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/greeneris-derivatives-snapshot-9a1fa4ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lhlxtK_QH8Qrr_fgwDxVa

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 greeneris-derivatives-snapshot-9a1fa4ee
```

Example prompt: What are the current funding rates, open interest, and mark vs index prices for BTC, ETH, and SOL on Binance derivatives right now?

## When to prefer this

Use this endpoint when you need real-time crypto derivatives data (funding rates, open interest, mark/index prices) for up to 10 assets in a single pay-per-call request without requiring account registration or API key setup. Prefer over exchange APIs directly when you want a unified, commoditized, pay-as-you-go interface with no subscription overhead.

## Known failure modes

- Invalid or unsupported symbol returns it in the 'failed' array
- Requesting more than 10 symbols may be rejected or truncated
- HTTP 402 returned if payment not provided — must pay 0.005 USDC via x402 protocol on Base before retrying
- Venue API downtime may cause symbol to appear in 'failed' list
- Malformed symbols parameter (e.g. extra spaces) may cause parse errors

## How this service works

Normalized crypto perpetuals snapshot across Binance, Bybit and Hyperliquid in one call: current funding rate, funding interval, annualized funding (APR %), mark price, index price, premium/basis %, open interest (base units and USD). Query: ?symbols=BTC,ETH,SOL (max 10). JSON only, ~20s cache, partial results if a venue is down.

## Output

Returns per-asset derivatives market data including mark price, index price, venue (e.g. Binance), funding rate, funding APR (annualized percentage), open interest in native units and USD, premium percentage, and funding interval in hours. Also includes lists of successfully queried venues and any failed symbols.

## 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",
     "properties": {
      "symbols": {
       "type": "string",
       "default": "BTC,ETH,SOL",
       "description": "Comma-separated base assets, e.g. BTC,ETH,SOL (max 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "mark": 100000,
    "index": 99980,
    "venue": "binance",
    "symbol": "BTC",
    "premium_pct": 0.02,
    "funding_rate": 0.0001,
    "open_interest": 80000,
    "funding_apr_pct": 10.95,
    "open_interest_usd": 8000000000,
    "funding_interval_h": 8
   }
  ],
  "failed": [],
  "symbols": [
   "BTC"
  ],
  "venues_ok": [
   "binance"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/greeneris-derivatives-snapshot-9a1fa4ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)