# DEBYKO Crypto Perpetuals Snapshot

> DEBYKO Crypto Perpetuals Snapshot is a paid API for AI agents from api.debyko.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-17).

Returns latest ticker, mark price, funding rate, open interest, and order book depth data for crypto perpetual markets across 19 venues, with per-venue timestamps and staleness info, filtered via DQL.

## Facts

- Endpoint: POST https://api.debyko.com/v2/snapshots?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/debyko-crypto-perpetuals-snapshot-cac48101
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oUuWtZIO08i0FQ8kZjKcQ

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 debyko-crypto-perpetuals-snapshot-cac48101 -d '<json body>'
```

Example prompt: Pull a fresh snapshot of BTC-USDT perpetual markets across all venues — I need the ticker, funding rate, and open interest layers, filtering for BTC only, and exclude stale data.

## When to prefer this

Choose this endpoint when you need a real-time, multi-venue snapshot of crypto perpetual market data — especially funding rates, open interest, and mark prices — across 19 exchanges simultaneously, with fine-grained control over data layers and filtering via DQL. Prefer it over single-exchange APIs when cross-venue comparison or aggregation is required, and over historical endpoints when you need the current state rather than OHLCV candles.

## Known failure modes

- Invalid DQL filter syntax returns a 400 error with parse details
- No matching markets for the filter expression returns an empty result set
- Stale data returned if allow_stale is true and live feed is delayed
- Payment not attached or insufficient balance returns 402 Payment Required
- Requesting unsupported layers returns a validation error
- Venue outage causes missing data for that venue in the snapshot

## How this service works

Crypto perpetual futures funding rate, open interest, mark and index price, basis, bid and ask, order book depth and 24h volume: the latest value of every market across 19 venues (Aster Perpetuals, Avantis, Binance USD-M Futures, Bitget Perpetual Futures, Bybit Perpetuals, Coinbase Global Derivatives and 13 more). DQL filter, e.g. base in (BTC). Each value carries venue timestamp, receive time and age; stale values are withheld. No charge when nothing recorded is returned. 0.005 USDC per call.

## Output

A structured JSON response containing per-venue snapshots for each matched perpetual market, including: ticker (last price, bid, ask, volume), mark price, funding rate (current and predicted), open interest, order book depth metrics, stats, and venue-level timestamps with data age indicators. Filtered by DQL expression, with optional synthetic market data and raw underlying fields.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "kind": {
   "enum": [
    "perpetual",
    "spot",
    "all"
   ],
   "type": "string",
   "default": "perpetual",
   "description": "Market kind: perpetual (default), spot or all."
  },
  "units": {
   "enum": [
    "published",
    "base"
   ],
   "type": "string",
   "default": "published",
   "description": "published keeps each venue's own unit (default); base converts quantities to the base asset."
  },
  "where": {
   "oneOf": [
    {
     "type": "string"
    },
    {
     "type": "object"
    }
   ],
   "description": "DQL selection of the markets to read, e.g. base in (BTC, ETH) or venue = HYPERLIQUID and base = BTC."
  },
  "layers": {
   "type": "array",
   "items": {
    "enum": [
     "ticker",
     "mark",
     "funding",
     "oi",
     "book",
     "stats",
     "venue_depth"
    ],
    "type": "string"
   },
   "description": "Layers to read: ticker, mark, funding, oi, book, stats, venue_depth. Every layer when omitted."
  },
  "allow_stale": {
   "type": "boolean",
   "default": false
  },
  "include_raw": {
   "type": "boolean",
   "default": false
  },
  "number_format": {
   "enum": [
    "json",
    "string"
   ],
   "type": "string",
   "default": "json",
   "description": "json (default) returns numbers; string returns them as strings with the same digits."
  },
  "include_synthetic": {
   "type": "boolean",
   "default": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/debyko-crypto-perpetuals-snapshot-cac48101/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.debyko.com](https://www.zero.xyz/host/api.debyko.com/llms.txt)